Hive Openclaw Bridge

hive-mcp-openclaw-bridge

@kinthaiofficial の OpenClaw 3 層決済ガバナンスフレームワークとのリファレンス統合です。 Hive Gamification の 8 つの BOGO ドアを、4 段階の階層型予算でラップする MCP サーバーです。原子的な予約、上流への POST、精算／解放を行います。 実際の決済レールを使用します。モック精算はありません。

ブランドカラー：Hive Civilization gold #C08D23（Pantone 1245 C）。 ライセンス：MIT。

---

これが存在する理由

OpenClaw の 3 層モデルでは、決済ガバナンスを次の 3 つの関心事に分割しています。

層	関心事	場所
Layer 1	内部の階層型予算 — 原子的な予約／精算	このサーバー
Layer 2	エージェント間のミリセント台帳をエポック境界で精算	OpenClaw
Layer 3	実際の決済レールでの外部 x402 精算	Hive Gamification

このブリッジでは、Layer 1 ↔ Layer 3 の接続部分を示します。Hive のドア（computational-debt、protocol-consensus-tax、pheromone-priority、zk-compliance-shield、capability-leasing、guild-synergy、audit-trail-premium、bounty-routing）への有料呼び出しはすべて、呼び出し元のスコープパス内の各レベルに対する原子的な予約によって制御されます。

Namespace → User → Agent → Task

最も制限の厳しいレベルが適用されます。いずれかのレベルで利用可能な予算が不足している場合、上流への HTTP リクエストは実行されず、x402 精算も署名されません。

同じ BudgetHook インターフェースは、@hivemorph/qvac-client v0.2 からも公開されています。独自の実装を組み込めば、この階層を別のランタイムに接続できます。

背景資料

• 自律型エージェントのエージェントウォレット経済モデル — kinthai
• 221 エージェント：マルチエージェント連携から得られた教訓 — kinthai
• agents.kinthai.ai — OpenClaw 上で稼働中

ツール

ツール	機能
budget_status	4 つすべてのレベルについて、上限、使用額、予約額、利用可能額を確認します
budget_set_cap	1 つのレベルで、キーごとの上限を変更します
budget_check	提案された金額とスコープに対する読み取り専用の事前確認を行います
doors_list	エンドポイント、価格、アセット、期間を含む 8 つすべての BOGO ドアを一覧表示します
door_economics	1 つのドアの最新の /economics を取得します
bogo_claim	/v1/bogo/claim 経由で初回無料利用を申請します
door_subscribe	正式なゲート付き経路 — 原子的な予約 → 上流への POST → 精算／解放

ドア

ドア	エンドポイント	価格	期間
computational-debt	/v1/debt/subscribe	0.50 USDC	30d
protocol-consensus-tax	/v1/pct/subscribe	0.25 USDC	1 read
pheromone-priority	/v1/pheromone/subscribe	5.00 USDC	30d
zk-compliance-shield	/v1/compliance/subscribe	1.00 USDC	30d
capability-leasing	/v1/lease/start	0.15 USDC	1h
guild-synergy	/v1/guild_synergy/subscribe	10.00 USDC	30d
audit-trail-premium	/v1/audit_premium/subscribe	3.00 USDC	30d
bounty-routing	/v1/bounty_routing/route	0.50 USDC	1 routing

バックエンド：https://hive-gamification.onrender.com。すべてのエンドポイントは稼働中で、検証済みです。

有料呼び出しのライフサイクル

client → tools/call door_subscribe { door_id, did, scope }
       → atomicReserve(scope, price, asset)
           ├─ each level checked: namespace, user, agent, task
           ├─ headroom = cap − spent − reserved
           └─ short on any level? reject before signing
       → POST hive-gamification.onrender.com<endpoint>
       → 2xx? settle(reservationId)
         non-2xx or throw? release(reservationId)
       → return { ok, reservationId, binding_level, upstream }

クイックスタート

git clone https://github.com/srotzin/hive-mcp-openclaw-bridge
cd hive-mcp-openclaw-bridge
npm install
npm start

その後、任意の MCP クライアントから次のように実行します。

POST http://localhost:3000/mcp
{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

設定

環境変数	デフォルト	説明
PORT	3000	リッスンポート
HIVE_BASE	https://hive-gamification.onrender.com	上流のベース URL
HIVE_TIMEOUT_MS	15000	上流へのフェッチのタイムアウト
NAMESPACE_CAP	50	名前空間レベルのデフォルト上限（USDC）
USER_CAP	10	ユーザーレベルのデフォルト上限
AGENT_CAP	2	エージェントレベルのデフォルト上限
TASK_CAP	0.50	タスクレベルのデフォルト上限

キーごとの上限は、budget_set_cap でデフォルト値を上書きします。

関連情報

• @hivemorph/qvac-client v0.2 — 任意の x402 対応エンドポイントで同じ BudgetHook インターフェースを公開する TypeScript SDK です。
• Hive Gamification エージェントカード — 8 つのドアを告知する A2A 0.1 です。

ライセンス

MIT — LICENSE を参照してください。

Hive Civilization ディレクトリ

エージェントネイティブな金融インフラである Hive Civilization の一部です。

• エンドポイントディレクトリ：https://thehiveryiq.com
• ライブリーダーボード：https://hive-a2amev.onrender.com/leaderboard
• 収益ダッシュボード：https://hivemine-dashboard.onrender.com
• その他の MCP サーバー：https://github.com/srotzin?tab=repositories&q=hive-mcp

ブランドカラー：#C08D23