龙虾 OpenClaw 出问题先跑哪几条命令：openclaw status / gateway status / logs --follow

当你的 OpenClaw 集群出现异常时，快速定位问题至关重要。以下是最优先执行的三条命令，它们能帮助你快速判断集群状态、网关健康度以及日志中的关键信息，从而快速定位问题根源。

1. 检查 OpenClaw 集群状态

openclaw status

作用：
该命令会输出 OpenClaw 集群中所有节点的运行状态，包括节点是否在线、服务是否正常、是否有错误或警告信息。

输出示例（简化）：

Node: claw-01
  Status: Running
  Services: [clawd, clawd-worker, clawd-api]
  Errors: 0
  Warnings: 1

Node: claw-02
  Status: Down
  Services: [clawd, clawd-worker]
  Errors: 2
  Warnings: 0

解读：

• 如果某个节点状态为 Down，说明该节点宕机或未启动，需优先检查该节点的主机状态。
• 如果服务列表中缺少 clawd-api 或 clawd-worker，说明服务未正常启动。
• 错误数（Errors）或警告数（Warnings）增加，说明存在异常，需结合日志进一步排查。

2. 检查网关状态

gateway status

作用：
该命令用于检查 OpenClaw 网关的运行状态，包括网关是否在线、是否连接到集群、是否有连接错误或超时。

输出示例（简化）：

Gateway: claw-gateway-01
  Status: Online
  Connected Nodes: 2/3
  Last Heartbeat: 2025-04-05 14:30:00 UTC
  Errors: 0
  Latency: 12ms

解读：

• 如果网关状态为 Offline，说明网关未启动或与集群断开连接。
• Connected Nodes 数量少于集群总节点数，说明部分节点未被网关识别，可能因网络或服务异常导致。
• Latency 值异常（如 > 100ms），说明网关与节点通信延迟高，可能涉及网络或节点性能问题。

3. 实时查看日志（推荐持续运行）

logs --follow

作用：
该命令会持续输出 OpenClaw 集群的日志，包括 clawd、clawd-worker、clawd-api、gateway 等组件的日志，帮助你实时监控异常信息。

输出示例（简化）：

2025-04-05 14:31:00 UTC clawd[12345]: INFO: Starting clawd service...
2025-04-05 14:31:02 UTC clawd-worker[67890]: ERROR: Failed to connect to database: timeout
2025-04-05 14:31:03 UTC clawd-api[11111]: WARN: Node claw-02 is unreachable

解读：

• 日志中出现 ERROR 或 WARN 关键词，说明存在异常。
• 特别关注以下关键词：
  • Failed to connect：网络或服务连接问题。
  • Timeout：超时，可能涉及网络延迟或服务响应慢。
  • Node unreachable：节点不可达，可能因节点宕机或网络隔离。
  • Database error：数据库连接异常，可能涉及配置或资源不足。

总结：三条命令的执行顺序与优先级

常见问题与应对建议

问题 1：openclaw status 显示节点状态为 Down

可能原因：

• 主机宕机
• 服务未启动
• 网络不通

建议操作：

1. 检查节点主机是否在线（使用 ping 或 ssh）。
2. 检查节点服务是否启动（使用 systemctl status clawd）。
3. 检查节点与集群的网络连通性（使用 telnet 或 nc 测试端口）。

问题 2：gateway status 显示 Connected Nodes 少于集群总数

可能原因：

• 节点未注册到网关
• 网关与节点通信异常
• 节点服务未启动或异常

建议操作：

1. 检查网关配置文件（/etc/claw/gateway.yaml）中的节点列表是否正确。
2. 检查网关与节点的网络连通性（使用 telnet 或 nc 测试网关与节点的通信端口）。
3. 检查节点服务状态（使用 systemctl status clawd）。

问题 3：logs --follow 中频繁出现 ERROR 或 WARN

可能原因：

• 网络连接异常
• 节点服务异常
• 配置错误
• 资源不足（如内存、磁盘）

建议操作：

1. 检查日志中具体的错误信息（如 Failed to connect to database、Node unreachable 等）。
2. 检查节点的资源使用情况（使用 top 或 free -h）。
3. 检查配置文件是否正确（如 clawd.yaml、gateway.yaml）。
4. 检查节点与网关的网络连通性（使用 ping、traceroute、telnet）。

补充建议：日志查看技巧

• 使用 grep 过滤特定关键词（如 ERROR、WARN）：

  logs --follow | grep -i "error\|warn"

• 使用 tail -f 实时查看日志（等同于 logs --follow）：

  tail -f /var/log/claw/clawd.log

• 查看特定组件的日志（如 clawd-worker）：

  tail -f /var/log/claw/clawd-worker.log

总结：三条命令是 OpenClaw 故障排查的“黄金三板斧”

• openclaw status：快速了解集群整体状态。
• gateway status：检查网关是否正常工作。
• logs --follow：实时监控日志，定位具体问题。

执行顺序建议：

1. 先运行 openclaw status，确认集群节点状态。
2. 再运行 gateway status，确认网关健康度。
3. 最后运行 logs --follow，实时查看日志，定位问题根源。

通过这三条命令，你可以在几分钟内快速定位 OpenClaw 集群的异常问题，大幅提升故障排查效率。