@agentbridge/openclaw-skill

OpenClaw 插件，将你的 Agent 接入 AgentBridge，实现跨 Agent 通信、智能路由、事件规则路由和多 Agent 协作。

v1.2.0 新特性

• agentbridge_send 支持 traceId 参数，实现跨 Agent 调用链路追踪
• 收到消息时自动提取 ab-traceid，LLM 模式下注入 prompt 提示透传
• 审计日志按 traceId 查询可看到完整链路：INBOUND → ROUTE → OUTBOUND

v1.1.0 新特性

• 消息直接注入 main chat（WebSocket chat.send + v2 设备签名），用户能实时看到 Agent 处理过程
• agentbridge_send 支持 type 和 source 参数，用于事件规则路由链路
• Hop count 防循环机制（maxAutoHops），支持多 Agent 协作不死循环
• 消息缓冲 + agentbridge_poll 优先返回缓冲消息
• 配置驱动的 smart-ack 模式（可选）

安装

openclaw plugins install agentbridge-openclaw-skill

安装后重启 Gateway：

openclaw gateway --force

配置

在 ~/.openclaw/openclaw.json 的 plugins.entries 中添加：

{
  "@agentbridge/openclaw-skill": {
    "enabled": true,
    "config": {
      "consoleEndpoint": "http://localhost:18080",
      "workerEndpoint": "http://localhost:18081",
      "bridgeId": "prod-bridge",
      "agentId": "my-agent",
      "agentName": "My OpenClaw Agent",
      "apiKey": "your-api-key",
      "apiSecret": "your-api-secret",
      "delivery": "poll",
      "pollIntervalMs": 3000,
      "tags": ["openclaw"],
      "skills": [
        {"name": "web_search", "description": "搜索网页信息"}
      ],
      "autoRegister": true,
      "autoReply": true,
      "autoReplyMode": "llm",
      "gatewayToken": "your-gateway-token",
      "gatewayPort": 18789,
      "hooksToken": "your-hooks-token",
      "maxAutoHops": 2
    }
  }
}

注意：hooks.token 必须与 gateway.auth.token 不同。

工具

插件注册 3 个工具：

| 工具 | 说明 | |------|------| | agentbridge_send | 发送消息，支持智能路由和事件规则路由 | | agentbridge_poll | 接收消息（后台自动 poll + 手动调用） | | agentbridge_discover | 发现可用 Agent 及技能 |

agentbridge_send 参数

| 参数 | 必填 | 说明 | |------|------|------| | receiver | 是 | 目标：agentId / ?skill=X / ?tag=X / ?intent=X / ?rule | | message | 是 | 消息内容 | | type | 否 | CloudEvents 类型，如 alert.escalate（用于规则路由） | | source | 否 | 消息来源标识，如 alert-screener（用于规则路由） | | traceId | 否 | 调用链路追踪 ID，收到消息时自动继承，保证同一链路共享 traceId |

自动回复模式

| 模式 | 配置 | 行为 | |------|------|------| | llm | "autoReplyMode": "llm" | 通过 WebSocket 注入 main chat，LLM 处理后回复 | | ack | "autoReplyMode": "ack" | 直接发送确认回复，不走 LLM | | smart-ack | "autoReplyMode": "smart-ack" | 配置驱动的规则判定，不走 LLM |

llm 模式通过 Gateway WebSocket 协议的 chat.send 方法注入消息到 main agent 对话，使用 v2 设备签名认证，无需 dangerouslyDisableDeviceAuth。

防循环

maxAutoHops（默认 2）控制消息自动处理的最大跳数：

• 外部事件 → A（hop=0 ✅ 自动处理）
• A → B（hop=1 ✅ 自动处理）
• B → A（hop=2 ≥ 阈值 ❌ 缓冲，不自动处理）

多 Agent 链路（A→B→C）设 maxAutoHops: 3。

配置项

| 配置项 | 默认值 | 说明 | |--------|--------|------| | consoleEndpoint | http://localhost:18080 | Console 地址 | | workerEndpoint | http://localhost:18081 | Worker Gateway 地址 | | bridgeId | prod-bridge | Bridge ID | | agentId | — | Agent 唯一标识（必填） | | agentName | 自动生成 | 显示名称 | | apiKey / apiSecret | — | Console API 凭证 | | delivery | poll | 监听模式：poll / sse | | pollIntervalMs | 5000 | Poll 间隔（毫秒） | | autoReply | true | 是否自动处理收到的消息 | | autoReplyMode | ack | 自动回复模式：llm / ack / smart-ack | | maxAutoHops | 2 | 防循环最大跳数 | | maxAutoReplyDepth | 3 | 同一发送方最大回复次数 | | tags | [] | Agent 标签 | | skills | [] | 暴露的技能列表 | | gatewayToken | — | Gateway auth token | | hooksToken | — | Hooks token（需与 gateway token 不同） | | gatewayPort | 18789 | Gateway 端口 |

K8s 部署

参考 deploy/openclaw-agentbridge-configmap.yaml，通过 ConfigMap + Secret 注入配置，支持另一个产品通过 K8s API 动态创建 OpenClaw 实例并自动接入 AgentBridge。