OpenClaw 日志位置与实用命令参考¶

# 找到最新 session
LATEST=$(ls -t ~/.openclaw/agents/main/sessions/*.trajectory.jsonl | head -1)

# 查看统计信息（各事件类型数量）
python3 -c "
import json
with open('$LATEST') as f:
    types = {}
    for line in f:
        obj = json.loads(line.strip())
        t = obj.get('type', 'unknown')
        types[t] = types.get(t, 0) + 1
    for t, c in sorted(types.items(), key=lambda x: -x[1]):
        print(f'  {t}: {c}')
"

# 查看发送给模型的 prompt（用户消息）
grep '"prompt.submitted"' "$LATEST" | python3 -c "
import sys, json
for line in sys.stdin:
    obj = json.loads(line.strip())
    data = obj.get('data', {})
    print('User prompt:', data.get('prompt', 'N/A'))
    print('---')
"

# 查看模型返回结果
grep '"model.completed"' "$LATEST" | python3 -c "
import sys, json
for line in sys.stdin:
    obj = json.loads(line.strip())
    data = obj.get('data', {})
    texts = data.get('assistantTexts', [])
    usage = data.get('usage', {})
    print(f'Usage: input={usage.get(\"input\")}, output={usage.get(\"output\")}, total={usage.get(\"total\")}')
    for i, t in enumerate(texts):
        print(f'Reply {i}: {t[:200]}...' if len(t) > 200 else f'Reply {i}: {t}')
    print('---')
"

# 查看上下文编译结果（system prompt + 消息）
grep '"context.compiled"' "$LATEST" | python3 -c "
import sys, json
for line in sys.stdin:
    obj = json.loads(line.strip())
    data = obj.get('data', {})
    for k, v in data.items():
        if isinstance(v, str) and len(v) > 300:
            print(f'{k}: {v[:300]}...[total {len(v)} chars]')
        else:
            print(f'{k}: {v}')
    print('---')
"

# 查看最近的 Heartbeat 执行记录
tail -20 logs/heartbeat-execution.log

# 查看 Heartbeat 状态
cat memory/heartbeat-state.json

# 查看 Git 提交历史
git log --oneline -- logs/heartbeat-execution.log

# 查看 Cron 执行日志
tail -30 logs/cron-execution.log

# 查看 Agent Cron 日志
tail -30 logs/agent-cron.log

# 查看特定日期的 cron 执行
grep "2026-05-07" logs/agent-cron.log

# 查看归档日志
tail -30 logs/feishu-archive.log

# 手动测试归档
python3 scripts/feishu-archive.py

# 测试指定日期归档
python3 scripts/feishu-archive.py 2026-05-07

# 检查站点 HTTP 状态
curl -s -o /dev/null -w "%{http_code}" http://localhost/deployment/
curl -s -o /dev/null -w "%{http_code}" http://localhost/game/
curl -s -o /dev/null -w "%{http_code}" http://localhost/

# 检查 Nginx 状态
systemctl status nginx

# 检查 OpenClaw Gateway
openclaw gateway status

# 查看错误日志
sudo tail -50 /var/log/nginx/error.log

# 查看访问日志
sudo tail -50 /var/log/nginx/access.log

# 测试 Nginx 配置
sudo nginx -t

# 列出所有 session 文件
ls -lt ~/.openclaw/agents/main/sessions/*.jsonl | head -20

# 查看特定 session 大小
wc -l ~/.openclaw/agents/main/sessions/*.jsonl

# 查看 trajectory 文件大小
du -sh ~/.openclaw/agents/main/sessions/*.trajectory.jsonl

# 查看当前配置
openclaw config get

# 查看配置 schema
openclaw config schema lookup tools.loopDetection

# 查看 Gateway 状态
openclaw gateway status

# 重启 Gateway
openclaw gateway restart

# 查看 Git 状态
git status

# 查看最近提交
git log --oneline -20

# 查看特定文件的提交历史
git log --oneline -- memory/2026-05-07.md

# 提交变更
git add -A
git commit -m "docs: 更新记录 YYYY-MM-DD"
git push

tools.loopDetection.enabled: true
tools.loopDetection.warningThreshold: 3
tools.loopDetection.criticalThreshold: 5
tools.loopDetection.globalCircuitBreakerThreshold: 8

# 修复目录权限
sudo chmod 755 /home/admin/.openclaw
sudo chmod -R 755 /home/admin/.openclaw/workspace/*/site/

python3 scripts/get-feishu-app-token.py --force

~/.openclaw/
├── agents/main/sessions/          # 会话文件（JSONL）
│   ├── <session-id>.jsonl         # 会话完整记录
│   ├── <session-id>.trajectory.jsonl  # 模型调用轨迹 ⭐
│   └── <session-id>.checkpoint.<hash>.jsonl  # 会话快照
├── cron/runs/                     # Cron 运行记录
│   └── <run-id>.jsonl
├── logs/                          # 系统日志
│   ├── commands.log
│   ├── config-audit.jsonl
│   └── config-health.json
├── browser/openclaw/user-data/    # 浏览器数据
└── workspace/                     # 工作区
    ├── MEMORY.md                  # 长期记忆
    ├── SOUL.md                    # 人格定义
    ├── HEARTBEAT.md               # 心跳任务
    ├── memory/                    # 每日记忆
    │   ├── YYYY-MM-DD.md
    │   └── heartbeat-state.json
    ├── logs/                      # 任务日志
    │   ├── cron-execution.log
    │   ├── agent-cron.log
    │   ├── heartbeat-execution.log
    │   ├── feishu-archive.log
    │   └── ebbinghaus-*.log
    ├── scripts/                   # 脚本
    │   ├── agent-cron-tasks.sh
    │   ├── feishu-archive.py
    │   ├── get-feishu-app-token.py
    │   ├── install-cron.sh
    │   └── auto-record.sh
    └── knowledge-base/            # 知识库

# === 快速查看最新会话 ===
LATEST=$(ls -t ~/.openclaw/agents/main/sessions/*.trajectory.jsonl | head -1)
echo "Latest session: $LATEST ($(wc -l < $LATEST) lines)"

# === 查看今天的记忆 ===
cat memory/$(date +%Y-%m-%d).md

# === 查看今天的 Heartbeat 记录 ===
grep "$(date +%Y-%m-%d)" logs/heartbeat-execution.log

# === 查看今天的 Cron 执行 ===
grep "$(date +%Y-%m-%d)" logs/agent-cron.log

# === 检查所有站点状态 ===
for site in deployment game; do
  code=$(curl -s -o /dev/null -w "%{http_code}" http://localhost/$site/)
  echo "$site: $code"
done

# === 查看最近 10 个 session 文件 ===
ls -lt ~/.openclaw/agents/main/sessions/*.jsonl | head -10

# === 查看 trajectory 事件统计 ===
python3 -c "
import json
LATEST='$(ls -t ~/.openclaw/agents/main/sessions/*.trajectory.jsonl | head -1)'
with open(LATEST) as f:
    types = {}
    for line in f:
        obj = json.loads(line.strip())
        t = obj.get('type', 'unknown')
        types[t] = types.get(t, 0) + 1
    for t, c in sorted(types.items(), key=lambda x: -x[1]):
        print(f'  {t}: {c}')
"