给 NanoClaw 新增飞书（Feishu/Lark）机器…

在 NanoClaw 项目中通过 skills 引擎确定性地加入飞书渠道代码，再走完飞书开放平台建应用、配环境、注册会话、验证收发的完整流程。

适用场景

解决思路

1. 读取 `.nanoclaw/state.yaml`，若 `applied_skills` 中已包含 `feishu`，说明代码改动已就位，直接跳到 Setup（Phase 3）阶段。
2. 用 `AskUserQuestion` 询问用户是否已有飞书应用：已有则立即收集 `FEISHU_APP_ID` 与 `FEISHU_APP_SECRET`；没有则在 Phase 3 中创建。
3. 若 `.nanoclaw/` 目录还不存在，先初始化 skills 系统：`npx tsx scripts/apply-skill.ts --init`。
4. 应用技能代码包：`npx tsx scripts/apply-skill.ts .claude/skills/add-feishu`。它会确定性地新增 `src/channels/feishu.ts`（实现 Channel 接口的 FeishuChannel 类）、把飞书支持三方合并进 `src/index.ts`（通过 `readEnvFile` 读取凭据，配置存在时创建 FeishuChannel）、安装 `@larksuiteoapi/node-sdk` npm 依赖、向 `.env` 写入 `FEISHU_APP_ID` 与 `FEISHU_APP_SECRET`、并在 `.nanoclaw/state.yaml` 记录本次应用。
5. 若应用过程报告合并冲突，阅读意图文件 `modify/src/index.ts.intent.md`，了解 index.ts 的改动内容与不变量。
6. 运行 `npm run build` 验证代码改动，构建必须干净通过后才能继续。
7. 若用户没有飞书应用，指导其在飞书开放平台创建机器人：打开 https://open.feishu.cn/app 新建应用；在 **Credentials** 中复制 **App ID** 和 **App Secret**；在 **Event Subscriptions** 中启用 **Long Connection (WebSocket)** 模式；添加事件 `im.message.receive_v1`（接收消息）；在 **Permissions** 中添加 `im:message:send_as_bot`（以机器人身份发消息）与 `im:message`（读取消息）；**发布**应用（或创建版本并审批通过）。
8. 等待用户提供 App ID 和 App Secret。
9. 在 `.env` 中加入 `FEISHU_APP_ID=<their-app-id>` 与 `FEISHU_APP_SECRET=<their-app-secret>`。
10. 重新构建并重启服务：`npm run build`，然后 macOS 执行 `launchctl kickstart -k gui/$(id -u)/com.nanoclaw`，Linux 执行 `systemctl --user restart nanoclaw`。
11. 获取 chat_id：让用户运行 `npm run dev` 启动机器人，在飞书里向机器人发送任意消息（私聊或群聊），到日志的 metadata 中查看 chat_id，JID 格式为 `{chat_id}@feishu`；也可直接查询数据库 `sqlite3 store/messages.db "SELECT jid FROM chats WHERE jid LIKE '%@feishu'"`。
12. 注册会话：直接在 SQLite 中执行 `INSERT INTO registered_groups (jid, name, folder, trigger_pattern, added_at, requires_trigger) VALUES ('{chat_id}@feishu', 'feishu', 'feishu', '@{ASSISTANT_NAME}', datetime('now'), 0);`，注意 `requires_trigger` 设为 `0`（false），使机器人无需 @ 提及即可响应所有消息。
13. 重启服务以加载新注册。
14. 验证连接：让用户在飞书发一条消息，应能在几秒内收到回复。
15. 需要排查时查看日志：`tail -f logs/nanoclaw.log`，或交互式运行 `npm run dev`；关注 `Feishu bot info fetched`、`Connected to Feishu via WebSocket`、`Feishu message sent` 这几条日志。
16. 机器人无响应时依次检查：`.env` 中是否设置了 `FEISHU_APP_ID` 与 `FEISHU_APP_SECRET`；会话是否已注册（`sqlite3 store/messages.db "SELECT * FROM registered_groups WHERE jid LIKE '%@feishu'"`）；应用是否已在飞书开放平台发布（草稿应用收不到事件）；事件订阅 `im.message.receive_v1` 是否启用；是否启用了 Long Connection (WebSocket) 模式而非 webhook；服务是否在运行（macOS `launchctl list | grep nanoclaw`，Linux `systemctl --user status nanoclaw`）。
17. 机器人已连接但收不到消息时检查：应用是否有 `im:message` 权限；事件 `im.message.receive_v1` 是否已订阅；应用版本是否已发布并审批通过。
18. 能收但发不出去时检查：应用是否有 `im:message:send_as_bot` 权限；群聊场景需先把机器人加入群。
19. 出现 "Failed to fetch Feishu bot info" 时按非致命告警处理：机器人自身消息检测（过滤自己发的消息）会失效，但收发消息仍正常；通常是机器人 API 端点不可达，检查网络连通性。
20. 移除飞书集成时依次执行：删除 `src/channels/feishu.ts`；从 `src/index.ts` 移除 `FeishuChannel` 的 import 与创建代码块；若没有其他 channel 使用 `readEnvFile` 则一并移除该 import；从 `.env` 移除 `FEISHU_APP_ID` 与 `FEISHU_APP_SECRET`；删除飞书注册 `sqlite3 store/messages.db "DELETE FROM registered_groups WHERE jid LIKE '%@feishu'"`；卸载依赖 `npm uninstall @larksuiteoapi/node-sdk`；重新构建并重启 `npm run build && launchctl kickstart -k gui/$(id -u)/com.nanoclaw`（macOS）或 `npm run build && systemctl --user restart nanoclaw`（Linux）。

适用边界 · 注意事项

• 项目不是 NanoClaw、或不使用其 skills 引擎时，这套确定性代码合并流程不适用。
• 需求是 webhook 模式（要求公网 URL 或环境不支持 WebSocket 长连接）时，本技能的接入方式不适用。
• 希望机器人只在被 @ 时响应、而不是对所有消息自动回复时，本技能的注册方式（`requires_trigger=0`）不合预期。