Clawdbot 日志与诊断

分析 Clawdbot 的性能、错误及会话数据。

常用命令

响应时间（最近 N 条消息）

scripts/response-times.sh [count]

近期错误

journalctl --user -u clawdbot-gateway.service --no-pager --since "1 hour ago" | grep -iE "(error|fail|invalid)" | tail -20

会话统计

scripts/session-stats.sh

网关状态

systemctl --user status clawdbot-gateway.service --no-pager

配置校验

cat ~/.clawdbot/clawdbot.json | jq . > /dev/null && echo "Config valid" || echo "Config invalid"

日志来源

常见诊断场景

响应缓慢

1. 检查响应时间：scripts/response-times.sh 20
2. 检查 sessions.json 中的 Token 数量：jq '.["agent:main:main"].totalTokens' ~/.clawdbot/agents/main/sessions/sessions.json
3. 若 Token 数超过 30000，可在 Telegram 中发送 /compact 命令，或启动新会话

配置错误

journalctl --user -u clawdbot-gateway.service --no-pager --since "10 minutes ago" | grep -i "invalid config"

API 费用（来自会话）

scripts/session-stats.sh

实用技巧

按类别筛选 Journal 日志

# 会话状态变更
journalctl --user -u clawdbot-gateway.service | grep "session state"

# 工具执行记录
journalctl --user -u clawdbot-gateway.service | grep "[tools]"

# Telegram 活动日志
journalctl --user -u clawdbot-gateway.service | grep "[telegram]"

解析会话文件以获取最近的消息

tail -20 ~/.clawdbot/agents/main/sessions/*.jsonl | jq -r 'select(.message.role=="user") | .message.content[0].text' 2>/dev/null | tail -10