本文档基于 Ubuntu 24.04 环境，记录 OpenClaw 接入飞书机器人及 Kimi 2.5 模型的完整流程。
准备工作
飞书应用配置
创建飞书机器人
访问飞书开放平台：https://open.feishu.cn/app，点击创建应用。
填写应用名称和描述后直接创建。
获取凭证信息
在'凭证与基础信息'中找到 App ID 和 App Secret，记录下来以便后续配置到 OpenClaw。
开通权限
进入【权限管理】→【开通权限】，或直接使用【批量导入/导出权限】功能，输入所需权限列表并确认新增。
至少需要开通以下权限以确保机器人正常工作。
配置事件与回调
注意：建议先完成 AppId 和 AppSecret 在 OpenClaw 的配置后再设置订阅方式，否则可能报错。
订阅方式选择【使用长连接接收事件】。
添加事件订阅，确保覆盖必要的事件类型。
配置成功后状态应显示正常。
回调配置（可选），同样选择【使用长连接接收事件】。
发布版本
配置完成后需创建版本并发布，有两种方式可选：
方式 1：创建版本
方式 2：
创建新版本并确认发布。
发布成功后状态显示为'当前修改均已发布'。
说明：
- 只有机器人状态为已发布，OpenClaw 才能识别。
- 任何修改和配置变更，都需要创建新版本进行发布。
申请 Kimi Code API Key
- 登录后购买套餐。由于 OpenClaw 消耗 Token 较大，建议根据实际用量选择合适的方案。
- 点击【控制台】→【新建 API key】。
名字随意填写。
重要提示： API Key 生成后请立即复制保存，一旦关闭页面将无法再次查看，若丢失只能重新创建。
下方的使用记录可查看最近调用情况。
OpenClaw 配置
在安装了 OpenClaw 的服务器上执行以下命令：
openclaw onboard
选择 Yes。
选择 QuickStart。
系统会提示是否使用原有配置，如需重置可选择 Reset。
选择 Moonshot AI（Kimi K2.5）。
下一步输入 Kimi 控制台申请的 API Key，其他配置按默认或之前习惯即可。
飞书插件安装时可能会遇到依赖缺失或重复提示的问题。若通过配置界面多次安装均失败，可利用 Agent 的调试能力自动修复环境依赖。修复完成后，向飞书机器人发送消息测试响应。
收到飞书机器人的回复表情即表示配置成功。此时可直接发送需求给机器人，它会接收问题并返回结果。若未收到响应，请检查机器人在线状态及网络连通性。
