飞书群无法调用 Hermes龙虾 机器人

🔍 飞书群聊故障排查指南

针对"智创中心"群无法调用 Hermes龙虾 的问题，请按照以下步骤逐一排查。

✅ 当前状态确认

• 应用集成 ：已配置（App ID: cli_aa9fd44291f91cb1）。
• 技能状态 ：persona-switch 技能已启用。
• 群聊策略 ：已修复为开放模式（groupPolicy: "open"），网关已重启并生效。

🛠️ 排查步骤

1. 确认机器人在群成员列表中

首先确保机器人已被邀请进入"智创中心"群聊。

1. 打开飞书 "智创中心" 群聊窗口。
2. 点击右上角 "..." → 选择 "群机器人"（或查看群成员列表）。
3. 确认 App ID 为 xxxx 的机器人在列表中。
   • 若不在： 请联系群管理员添加机器人，或在飞书开放平台检查应用的"可用范围"是否包含该群组。

2. 测试消息接收与日志监控

在群里发送测试指令，同时观察服务器端是否有响应。

• 发送测试消息： @QClaw 你好

• 查看服务器日志：
  在终端运行以下命令实时监控日志：

  tail -f ~/.qclaw/logs/gateway.log

• 判断依据：

  • 有日志记录： 说明消息已送达，问题可能出在 Hermes 内部逻辑或回复权限上。
  • 无日志记录： 说明消息未到达网关，通常是事件订阅 或网络回调问题（见步骤 3）。

3. 检查飞书开放平台事件订阅

如果日志无反应，需检查飞书后台配置。

1. 登录 飞书开放平台。
2. 进入 "事件与回调" → "事件订阅"。
3. 确保已勾选以下关键事件：
   • ✅ im.message.receive_v1（接收消息 v1）
   • ✅ im.message.message_read_v1（消息已读，可选但建议开启）
4. 检查请求网址（Webhook URL）：
   • 确保填写的地址格式正确：http://您的域名或IP:65215/feishu/events
   • 注意： 飞书强制要求 HTTPS。如果您使用的是本地 IP，必须使用内网穿透工具（如 ngrok、natapp）生成 HTTPS 地址，或者配置 SSL 证书。