OpenClaw 多飞书机器人配置指南
档介绍如何在 OpenClaw 中配置多个飞书机器人并分别绑定到不同的 Agent。主要流程涵盖创建 Agent 及其配置文件、在飞书开放平台创建应用获取 App ID 和 Secret、配置 openclaw.json 中的 Channel 信息、使用命令或配置文件将 Agent 绑定到飞书账号、设置用户白名单以控制访问权限,最后重启 Gateway 验证路由。通过白名单机制可有效解决多账号配对限制问题。

档介绍如何在 OpenClaw 中配置多个飞书机器人并分别绑定到不同的 Agent。主要流程涵盖创建 Agent 及其配置文件、在飞书开放平台创建应用获取 App ID 和 Secret、配置 openclaw.json 中的 Channel 信息、使用命令或配置文件将 Agent 绑定到飞书账号、设置用户白名单以控制访问权限,最后重启 Gateway 验证路由。通过白名单机制可有效解决多账号配对限制问题。

本文档介绍如何在 OpenClaw 中配置多个飞书机器人,分别绑定到不同的 Agent。
# 创建新的 Agent
openclaw agents add <agent 名称>
# 示例:创建 dailynews agent
openclaw agents add dailynews
openclaw agents list
输出示例:
Agents: - main (default) Identity: 💼✨ 小美 Workspace: ~/.openclaw/workspace - dailynews Workspace: ~/.openclaw/workspace-dailynews
每个 Agent 需要有自己的 workspace 目录和相关配置文件:
| 文件 | 说明 |
|---|---|
IDENTITY.md | Agent 身份信息(名字、性格、emoji) |
SOUL.md | Agent 核心价值观和行为准则 |
USER.md | 人类用户信息 |
AGENTS.md | Agent 的行为规范 |
HEARTBEAT.md | 主动模式任务清单 |
MEMORY.md | 长期记忆 |
{"agents":{"list":[{"id":"main","default":true,"name":"小美","workspace":"/home/username/.openclaw/workspace"},{"id":"dailynews","name":"dailynews","workspace":"/home/username/.openclaw/workspace-dailynews"},{"id":"dev","name":"开发助理","workspace":"/home/username/.openclaw/workspace-dev"}]}}
cli_xxx)contact:contact.base:readonly - 读取通讯录im:message:send_as_bot - 发消息im:message:receive - 收消息{"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"}}}}
openclaw channels list
输出示例:
Chat channels: - Feishu main: configured, enabled - Feishu dailynews: configured, enabled - Feishu dev: configured, enabled
# 绑定 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
{"bindings":[{"agentId":"main","match":{"channel":"feishu","accountId":"main"}},{"agentId":"dailynews","match":{"channel":"feishu","accountId":"dailynews"}},{"agentId":"dev","match":{"channel":"feishu","accountId":"dev"}}]}
openclaw agents bindings
输出示例:
Routing bindings: - dailynews <- feishu accountId=dailynews - main <- feishu accountId=main - dev <- feishu accountId=dev
使用 openclaw pairing approve 形式配置飞书后,发现只能同时有一个正常工作,所以改用白名单形式
vim ~/.openclaw/credentials/feishu-allowFrom.json
内容:
{"version":1,"allowFrom":["ou_用户的 open_id_1","ou_用户的 open_id_2"]}
推荐使用飞书开放平台的 API 工具获取:
user_id 参数处选择用户user_id 或 open_id或者在飞书中:
allowFrom 白名单后,不需要执行 openclaw pairing approveopenclaw gateway restart
用不同的飞书机器人发送消息,检查是否路由到对应的 Agent。
allowFrom 白名单机制,避免 pairing{"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",
Q: 提示 'access not configured'
A: 确认
channels.feishu.accounts中是否配置了对应账号
Q: 提示权限错误
A: 需要在飞书开放平台授权:
https://open.feishu.cn/app/{appId}/auth?q=contact:contact.base:readonly
Q: 绑定后不生效
A: 执行
openclaw gateway restart重启 Gateway

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online