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

配置 Channel（飞书）

接下来处理飞书侧的配置。需要先在飞书开放平台创建企业自建应用，获取必要的凭证。

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

随后修改 OpenClaw 的配置文件 openclaw.json，将多个飞书账号映射到不同的 Agent 账户：

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

配置完成后，运行以下命令验证 Channel 是否生效：

openclaw channels list

绑定 Agent 到 Channel

现在需要将 Agent 与具体的飞书账号进行绑定。有两种方式可选：通过命令行或直接在配置文件中定义。

使用命令绑定

这种方式更直观，适合快速调整：

# 绑定 agent 到指定飞书账号
openclaw agents bind --agent <agent_id> --bind feishu:<account_id>
# 示例
openclaw agents bind --agent main --bind feishu:main
openclaw agents bind --agent dailynews --bind feishu:dailynews

配置文件绑定

也可以在配置文件中直接写入 bindings 规则：

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

查看绑定结果以确认路由关系：

openclaw agents bindings

配置用户白名单

在实际使用中，如果发现只能同时有一个机器人正常工作，这通常是因为配对机制的限制。建议改用白名单形式来规避此问题。

创建白名单文件：

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

内容格式如下：

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

如何获取用户的 open_id？推荐使用飞书开放平台的 API 工具查询，或者在飞书中打开用户主页点击分享复制链接，其中包含用户 ID。

启用 allowFrom 白名单后，无需再执行 openclaw pairing approve，这样既安全又能支持特定用户使用该机器人。

重启并验证

完成所有配置后，记得重启网关服务使配置生效：

openclaw gateway restart

最后，用不同的飞书机器人发送消息，检查是否成功路由到对应的 Agent。

常见问题

Q: 提示 'access not configured'

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

Q: 提示权限错误

A: 需要在飞书开放平台补充授权，确保拥有必要的消息收发权限。

Q: 绑定后不生效

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

注意事项

当前版本的多账号功能仍在完善中，主要限制在于一次只能配对一个机器人。通过上述 allowFrom 白名单机制，可以有效避免配对冲突，实现多账号并发管理。