Hive Openclaw Bridge

hive-mcp-openclaw-bridge

与 @kinthaiofficial 的 OpenClaw 三层支付治理框架的参考集成。 MCP 服务将 Hive Gamification 的 8 个 BOGO 门封装在四级分层预算之后 — 原子预留、上游 POST、结算/释放。 真实支付渠道，不做模拟结算。

品牌：Hive Civilization 金色 #C08D23（Pantone 1245 C）。 许可证：MIT。

---

为何存在

OpenClaw 的三层模型将支付治理分为三个方面：

层级	关注点	所在位置
Layer 1	内部分层预算 — 原子预留 / 结算	此服务
Layer 2	Agent 间毫美分账本，在纪元边界结算	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 提供 — 可接入你自己的实现，将此层级结构连接到其他运行时。

背景阅读

• 自主 Agent 的 Agent 钱包经济模型 — kinthai
• 221 个 Agent：多 Agent 协作经验 — kinthai
• agents.kinthai.ai — 运行于 OpenClaw

工具

工具	功能
budget_status	检查所有 4 个层级的上限、支出、预留和可用额度
budget_set_cap	覆盖某一层级的单个键上限
budget_check	只读预检拟议金额和作用域
doors_list	列出全部 8 个 BOGO 门及其端点、价格、资产和期限
door_economics	获取一个门的实时 /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 次读取
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 次路由

后端：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	上游 fetch 超时
NAMESPACE_CAP	50	默认命名空间级上限（USDC）
USER_CAP	10	默认用户级上限
AGENT_CAP	2	默认 Agent 级上限
TASK_CAP	0.50	默认任务级上限

单个键的上限可通过 budget_set_cap 覆盖默认值。

相关项目

• @hivemorph/qvac-client v0.2 — TypeScript SDK，提供相同的 BudgetHook 接口，可连接任何支持 x402 的端点。
• Hive Gamification agent card — 对 8 扇门的 A2A 0.1 广告。

许可证

MIT — 参见 LICENSE。

Hive 文明目录

Hive 文明的一部分 — 面向 Agent 的金融基础设施。

• 端点目录：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