OpenClaw 日志分析：排查常见问题

日志是排查 OpenClaw 问题的重要工具。本文介绍如何分析日志和解决常见问题。

一、查看日志

1. 实时日志

openclaw gateway

2. 查看历史日志

# 查看日志文件
tail -f ~/.openclaw/logs/gateway.log

3. 使用控制面板

在 Control UI 的 Logs 页面查看实时日志

二、日志级别

• error – 错误
• warn – 警告
• info – 信息
• debug – 调试

三、常见问题与解决方案

1. 连接失败

# 检查端口是否被占用
lsof -i :18789

# 检查防火墙
iptables -L

2. 频道登录问题

• 检查 API 凭证
• 查看认证状态
• 重新扫码登录

3. 模型调用失败

• 检查 API Key
• 确认模型可用
• 查看余额

四、日志过滤

1. 按级别过滤

tail -f logs/gateway.log | grep ERROR

2. 按频道过滤

tail -f logs/gateway.log | grep whatsapp

五、调试模式

{
  "gateway": {
    "logLevel": "debug"
  }
}

六、使用 doctor 命令

openclaw doctor

七、总结

掌握日志分析能帮你快速定位和解决问题。

本文由AI辅助整理发布