日志在哪？
~/.openclaw/logs/
├── openclaw.log # 主日志
├── heartbeat.log # 心跳日志
├── api.log # API 日志
└── error.log # 错误日志
查看日志
# 实时查看
openclaw logs --tail
# 查看最近 100 行
openclaw logs --tail 100
# 只看错误
openclaw logs --level error
# 搜索关键词
openclaw logs --grep "失败"
日志级别
| 级别 | 说明 | 示例 |
|---|---|---|
| DEBUG | 调试信息 | 变量值、执行路径 |
| INFO | 正常信息 | 启动、请求、完成 |
| WARN | 警告 | 配置问题、性能问题 |
| ERROR | 错误 | API 失败、异常 |
配置日志级别
logging:
level: info # debug/info/warn/error
file: ~/.openclaw/logs/openclaw.log
max_size: 10MB
max_files: 5
常见问题排查
问题 1：启动失败
日志：
Error: EADDRINUSE: address already in use :::3000
解决：
# 查看占用
lsof -i :3000
# 杀掉进程
kill -9 <PID>
问题 2：API 调用失败
日志：
Error: API request failed: 401 Unauthorized
解决：
- 检查 API Key 是否正确
- 检查是否过期
- 检查余额
问题 3：心跳不执行
日志：
Heartbeat task failed: script not found
解决：
- 检查脚本路径
- 检查脚本权限
问题 4：内存泄漏
日志：
JavaScript heap out of memory
解决：
# 增加内存限制
export NODE_OPTIONS="--max-old-space-size=4096"
问题 5：数据库错误
日志：
Error: SQLITE_BUSY: database is locked
解决：
- 减少并发
- 或升级到 PostgreSQL
日志分析技巧
统计错误数量
grep -c "ERROR" ~/.openclaw/logs/openclaw.log
查看最近错误
grep "ERROR" ~/.openclaw/logs/openclaw.log | tail -20
分析性能
grep "响应时间" ~/.openclaw/logs/openclaw.log
日志脱敏
logging:
redact:
- api_key
- password
- token
- secret
日志轮转
logging:
rotation:
enabled: true
max_size: 10MB
max_files: 10
compress: true
远程日志（可选）
logging:
remote:
enabled: true
url: https://logs.yourcompany.com/api
level: error
最佳实践
- 开发环境：level = debug
- 生产环境：level = info
- 敏感环境：level = warn + 脱敏
- 定期清理：保留 30 天
- 监控告警：错误自动通知