故障排除

用于诊断无响应、未收到事件或需要轮换凭证的 Feishu 机器人。

故障排查¶

机器人在群聊中无响应¶

1. 确保机器人已添加到群聊
2. 确保你 @提及机器人（默认要求）
3. 确认 groupPolicy 不是 "disabled"
4. 查看日志：openclaw logs --follow

机器人未收到消息¶

1. 确保机器人已在 Feishu Open Platform / Lark Developer 中发布并获批
2. 确保事件订阅包含 im.message.receive_v1
3. 对于会议邀请自动加入，还需订阅 vc.bot.meeting_invited_v1
4. 确保已选择 持久连接（WebSocket）
5. 确保已授予所有必需的权限范围
6. 确保网关正在运行：openclaw gateway status
7. 查看日志：openclaw logs --follow

订阅 vc.bot.meeting_invited_v1 只会投递事件。自动加入默认关闭。要全局启用：

{
  channels: {
    feishu: {
      vcAutoJoin: true,
    },
  },
}

若仅启用一个账户，请省略顶层开关并设置账户覆盖：

{
  channels: {
    feishu: {
      accounts: {
        meetings: { vcAutoJoin: true },
      },
    },
  },
}

邀请者仍会经过正常的 Feishu 私聊策略、允许列表/配对、会话和回复路由，然后代理才会收到加入回合。加入还需要一个可用的 Feishu VC 加入工具，该工具以应用身份配置并具有 vc:meeting.bot.join:write 权限范围。例如，官方 lark-cli VC 代理技能 提供 vc +meeting-join。

Webhook 回调因 401 无效签名被拒绝¶

1. 检查 Gateway 主机时钟：webhook 模式会拒绝时间戳与服务器时钟相差超过一小时（早于或晚于）的签名回调。请验证 NTP 同步以及系统时间正确。
2. 确认配置的 encryptKey 与 Feishu Open Platform / Lark Developer 中应用的 Encrypt Key 一致。
3. 验证 webhook URL 路径和端口与 channels.feishu.webhook* 配置一致。
4. 查看日志：openclaw logs --follow，检查来自意外发送方的重复签名失败。

二维码设置在 Feishu 移动应用中无响应¶

1. 重新运行设置：openclaw channels login --channel feishu
2. 选择手动设置
3. 在 Feishu Open Platform 中创建自建应用，并复制其 App ID 和 App Secret
4. 将这些凭证粘贴到设置向导中

App Secret 泄露¶

1. 在 Feishu Open Platform / Lark Developer 中重置 App Secret
2. 更新配置中的值
3. 使用 openclaw channels status --probe 验证 热重载 已应用新凭证。