mergegate/docs/dtp/OPENCLAW-DOCKING-PLAN.md

OpenClaw ドッキングプラン — DTP × OpenClaw 統合設計

---

現状のドッキングポイント（5箇所）

┌──────────────────────────────────────────────────────────────────┐
│  OpenClaw (TypeScript/Node.js)                                    │
│                                                                    │
│  ┌────────────────┐  ┌────────────────┐  ┌────────────────────┐  │
│  │ exec-approvals │  │ hooks          │  │ sessions-spawn     │  │
│  │ スナップショット│  │ イベント発火   │  │ サブエージェント   │  │
│  │ 承認/拒否判定  │  │ 外部通知       │  │ 起動/停止          │  │
│  └───────┬────────┘  └───────┬────────┘  └─────────┬──────────┘  │
│          │                    │                      │             │
│  ┌───────┴────────┐  ┌───────┴────────┐  ┌─────────┴──────────┐  │
│  │ routing        │  │ memory         │  │ gateway            │  │
│  │ セッションキー │  │ sync/search    │  │ WebSocket/HTTP     │  │
│  │ エージェント   │  │ ベクトル検索   │  │ メッセージ配信     │  │
│  │ 振り分け       │  │                │  │                    │  │
│  └────────────────┘  └────────────────┘  └────────────────────┘  │
│                                                                    │
└────────────────────┬─────────────────────────────────────────────┘
                     │
                     │ Shell / HTTP
                     │
┌────────────────────┴─────────────────────────────────────────────┐
│  miyabi-cli-standalone (Rust)                                     │
│                                                                    │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐            │
│  │ gate.rs  │ │ lock.rs  │ │store.rs  │ │protocol  │ ← Phase A  │
│  │ GATE検証 │ │ ファイル │ │tasks.json│ │.rs       │            │
│  │          │ │ ロック   │ │永続化    │ │統合窓口  │            │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘            │
│                                                                    │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ 既存      │
│  │ dag.rs   │ │github.rs │ │approval  │ │openclaw  │            │
│  │ DAG 823行│ │ GH 947行 │ │.rs 231行 │ │.rs 354行 │            │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘            │
└──────────────────────────────────────────────────────────────────┘

---

ドッキングポイント詳細

1. exec-approvals ↔ gate.rs

OpenClaw 側: exec-approvals-cli.ts

• loadSnapshot() / saveSnapshot() で承認状態を永続化
• normalizeAllowlistEntry() で許可リストを管理
• resolveAgentKey() でエージェント特定

DTP 側: gate.rs

• ensure_impact(task, human_approved) で HIGH/CRITICAL を承認ゲート
• ensure_issue() で Issue 存在を検証

ドッキング方法:

• OpenClaw の exec-approvals が DTP の GATE 結果を参照
• DTP の protocol.record_impact() が承認を要求 → OpenClaw が approval snapshot に記録
• 連携: miyabi gate impact <task-id> --risk HIGH → exit code 1（承認待ち）→ OpenClaw が承認 → miyabi gate impact <task-id> --risk HIGH --approve

改善が必要:

• gate.rs に --approve フラグ対応（承認者 ID + 理由を記録）
• exit code で承認状態を返す（0=承認済み, 1=承認待ち, 2=拒否）

2. hooks ↔ protocol.rs イベント

OpenClaw 側: hooks/

• loadHookEntries() でフックを登録
• registerInternalHook() でイベント発火
• イベント: ツール実行前後、セッション開始/終了、メッセージ送受信

DTP 側: protocol.rs の各メソッド

• register_task → task_registered イベント
• assign_and_lock → lock_acquired イベント
• record_merge → task_completed イベント

ドッキング方法:

• DTP の各 protocol メソッドが完了後に hook を発火
• OpenClaw の hooks システムが DTP イベントを購読
• 連携: miyabi gate register 実行 → stdout に JSON イベント → OpenClaw hook がキャッチ

改善が必要:

• protocol.rs の各メソッドに --emit-event オプション（JSON イベントを stdout に出力）
• OpenClaw hooks に DTP イベント用のフックテンプレートを追加

3. sessions-spawn ↔ orchestration.rs

OpenClaw 側: subagent-spawn.ts

• spawnSubagentDirect() でサブエージェントを起動
• セッションキーで管理

DTP 側: orchestration.rs

• Orchestrator で並列実行
• ParallelConfig で同時実行数制御

ドッキング方法:

• OpenClaw main が DTP のタスクを受け取る
• miyabi gate dispatchable で実行可能タスクを取得
• 各タスクを spawnSubagentDirect() でサブエージェントに配布
• サブエージェントが miyabi gate assign → 作業 → miyabi gate pr → miyabi gate merge

