BETA 插件工作流
共享 onemind 插件在所有支持的宿主中以 BETA 为主。除状态、同步和已批准记忆外，技能还覆盖项目、Matrix 文件与替换审批、项目技能、建议、分析、服务端 Mind Check、指令文件备份与 Mind 同步还原点、集成生命周期、后台服务控制和签名更新指导。Alpha 仅作为旧版保留；插件或 CLI 更新不会替换 Alpha 应用。
OpenClaw、Pi 和 Hermes 在原有 onemind_status、onemind_sync、onemind_memory 外提供 onemind_read 和 onemind_action。选择 operation，将各参数分别放入 arguments，并用 workingDirectory 指定确切项目的绝对目录。读写分离不代表获得授权：操作必须符合用户的明确请求。其他宿主通过共享技能使用其支持的 MCP 或终端工具。手动准备和仅 Matrix 分配的能力限制仍然有效。
files.check 可能请求批准，mind-check 会上传选定证据；两者都不是被动读取。只能恢复已检查且明确选定的备份。命令即使已输出进展，失败时仍保留标准错误和失败状态；超时和部分输出不能证明成功。尚无公开 CLI/MCP 操作的管理功能仍在 BETA 网页或应用中完成。
onemind 智能体
onemind 智能体是一个仅在云端运行的团队 Agent，可在所有活跃账户的 Matrix 中使用。在任意 Matrix 任务中发起对话，即可创建任务、将工作分配给 AI 工具、回应待处理的工具交互、管理 Mind 并请求同步。Agent 不会在设备上运行代码、编辑文件或执行命令；所有工作均由已分配的工具完成。
Agent 提供覆盖任务、Project、记忆、Mind、同步和分析的 28 个目录操作。interactions.answer 操作允许设备所有者对运行中任务的待处理工具问题或权限请求做出回应，无需停止任务；提问者也可以是任务创建者。涉及记录名称的操作受提案约束：Agent 在呈现操作确认卡前会解析精确记录。在 Matrix 编辑器中使用 /answer 可直接触达 interactions.answer。如需完整参考，请参见 onemind 智能体。
创建和更新 BETA Mind
使用 onemind minds list --json 和 onemind minds show MIND_ID --json 查看独立 Mind。创建命令为 onemind minds create --id ID --name NAME --key KEY --purpose TEXT --file PATH --idempotency-key KEY [--project PROJECT_ID] --json。管理员创建的内容立即生效；省略项目则保持未分配状态。
更新命令为 onemind minds update MIND_ID --file PATH --title TEXT --expected-version N --expected-source-hash HASH --json，版本和哈希必须保留自读取结果的 mind.headVersion.version 与 mind.headVersion.sourceHash。可选 --details 和 --file-name 指定提案说明和候选文件名。更新要求 Mind 已关联项目，提交 Safe Check 和审批，不会发布。结果不明确时复用创建幂等键及完全相同的更新请求；发现基线冲突须停止并解决。内容文件须为 UTF-8；创建 README 上限为 8,000 个字符，更新上限为 512 KiB。
插件提供 minds.list、minds.show、minds.create、minds.update。对应 MCP 工具为 one_mind_list_minds、one_mind_get_mind、one_mind_create_mind、one_mind_update_mind，分别需要 onemind.minds.read 和 onemind.minds.write 授权。现有安装需要匹配的服务端、CLI、插件发布并重新连接，才能使用新增能力。
BETA 0.4.15 的十五工具 MCP 源码清单包含这四个 Mind 工具。已有连接需要重新同意 onemind.minds.read／onemind.minds.write 权限。若宿主未刷新工具列表或提示缺少权限，请重新连接；版本已发布不能证明当前会话状态。
MCP 工具与权限
onemind MCP 服务器提供工具，让已连接的 AI 工具读取状态与记忆、请求同步、管理 Project 以及检查 project 文件分配。每个工具需要一个授权权限，只授予工作流所需的权限即可。授权步骤请参见登录与账户 > 为 CLI 或 AI 工具授权。
| 工具 | 功能 | 所需权限 |
|---|---|---|
| 获取同步状态 | 读取当前设备同步与服务状态 | 读取设备和 AI 工具同步状态 |
| 获取记忆 | 读取已批准的共享团队记忆 | 读取 Matrix 已批准的 AI 记忆 |
| 请求同步 | 请求已连接设备进行同步 | 请求已连接设备进行同步 |
| 列出 Project / 获取 Project | 列出或读取 Project 详细信息 | 读取 Matrix 项目和待处理编辑 |
| 创建 Project / 更新 Project | 创建 Project 或提交 Project 更新提案 | 创建项目并提交项目编辑 |
| 决定 Project 更新 | 批准或拒绝待处理的 Project 更新提案 | 批准或拒绝待处理项目编辑 |
| 列出 Mind / 获取 Mind | 列出或读取 Mind 详情与版本 | 读取 BETA Mind、已批准内容和待审更新 |
| 创建 Mind / 更新 Mind | 创建 Mind 或提交 Mind 更新提案 | 立即创建生效的 BETA Mind，并提交内容更新供审批 |
| 检查 project 文件新鲜度 | 将本地文件哈希与远程分配进行比对 | 检查已分配项目文件的时效和刷新状态 |
| 获取 project 文件刷新状态 | 读取待处理刷新请求的受治理状态 | 检查已分配项目文件的时效和刷新状态 |
| 请求 project 文件刷新 | 创建替换过期文件的设备级审批请求 | 请求批准刷新已分配的项目文件 |
以上 MCP 工具均不会直接写入本地文件。文件替换需要在目标设备上通过独立的已审批工作流执行。
OpenClaw、Pi 和 Hermes Agent 的插件操作
OpenClaw、Pi 和 Hermes Agent 通过两个插件工具分派所有 OneMind 操作：onemind_read 处理读取操作，onemind_action 处理动作操作。按名称选择 operation，将各参数分别放入 arguments，并用 workingDirectory 指定确切绝对目录。读写分离不代表获得授权：操作必须符合用户的明确请求。
插件共提供 23 个读取操作和 34 个动作操作，合计 57 个操作。
**读取操作（23 个）**涵盖：帮助与版本信息、设备状态、会话状态、团队记忆、审核队列、更新检查、更新指南、服务状态、同步分析状态、设备与团队同步状态、Project 列表与详情、文件列表、skill 状态与解析、Mind 备份列表、同步备份列表、集成列表与状态，以及 Mind 列表与详情。
**动作操作（34 个）**涵盖：同步、分析控制（开启、关闭、立即执行）、服务管理（安装、启动、停止、卸载）、Project 创建、编辑、批准与拒绝、文件检查、上传、下载与删除、skill 安装、更新与卸载、从备份恢复 Mind、同步备份恢复、上传服务端 Mind Check 证据、事件提案、提案批准与拒绝、检测所选普通 Project 目标（在 OneMind 中选择前保持未激活状态）、会话验证、集成安装、更新、修复与卸载，以及 Mind 创建与更新。
files.check 可能创建或复用服务端审批请求，mind-check 会上传选定证据；两者都不是被动读取。只能恢复已检查且明确选定的备份。尚无公开 CLI、MCP 或插件操作的管理功能仍在 BETA 网页或应用中完成。