BETA 插件工作流
共享 onemind 插件在所有支援的宿主中以 BETA 為主。除狀態、同步和已批准記憶外，技能還涵蓋 Project、Matrix 檔案與替換審批、Project 技能、提案、分析、伺服器端 Mind Check、指令檔案備份與 Mind 同步還原點、整合生命週期、後台服務控制和簽署更新指引。Alpha 僅作為舊版保留；插件或 CLI 更新不會替換 Alpha 應用程式。
OpenClaw、Pi 和 Hermes 在原有 onemind_status、onemind_sync、onemind_memory 外提供 onemind_read 和 onemind_action。選擇 operation，將各參數分別放入 arguments，並用 workingDirectory 指定精確 Project 的絕對目錄。讀寫分離不代表獲得授權：操作必須符合用戶的明確請求。其他宿主透過共享技能使用其支援的 MCP 或終端工具。手動準備和僅 Matrix 分配的能力限制仍然有效。
files.check 可能請求批准，mind-check 會上傳選定證據；兩者都不是被動讀取。只能還原已檢查且明確選定的備份。指令即使已輸出進度，失敗時仍保留標準錯誤和失敗狀態；逾時和部分輸出不能證明成功。尚無公開 CLI/MCP 操作的管理功能仍在 BETA 網頁或應用程式中完成。
onemind 智能體
onemind 智能體是一個僅限雲端的團隊代理程式，可在所有有效帳戶的 Matrix 中使用。從任意 Matrix 任務發起對話，即可建立任務、將工作分派給 AI 工具、回應待處理的工具互動、管理 Mind，以及請求同步。此代理程式不會在裝置上執行程式碼、編輯檔案或執行指令；所有工作均在已分派的工具中完成。
代理程式提供 28 個目錄操作，涵蓋任務、Project、記憶體、Mind、同步與分析。interactions.answer 操作讓裝置擁有者無需停止正在執行的任務，即可回應其中的待處理工具問題或權限申請；任務建立者也可回應問題。指定記錄的操作受提案約束：代理程式在呈現操作確認卡以供審核前，會先解析精確記錄。在 Matrix 輸入框中輸入 /answer 可直接使用 interactions.answer。完整參考資料請參閱 onemind 智能體 in Matrix。
建立和更新 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。管理員建立的內容立即生效；省略 Project 則保持未分配狀態。
更新指令為 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 已關聯 Project，提交 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 並提交 Project 編輯 |
| 決定 Project 更新 | 批准或拒絕待處理的 Project 更新提案 | 批准或拒絕待審 Project 編輯 |
| 列出 Mind / 取得 Mind | 列出或讀取 Mind 詳情和版本 | 讀取 BETA Mind、已批准內容及待審更新 |
| 建立 Mind / 更新 Mind | 建立 Mind 或提交 Mind 更新提案 | 即時建立活躍 BETA Mind 並提交內容更新以供審核 |
| 查看 Project 檔案時效 | 比對本地檔案的雜湊值與遠端分配記錄 | 查看已指派 Project 檔案的新鮮度與刷新狀態 |
| 取得 Project 檔案重新整理狀態 | 讀取待處理重新整理請求的治理狀態 | 查看已指派 Project 檔案的新鮮度與刷新狀態 |
| 請求重新整理 Project 檔案 | 建立裝置範圍的審批請求以替換過期檔案 | 請求批准以刷新已指派的 Project 檔案 |
上述 MCP 工具均不直接寫入本地檔案。檔案替換需要在目標裝置上執行獨立的已審批工作流程。
OpenClaw、Pi 和 Hermes Agent 的插件操作
OpenClaw、Pi 和 Hermes Agent 透過兩個插件工具分派所有 OneMind 操作：onemind_read 負責讀取操作，onemind_action 負責執行操作。按名稱選擇 operation，將各參數分別放入 arguments，並以 workingDirectory 指定精確 Project 的絕對目錄。讀寫分離不代表獲得授權：操作必須符合用戶的明確請求。
插件提供 23 個讀取操作和 34 個執行操作，共 57 個操作。
**讀取操作（23 個）**涵蓋：說明與版本資訊、裝置狀態、工作階段狀態、團隊記憶、審核佇列、更新檢查、更新說明、服務狀態、同步分析狀態、裝置與團隊的同步狀態、Project 列表與詳情、檔案列表、技能狀態與解析、Mind 備份列表、同步備份列表、整合列表與狀態，以及 Mind 列表與詳情。
**執行操作（34 個）**涵蓋：同步、分析控制（開啟、關閉、立即執行）、服務管理（安裝、啟動、停止、解除安裝）、Project 建立、編輯、批准和拒絕、檔案查看、上傳、下載和刪除、技能安裝、更新和解除安裝、從備份還原 Mind、同步備份還原、上傳伺服器端 Mind Check 的選定證據、事件提案、提案批准和拒絕、偵測選定的普通 Project 目標（在 OneMind 中選取之前保持閒置）、工作階段驗證、整合安裝、更新、修復和解除安裝，以及 Mind 建立和更新。
files.check 可能會建立或複用伺服器端審批請求，mind-check 會上傳選定證據；兩者都不是被動讀取。只能還原已檢查且明確選定的備份。尚無公開 CLI、MCP 或插件操作的管理功能仍在 BETA 網頁或應用程式中完成。