OpenClaw 接入飞书机器人配置指南
如果你已经完成了 OpenClaw 的初始部署，WebUI 也能正常收发回复，现在想接入飞书机器人，这篇指南会带你从创建应用到配置完成，一步到位。
检查插件状态
如果你使用的是最新版本的 OpenClaw，通常已经内置了 Feishu 插件，无需单独安装。如果是旧版本或未包含该插件，可以手动执行以下命令安装：
# 示例命令，具体视版本而定
pip install openclaw-feishu-plugin
创建飞书应用
1. 创建企业自建应用
访问飞书开放平台，点击【创建企业自建应用】。如果没有飞书账号，请先注册。
填写应用名称、描述并上传图标，确认创建。
2. 获取凭证
进入【凭证与基础信息】，复制 App ID 和 App Secret 到安全的地方记录。
⚠️ 注意：
App Secret涉及安全，切勿泄露给他人。
3. 配置权限
在左侧菜单找到【权限管理】，选择【批量导入或导出】->【导入】。将所需的权限 JSON 代码复制到配置框中提交。
确认后点击右下角的申请开通按钮。
4. 添加机器人能力
点击【添加应用能力】，选择【机器人】。
配置机器人菜单状态。如果无法关闭保存，可先开启，后续再调整。
5. 事件订阅与发布
进入【事件与回调】，选择【订阅方式】为【使用长连接接收事件】，添加【消息与群组】下的【接收消息】。
最后点击【创建版本】，输入版本号与说明，保存并发布。
命令行集成
完成应用创建后，可以在终端运行以下命令添加飞书渠道：
openclaw channels add
按提示操作，当询问是否配置聊天频道时选择 yes。
使用方向键选中飞书频道，回车确认。
关于插件安装，有三个选项：
- Download from npm
- Use local plugin path
- Skip for now
如果你的版本较新（如 3.12+），建议直接使用本地插件路径。
依次输入 App Secret 和 App ID。
关键点： 务必选择 websocket 模式。
接着选择域名。国内版飞书选 .cn，国际版（Lark）选 .com。
回复范围设置：
- 仅在特定群组中回复
- 公开 - 在所有群组中回复（需要提及）
- 禁用 - 不在群组中回复
根据实际需求选择，若不想在群组自动回复，可选'禁用'。
配置完成后，系统会询问是否继续添加其他频道，无则选择完成。
后续配置项如下：
feishu account name：自定义名称，随意填写。Bind configured channel accounts to agents now?：选择Yes，将渠道绑定到代理。Route feishu account 'default' to agent：选择Yes，路由飞书账户到代理。
配置结束，可使用以下命令管理网关：
openclaw gateway status # 查看状态
openclaw gateway restart # 重启生效
openclaw logs --follow # 实时日志
测试验证
打开飞书客户端或网页版，进入创建的机器人对话窗口。
输入 /start，会出现配对码。
在终端输入该配对码并回车。
回到飞书机器人窗口发送消息，即可收到 OpenClaw 的回应。
