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 エージェントは、すべてのアクティブなアカウントの Matrix で利用できるクラウド専用チームエージェントです。Matrix の任意のタスクから会話を開始して、タスクの作成、AI ツールへの作業割り当て、保留中のツールインタラクションへの回答、Mind の管理、同期のリクエストを行えます。エージェントはデバイス上でコードの実行、ファイルの編集、コマンドの実行は行いません。すべての作業は割り当てられたツール内で行われます。

エージェントは、タスク、Project、メモリ、Mind、同期、分析をカバーする 28 のカタログオペレーションを提供します。interactions.answer オペレーションを使うと、デバイスオーナーは実行中のタスクを停止することなく、保留中のツールの質問または権限に応答できます。質問はタスク作成者も受け付けます。レコードを指定するオペレーションは提案に基づきます。エージェントは確認用のアクションカードを表示する前に正確なレコードを解決します。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 ソース一覧は 15 ツールで、この 4 つの Mind ツールを含みます。既存接続には onemind.minds.read / onemind.minds.write への新しい同意が必要です。ツール一覧が更新されない場合や権限不足の場合は再接続してください。リリースの公開だけでは現在のセッション状態は証明されません。

MCP ツールと権限

onemind MCP サーバーは、接続された AI ツールが状態・メモリの読み取り、同期のリクエスト、プロジェクト管理、プロジェクトファイルの割り当て確認などを行えるツールを提供します。各ツールには 1 つの同意権限が必要です。ワークフローに必要な権限のみ付与してください。認証手順は、サインインとアカウント > CLI または AI ツールを認証するを参照してください。

これらの MCP ツールはいずれもローカルファイルを直接書き込みません。ファイルの置き換えには、対象デバイスで別途承認済みワークフローが必要です。

OpenClaw、Pi、Hermes Agent のプラグインオペレーション

OpenClaw、Pi、Hermes Agent はすべての OneMind オペレーションを 2 つのプラグインツールで処理します。読み取りオペレーションには onemind_read、操作オペレーションには onemind_action を使います。operation を名前で指定し、arguments に個別の引数を渡し、workingDirectory に正確な絶対パスを設定します。読み取りと操作の分離は権限の付与ではありません。操作はユーザーの明示的な依頼に従います。

プラグインは 23 の読み取りオペレーションと 34 の操作オペレーションを提供し、合計 57 オペレーションです。

**読み取りオペレーション（23 件）**の対象: ヘルプとバージョン情報、デバイス状態、セッション状態、チームメモリ、レビューキュー、更新確認、更新手順、サービス状態、同期分析状態、デバイスおよびチームの同期状態、プロジェクト一覧と詳細、ファイル一覧、スキル状態と解決、Mind バックアップ一覧、同期バックアップ一覧、連携一覧と状態、Mind 一覧と詳細。

**操作オペレーション（34 件）**の対象: 同期、分析制御（オン・オフ・即時）、サービス管理（インストール・起動・停止・アンインストール）、プロジェクトの作成・編集・承認・却下、ファイルの確認・アップロード・ダウンロード・削除、スキルのインストール・更新・アンインストール、バックアップからの Mind 復元、同期バックアップ復元、サーバー側 Mind Check のための証拠アップロード、イベント提案、提案の承認・却下、選択した通常 Project ターゲットの検出（OneMind で選択するまで非アクティブ）、セッション検証、連携のインストール・更新・修復・アンインストール、Mind の作成と更新。

files.check はサーバー側の承認リクエストを作成または再利用する場合があり、mind-check は選択した証拠をアップロードします。どちらも受動的な読み取りではありません。確認して明示的に選択したバックアップだけを復元してください。公開 CLI、MCP、またはプラグインオペレーションのない管理機能は BETA のウェブまたはアプリで行います。