🐾 claw-stack

最終更新：2026年3月

アーキテクチャ概要

Claw-Stack はサイドカーパターンを使って OpenClaw をラップします——アップストリームのソースに触れずに、エージェントのアクションをインターセプトし、ポリシーを適用し、メモリを管理し、コンセンサスを調整する同時展開プロセスです。

サイドカーパターン

サイドカーパターンは、サブプロセスがメインアプリケーションと並行して実行し、変更せずに拡張するデプロイメントモデルです。Claw-Stack では、サイドカーはローカルサービスとして実行され、OpenClaw エージェントが定義されたポリシーゲートで通信します——ツール呼び出し前、エージェント間のハンドオフ前、高リスクとフラグされたアクション前。

この設計により、OpenClaw のアップデートをクリーンに適用できます。カスタムパッチを保守する必要がなく、アップストリームのマージ競合のリスクもなく、特定の OpenClaw バージョンへのロックインもありません。 

┌─────────────────────────────────────────────────────────┐
│               ユーザー / オーケストレーター              │
└──────────────────────┬──────────────────────────────────┘
                       │ 命令
                       ▼
┌─────────────────────────────────────────────────────────┐
│              Claw-Stack ランタイム                       │
│  ┌──────────────┐  ┌─────────────┐  ┌───────────────┐  │
│  │ ポリシーゲート│  │ メモリバス  │  │コンセンサスハブ│  │
│  └──────┬───────┘  └──────┬──────┘  └───────┬───────┘  │
└─────────┼─────────────────┼──────────────────┼──────────┘
          │ 承認             │ コンテキスト     │ 投票
          ▼                 ▼                  ▼
┌─────────────────────────────────────────────────────────┐
│           OpenClaw（未変更のアップストリーム）            │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │ エージェント A│  │ エージェント B│  │ エージェント C│  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
└─────────────────────────────────────────────────────────┘

レイヤー

1. ポリシーゲート

すべてのエージェントからのすべてのツール呼び出しは、実行前にポリシーゲートを通過します。ゲートはエージェントの宣言されたポリシーを確認し、許可リストに対して呼び出しを検証し、アクションを許可、ブロック、または人間の承認キューにエスカレートします。

2. メモリバス

メモリバスはエージェントとストレージ層の間に位置します。エージェントがメモリを読み書きすると、バスはリクエストを適切な層にルーティングします——即時ファクト用の MEMORY.md、整理されたナレッジの構造化トピックファイル、セマンティック検索のベクターインデックス。

3. コンセンサスハブ

ポリシーで高リスクとして分類されたアクションを実行する前に、コンセンサスハブはすべてのアクティブエージェントから投票を収集します。デフォルトのしきい値は 2/3 の合意です。コンセンサスが得られない場合、アクションは直接ブロックされるのではなく、人間のオペレーターにエスカレートされます。

なぜ OpenClaw を直接変更しないのか？

OpenClaw をフォークまたはパッチすると、上流リリースのたびに増大する保守負担が生まれます。サイドカーパターンにより Claw-Stack は独立して進化できます——新しいメモリバックエンド、新しいコンセンサスアルゴリズム、新しいポリシーオペレーターを追加——エージェント実行エンジンに触れることなく。これにより、Claw-Stack は将来的に他のエージェントランタイムにも適用可能になります。

よくある質問

サイドカーはすべてのエージェントアクションにレイテンシを追加しますか？

はい、ただしオーバーヘッドは小さいです。ポリシーゲートのチェックはコンパイルされたポリシー AST に対するインプロセス検索で、最新ハードウェアでは通常 1 ms 未満です。メモリ読み取りは層によって 2〜10 ms 追加されます。コンセンサス投票は最も多くレイテンシを追加しますが、明示的にフラグされた高リスク操作にのみ適用されます。

Claw-Stack ランタイムがクラッシュするとどうなりますか？

「フェイルクローズド」モードで設定されたエージェントは、ランタイムに到達できない場合にツール呼び出しの実行を停止します——安全のための設計です。「フェイルオープン」モードのエージェントはポリシー実施なしで実行を続けます。推奨される本番設定はすべてのエージェントのフェイルクローズドです。

Claw-Stack は複数のマシンに分散して実行できますか？

現在のアーキテクチャはシングルホスト展開を対象としています。コンセンサスとメモリ層は OpenClaw インスタンスとの同一配置向けに設計されています。マルチホストサポートはロードマップにありますが、まだ実装されていません。

Authors: Qiushi Wu & Orange 🍊