改善が必要:

• miyabi gate dispatchable --format json でマシン可読出力
• 各タスクに assigned_agent フィールドを OpenClaw agent ID で記録

4. memory ↔ store.rs

OpenClaw 側: memory/

• syncMemoryFiles() でファイル同期
• searchVector() / searchKeyword() でメモリ検索
• indexFileEntryIfChanged() でインデックス更新

DTP 側: store.rs

• tasks.json の読み書き
• atomic rename で永続化

ドッキング方法:

• tasks.json を OpenClaw のメモリ同期対象に含める
• OpenClaw の syncMemoryFiles() が project_memory/tasks.json を各ノードに配布
• 検索: searchKeyword("task-001") で特定タスクの状態を取得

改善が必要:

• project_memory/ を OpenClaw memory sync の対象パスに追加
• tasks.json の変更を OpenClaw memory index に自動反映

5. routing ↔ dag.rs タスク振り分け

OpenClaw 側: routing/

• resolveAgentIdFromSessionKey() でエージェントを特定
• normalizeAgentId() / sanitizeAgentId()

DTP 側: dag.rs

• TaskGraph で依存関係管理
• build_levels() で並列実行グループ計算

ドッキング方法:

• DTP の DAG レベルに基づいて、OpenClaw routing がエージェントを振り分け
• Level 0 のタスク → 即座にディスパッチ
• Level 1 のタスク → Level 0 完了後にディスパッチ
• 連携: miyabi gate dag --format json → OpenClaw が読んで routing 判定

改善が必要:

• dag.rs の出力に assigned_agent を含める
• OpenClaw routing が DTP DAG レベルを考慮するアダプタ

---

ドッキング実行シーケンス

OpenClaw main (Gateway)
    │
    ▼
1. miyabi gate register --issue 45 --title "認証移行"
    │ → tasks.json に登録、GATE 0 検証
    │ → exit 0 (成功) or exit 2 (Issue なし)
    │
    ▼
2. miyabi gate dispatchable --format json
    │ → 実行可能タスク一覧を返す
    │
    ▼
3. openclaw sessions spawn --agent kade
    │ → サブエージェント（カエデ）を起動
    │
    ▼
4. miyabi gate assign task-001 --agent kade --node macbook --files "src/auth.rs"
    │ → ファイルロック獲得、implementing に遷移
    │ → exit 0 (成功) or exit 1 (ロック競合)
    │
    ▼
5. (カエデが実装)
    │
    ▼
6. miyabi gate branch task-001 feature/issue-45-auth
    │
    ▼
7. miyabi gate pr task-001 78
    │ → reviewing に遷移
    │
    ▼
8. openclaw sessions spawn --agent sakura
    │ → サクラにレビュー依頼
    │
    ▼
9. miyabi gate merge task-001
    │ → GitHub API で merge 検証
    │ → ロック解放、Done に遷移
    │ → 後続タスク解放
    │
    ▼
10. openclaw hooks emit "task_completed" --task task-001
    │ → Telegram 通知、worklog 記録

---

改善が必要な項目まとめ

#	項目	場所	難易度	Phase
1	--approve フラグ + 承認者記録	gate.rs	低	A
2	exit code 標準化 (0/1/2)	CLI	低	B
3	--emit-event JSON イベント出力	protocol.rs	中	B
4	--format json 全コマンド対応	CLI	低	B
5	assigned_agent の OpenClaw ID 記録	store.rs	低	A
6	OpenClaw hooks に DTP テンプレート	OpenClaw 側	中	C
7	memory sync に tasks.json を追加	OpenClaw 側	低	C
8	routing が DAG レベルを考慮	OpenClaw 側	中	C 以降

#1-5 は miyabi-cli-standalone 側（Phase A/B で対応可能） #6-8 は OpenClaw 側（Phase C 以降で対応）

---

リスク評価

リスク	影響	対策
OpenClaw Gateway が落ちている	DTP CLI は動くが通知が飛ばない	DTP は GitHub SSOT に依存、Gateway は補助
tasks.json の同期タイミングズレ	別ノードが古い状態を見る	memory sync の頻度を上げる or git push で共有
サブエージェントがクラッシュ	ロックが残る	TTL + stale 検出で自動解放
exec-approvals と gate.rs の二重承認	混乱	DTP gate を authority にし、exec-approvals は参照のみ

---

This plan defines how OpenClaw docks with DTP. Implementation starts after Phase A/B are complete.