OpenClaw 多飞书机器人配置指南

二、飞书应用与 Channel 配置

1. 飞书开放平台设置

在 飞书开放平台 创建企业自建应用，获取关键凭证：

• App ID 和 App Secret
• 权限配置：必须包含以下 scope
  • contact:contact.base:readonly（读取通讯录）
  • im:message:send_as_bot（发消息）
  • im:message:receive（收消息）

发布应用后，将凭证填入 OpenClaw 的全局配置 openclaw.json 中：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "defaultAccount": "main",
      "domain": "feishu",
      "accounts": {
        "main": {"appId": "cli_xxx1", "appSecret": "secret1"},
        "dailynews": {"appId": "cli_xxx2", "appSecret": "secret2"}
      }
    }
  }
}

验证 Channel 是否识别成功：

openclaw channels list

2. 绑定 Agent 与 Channel

有两种方式建立路由关系：

方式 A：命令行绑定

# 将 main Agent 绑定到 main 飞书账号
openclaw agents bind --agent main --bind feishu:main

# 将 dailynews Agent 绑定到 dailynews 飞书账号
openclaw agents bind --agent dailynews --bind feishu:dailynews

方式 B：直接修改配置文件

在配置文件中添加 bindings 字段：

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

执行 openclaw agents bindings 可查看最终的路由规则。

三、安全白名单机制

OpenClaw 当前版本在处理多账号配对时存在限制，一次只能配对一个机器人。为了解决这个问题，推荐使用白名单机制替代传统的 pairing 流程。

1. 配置允许访问的用户

编辑或创建白名单文件：

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

内容格式如下：

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

2. 获取用户 OpenID

推荐通过飞书 API 工具获取：

1. 访问 飞书文档
2. 选择目标用户点击'尝试'，返回结果中会显示 user_id 或 open_id
3. 或者在飞书客户端打开用户主页 → 分享 → 复制链接中包含 ID

注意：启用 allowFrom 后，无需再执行 openclaw pairing approve，安全性更高且支持多 Bot 并发。

四、重启与验证

配置完成后，重启 Gateway 使变更生效：

openclaw gateway restart

随后用不同飞书账号发送消息，观察日志确认消息是否正确路由到了对应的 Agent。

五、常见问题排查

Q: 提示 'access not configured'

A: 检查 channels.feishu.accounts 中是否已配置了对应的 appId 和 appSecret。

Q: 提示权限错误

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

Q: 绑定后不生效

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

Q: 多账号功能限制

A: 当前版本主要限制在于 pairing 机制，建议始终使用 allowFrom 白名单方案绕过此限制。