您遇到的“飞书 + OpenClaw 突然报 503 (no body)”问题,通常意味着 OpenClaw 服务无法连接到飞书服务器或内部服务异常。结合您“刚才还正常”的情况,最可能的原因是 OpenClaw 网关(Gateway)意外停止飞书应用配置/权限失效

请按照以下步骤逐一排查:


🚦 步骤一:检查 OpenClaw 网关状态

网关是连接飞书和 OpenClaw 的核心。如果它停止运行,飞书的消息将无法送达,从而导致 503 错误。

  1. 检查网关是否运行

    bash

    openclaw gateway status

    • 正常状态:显示 Runtime: running

    • 异常状态:显示 stopped或类似信息,说明网关已停止。

  2. 如果网关已停止,尝试重启

    bash

    尝试启动网关

    openclaw gateway start

    如果启动失败,使用 --force 参数强制重装并重启

    openclaw gateway install --force

    openclaw gateway start

    重启后,再次使用 @你的机器人 你好测试是否恢复响应。


🔍 步骤二:检查飞书渠道连接

如果网关运行正常但机器人依然无响应,可能是与飞书的连接断开。

  1. 检查渠道状态

    bash

    openclaw channels status --probe

    • 正常状态feishu渠道显示为 connected

    • 异常状态:显示 disconnectedprobe: failed

  2. 如果渠道断开,尝试重连

    bash

    触发飞书渠道重新登录和连接

    openclaw channels login

    重连后,再次测试机器人是否恢复。


📝 步骤三:查看实时日志

日志是定位问题根源最直接的方式。请在终端运行以下命令,然后从飞书发送一条消息给机器人,观察日志输出。

bash

openclaw logs --follow

重点关注以下几类错误日志:

  • 503 Service Unavailable/ 502 Bad Gateway

    • 含义:上游服务(如飞书 API 或模型 API)不可用。

    • 对策:可能是飞书服务波动或网络问题,可稍后重试。

  • 401 Unauthorized/ 403 Forbidden

    • 含义:认证失败或权限不足。

    • 对策:检查飞书应用的 App IDApp Secret是否填写正确,以及应用所需权限(如 im:message)是否已申请并通过审批。

  • missing_scope

    • 含义:缺少必要的权限范围。

    • 对策:登录飞书开放平台,为应用补充所需权限并重新发布。

  • connection refused/ timeout

    • 含义:网络连接问题,可能是代理失效或防火墙拦截。

    • 对策:检查服务器网络及代理设置。


🛠️ 步骤四:检查飞书开放平台配置

有时问题出在飞书应用本身的配置上,尤其是如果您或管理员近期修改过设置。

  1. 检查应用发布状态:确保应用已发布,而不仅仅是“保存”。

  2. 检查事件订阅:确认已启用事件订阅,并勾选了 im.message.receive_v1(或类似接收消息的事件)。

  3. 检查权限配置:确保已申请并获得了必要的权限(如 im:message),且权限状态为“已生效”。


💡 快速排查路径总结

根据您“刚才还正常”的描述,问题很可能出在本地服务。建议按以下顺序操作:

  1. 终端执行

    bash

    openclaw gateway status

    openclaw channels status --probe

  2. 如果网关停止

    bash

    openclaw gateway start

  3. 如果渠道断开

    bash

    openclaw channels login

  4. 最后,查看日志定位具体错误

    bash

    openclaw logs --follow

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