OpenClaw 多飞书机器人配置指南

二、对接飞书开放平台

接下来处理 Channel 侧的配置，这是多账号并行的基础。

1. 应用创建与权限

登录 飞书开放平台，创建企业自建应用，注意获取以下信息：

• App ID（如 cli_xxx）
• App Secret

权限方面必须勾选：

• contact:contact.base:readonly - 读取通讯录
• im:message:send_as_bot - 发消息
• im:message:receive - 收消息

发布应用后，才能进行下一步配置。

2. 配置 openclaw.json

在 OpenClaw 配置文件中定义多个飞书账号，分别对应不同的 App ID 和 Secret：

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

3. 验证 Channel

执行命令检查通道状态：

openclaw channels list

若看到 configured, enabled 字样，说明配置生效。

三、绑定 Agent 到 Channel

这一步决定哪个机器人接收哪类消息。支持命令行或配置文件两种方式。

1. 命令行绑定

直接通过命令建立映射关系：

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

# 示例
openclaw agents bind --agent main --bind feishu:main
openclaw agents bind --agent dailynews --bind feishu:dailynews

2. 配置文件绑定

也可以在配置文件中直接写入 bindings 数组：

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

3. 查看绑定结果

openclaw agents bindings

输出示例：

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

四、配置用户白名单

这里有个关键点：当前版本下，飞书多账号功能在完善中，一次只能配对（pairing）一个机器人。如果强行配对多个，会导致冲突。因此推荐使用白名单机制绕过 pairing 限制。

1. 创建白名单文件

编辑凭证文件，只允许特定用户使用该机器人：

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

内容格式如下：

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

2. 获取用户 OpenID

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

1. 打开 https://open.feishu.cn/document/server-docs/contact-v3/user/get
2. 选择目标用户，点击'尝试'
3. 返回结果中的 user_id 或 open_id 即为所需值

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

3. 注意事项

• 使用 allowFrom 白名单后，无需执行 openclaw pairing approve
• 白名单更安全，仅允许特定用户使用该机器人

五、重启并验证

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

openclaw gateway restart

随后用不同的飞书机器人发送消息，观察是否路由到了对应的 Agent。

六、常见问题

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 服务。

七、完整配置示例

整合上述步骤，完整的 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"}}
  ]
}

八、注意事项

• 多账号限制：OpenClaw 当前版本（2026.3.x）飞书多账号功能仍在完善中。
• 主要限制：一次只能配对（pairing）一个机器人。
• 解决思路：使用 allowFrom 白名单机制，避免依赖 pairing 功能。