OpenClaw 多 Agent 与飞书机器人配置指南

如果文件内容与预期不符，建议手动检查并修正，重点核对 accounts 下的配置项。

三、绑定 Agent 与飞书账号

接下来需要将 Agent 实例与具体的飞书账号进行关联。这一步决定了哪个 Agent 处理哪个飞书通道的消息。

# 将 agent 绑定到指定飞书账号
openclaw agents bind --agent <agentId> --bind feishu:<accountId>

# 示例：绑定 main 和 new-agent
openclaw agents bind --agent main --bind feishu:main
openclaw agents bind --agent new-agent --bind feishu:new-agent

此时 JSON 配置文件中的 bindings 字段应显示如下映射关系：

"bindings": [
  {
    "agentId": "main",
    "match": {
      "channel": "feishu",
      "accountId": "main"
    }
  },
  {
    "agentId": "work",
    "match": {
      "channel": "feishu",
      "accountId": "new-agent"
    }
  }
]

请注意，这里的 accountId 必须与前面 channels 配置中的名称保持一致。

四、重启 Gateway

完成所有配置和绑定后，务必重启网关服务以确保更改生效：

openclaw gateway restart

常见问题排查

在实际操作中，可能会遇到以下情况，建议按顺序检查：

1. 发送消息无法回复：通常是因为长连接未建立或保持失败，请检查网络及防火墙设置。
2. 飞书配置错误：确认 APP ID 和密钥是否正确填写，且该应用在飞书后台已开启对应权限。
3. 401 Token 错误：检查 Token 是否过期或配置路径是否正确。
4. 应用复用限制：尽量使用新的飞书应用，避免一个飞书应用同时绑定多个 Agent，这可能导致消息路由混乱。