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

二、配置 Channel（飞书）

2.1 飞书开放平台准备

1. 登录 飞书开放平台。
2. 创建企业自建应用。
3. 在应用详情中记录 App ID 和 App Secret。
4. 添加必要权限：
   • contact:contact.base:readonly（读取通讯录）
   • im:message:send_as_bot（发消息）
   • im:message:receive（收消息）
5. 发布应用。

2.2 配置 openclaw.json

在 Channels 部分配置多个飞书账号，注意区分不同机器人的凭证。

{
  "channels": {
    "feishu": {
      "enabled": true,
      "defaultAccount": "main",
      "domain": "feishu",
      "accounts": {
        "main": {"appId": "cli_第一个机器人的 appId", "appSecret": "第一个机器人的 secret"},
        "dailynews": {"appId": "cli_第二个机器人的 appId", "appSecret": "第二个机器人的 secret"},
        "dev": {"appId": "cli_第三个机器人的 appId", "appSecret": "第三个机器人的 secret"}
      }
    }
  }
}

2.3 验证 Channel 状态

openclaw channels list

输出应显示各账号已配置且启用：

Chat channels:
- Feishu main: configured, enabled
- Feishu dailynews: configured, enabled
- Feishu dev: configured, enabled

三、绑定 Agent 到 Channel

3.1 命令行绑定

通过命令将特定 Agent 绑定到指定的飞书账号。

# 语法：openclaw agents bind --agent <agentId> --bind feishu:<accountId>
# 示例：将 main 绑定到 main 飞书账号
openclaw agents bind --agent main --bind feishu:main
openclaw agents bind --agent dailynews --bind feishu:dailynews

3.2 配置文件绑定

也可以直接在配置文件中维护绑定关系，适合批量管理。

{
  "bindings": [
    {"agentId": "main", "match": {"channel": "feishu", "accountId": "main"}},
    {"agentId": "dailynews", "match": {"channel": "feishu", "accountId": "dailynews"}},
    {"agentId": "dev", "match": {"channel": "feishu", "accountId": "dev"}}
  ]
}

3.3 查看绑定结果

openclaw agents bindings

输出示例：

Routing bindings:
- dailynews <- feishu accountId=dailynews
- main <- feishu accountId=main
- dev <- feishu accountId=dev

四、配置用户白名单

4.1 白名单机制说明

当前版本下，同时配对多个机器人可能存在兼容性问题。推荐使用白名单形式限制访问用户，无需执行 pairing approve。

创建或编辑白名单文件：

vim ~/.openclaw/credentials/feishu-allowFrom.json

内容格式：

{"version": 1, "allowFrom": ["ou_用户的 open_id_1", "ou_用户的 open_id_2"]}

4.2 获取用户 OpenID

推荐通过飞书开放平台 API 工具获取：

1. 访问 https://open.feishu.cn/document/server-docs/contact-v3/user/get
2. 选择目标用户，点击'尝试'
3. 返回结果中查找 user_id 或 open_id

或者在飞书客户端：

• 打开用户主页 → 点击分享 → 复制链接，链接中包含用户 ID。

4.3 优势

• 安全性更高，仅允许特定用户使用。
• 避免 pairing 冲突，提升稳定性。

五、重启并验证

5.1 重启 Gateway

配置完成后需重启网关服务生效。

openclaw gateway restart

5.2 测试流程

用不同的飞书机器人发送消息，观察日志或控制台，确认消息是否正确路由到对应的 Agent。

六、注意事项

6.1 多账号限制

OpenClaw 当前版本（2026.3.x）飞书多账号功能仍在完善中：

• 主要限制：一次只能配对（pairing）一个机器人。
• 解决方案：使用 allowFrom 白名单机制，绕过 pairing 限制。

七、完整配置示例

整合后的 openclaw.json 参考：

{
  "agents": {
    "list": [
      {"id": "main", "default": true, "name": "小美", "workspace": "/home/username/.openclaw/workspace"},
      {"id": "dailynews", "name": "dailynews", "workspace": "/home/username/.openclaw/workspace-dailynews"}
    ]
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "defaultAccount": "main",
      "domain": "feishu",
      "accounts": {
        "main": {"appId": "cli_xxx1", "appSecret": "secret1"},
        "dailynews": {"appId": "cli_xxx2", "appSecret": "secret2"}
      }
    }
  },
  "bindings": [
    {"agentId": "main", "match": {"channel": "feishu", "accountId": "main"}},
    {"agentId": "dailynews", "match": {"channel": "feishu", "accountId": "dailynews"}}
  ]
}

八、常见问题

Q: 提示 'access not configured'

A: 检查 channels.feishu.accounts 中是否配置了对应账号的 App ID 和 Secret。

Q: 提示权限错误

A: 需要在飞书开放平台补充授权： https://open.feishu.cn/app/{appId}/auth?q=contact:contact.base:readonly

Q: 绑定后不生效

A: 执行 openclaw gateway restart 重启 Gateway 服务。