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

配置飞书通道

要让 Agent 接收消息，需要在飞书开放平台创建应用并获取凭证。

1. 登录 飞书开放平台。
2. 创建企业自建应用。
3. 在应用详情中记录 App ID 和 App Secret。
4. 配置应用权限，至少包含：
   • contact:contact.base:readonly - 读取通讯录
   • im:message:send_as_bot - 发送消息
   • im:message:receive - 接收消息
5. 发布应用。

配置 openclaw.json

在 OpenClaw 的配置文件中添加飞书 Channel 信息。注意这里需要为每个绑定的 Agent 账号配置对应的 App ID 和 Secret：

{
  "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

绑定 Agent 到飞书账号

这一步是将具体的 Agent 实例与飞书的特定机器人账号关联起来，实现路由分发。

方式一：使用命令行

直接通过 CLI 进行绑定操作：

# 绑定 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

配置用户白名单

由于 OpenClaw 当前版本在多账号配对（pairing）上存在限制，建议采用白名单机制来确保安全性并绕过配对冲突。

创建白名单文件

编辑或创建允许访问的飞书用户列表：

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

内容格式如下：

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

获取用户 OpenID

推荐使用飞书开放平台的 API 工具查询用户 ID：

1. 访问 飞书用户 API 文档。
2. 在测试页面输入 user_id 参数选择目标用户。
3. 点击'尝试'按钮，返回结果中会显示 user_id 或 open_id。

或者直接在飞书客户端中打开用户主页，点击分享复制链接，链接中通常包含用户 ID。

启用白名单后，无需执行 openclaw pairing approve，系统会自动校验请求来源，仅允许白名单内的用户使用机器人。

重启并验证

完成所有配置后，需要重启网关服务以加载新配置：

openclaw gateway restart

随后，使用不同的飞书机器人账号发送消息，观察日志或回复情况，确认消息是否正确路由到了对应的 Agent。

常见问题排查

Q: 提示 'access not configured'

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

Q: 提示权限错误

A: 需在飞书开放平台重新授权应用权限，确保包含 contact:contact.base:readonly 等必要 scope。

Q: 绑定后不生效

A: 请确保执行了 openclaw gateway restart 重启 Gateway 服务。

Q: 多账号功能限制

A: 当前版本（如 2026.3.x）主要限制是一次只能配对一个机器人。解决方案是使用 allowFrom 白名单机制，避免依赖 pairing 流程。