飞书接入指南：扫码连接到手动配置
飞书是 Kimi Claw 接入最完善的聊天渠道之一——支持群聊 @、单聊对话、团队协作等场景。
快捷方式：扫码连接（推荐）
最快的方式，适合个人用户或新创建的 Claw：
第 1 步：打开聊天频道设置
在 Kimi Claw 设置中找到"聊天频道 → 飞书"，点击进入连接界面。
第 2 步：飞书扫码
选择"扫码创建"方式，用飞书手机 App 扫描页面上的二维码。
第 3 步：在飞书侧完成创建
扫码后浏览器会自动打开飞书开发者平台的创建页面，按提示完成：
- 设置机器人名称和描述
- 添加机器人头像
- 勾选需要的权限（一般默认即可）
- 点击创建并发布应用
第 4 步：等待自动生效
飞书侧创建完成后，Kimi Claw 设置里的飞书渠道状态会自动变成"已连接"。整个过程不到两分钟。
手动配置（适合已有机器人）
如果你在飞书开发者平台已经有现成的应用，或者需要手动控制权限，可以用手动配置：
第 1 步：在飞书开发者平台创建应用
- 前往飞书开发者平台，点击 创建企业自建应用
- 设置 App 名称和描述
- 在应用中点击 添加机器人，创建机器人服务
第 2 步：配置权限
进入应用的 权限设置 页面，通过批量导入添加所需权限。Kimi Claw 的飞书插件会自动申请所需的权限，你只需要批准即可。
第 3 步：获取凭证并配置
在应用的 凭证与基础信息 页面，复制 App ID 和 App Secret，发送给 Kimi Claw 并说明这是飞书机器人的应用凭证：
我的飞书机器人凭证：App ID 是 xxx，App Secret 是 xxx，帮我配置一下
Kimi Claw 会自动完成配置。
第 4 步：配置事件订阅
在飞书开发者平台切换到 事件与回调 页面：
- 选择 长连接 方式接收事件
- 添加事件
im.message.receive_v1 - 保存后发布应用版本
第 5 步：重启 Claw 使配置生效
在 Kimi Claw 设置里点击 重启 Kimi Claw，等待网关重启完成后，在飞书里搜索机器人名字就能开始对话了。
诊断命令
如果飞书机器人配置遇到问题，可以在 Kimi Claw 对话中使用这些诊断命令：
| 命令 | 说明 |
|---|---|
/feishu start | 确认飞书插件是否已安装并启动 |
/feishu doctor | 检查飞书机器人配置是否正确 |
/feishu auth | 批量授权飞书机器人权限 |
进一步排查：在终端里运行 npx doctor 诊断插件运行状态，npx fix 自动修复常见配置问题。
删除飞书渠道
在 Kimi Claw 设置的聊天频道里找到飞书渠道，点击进入详情，选择删除。删除后 Claw 不再响应飞书里的消息，但飞书侧的应用不会被删除（需要单独去飞书开发者平台处理）。
