📊 OpenClaw Activity Tab可观测性完全指南

下午4点15分，我盯着屏幕上跳动的Activity Tab，终于看清了我的Agent到底在忙什么——原来它花80%时间在发呆...

📊 什么是Activity Tab？

Activity Tab是OpenClaw v2026.5.27推出的核心可观测性功能，它提供了一个实时视图，展示Agent的：

  • 实时活动流：每一次工具调用、推理、决策都实时显示
  • 性能指标：响应时间、token消耗、成本统计
  • 工具调用链：可视化展示工具调用依赖关系
  • 异常检测：自动标记超时、失败、异常行为
💡 核心价值：Activity Tab = 给Agent装了个"心电图"，随时知道它是活蹦乱跳还是快挂了。

⚙️ Activity Tab核心功能

1. 实时活动流

# 启动Activity Tab监控
openclaw activity monitor --session abc123

# 输出示例：
# [14:15:03] 🧠 推理中... (token: 1,234)
# [14:15:05] 🔧 调用 web_search "OpenClaw教程"
# [14:15:07] ✅ web_search 完成 (耗时: 2.3s)
# [14:15:08] 🔧 调用 write "/tools/xxx.html"
# [14:15:09] ✅ write 完成 (耗时: 1.1s)

2. 性能指标面板

# 查看性能摘要
openclaw activity stats --session abc123 --last 1h

# 输出：
# 总请求: 147次
# 平均响应: 1.8s
# Token消耗: 45,321 (输入) + 12,456 (输出)
# 成本: $0.87
# 成功率: 97.3%

3. 工具调用火焰图

# 生成工具调用时序图
openclaw activity flamegraph --session abc123 \
  --output activity-flame.html

# 可视化展示每次调用的：
# - 开始/结束时间
# - 调用深度（嵌套调用）
# - 耗时占比

💡 实战场景

场景1：发现Agent"摸鱼"

Activity Tab显示Agent大量时间花在无效的思考上：

openclaw activity analyze --session abc123 \
  --metric idle_time

# 发现：
# 总耗时: 3600s (1小时)
# 有效工作: 720s (20%)
# 推理思考: 2520s (70%)  ← 这里有问题！
# 工具调用: 360s (10%)

解决方案：开启--reasoning off或减少max_reasoning_steps。

场景2：成本异常告警

# 设置成本告警
openclaw activity alert set \
  --metric cost_per_hour \
  --threshold 5.00 \
  --action "notify_feishu"

# 当每小时成本超过$5时，自动发送飞书通知

场景3：性能瓶颈定位

# 找出最慢的工具调用
openclaw activity top --sort duration --limit 10

# 排名：
# 1. web_fetch https://slow-site.com (15.3s)
# 2. llm_call gpt-5 (8.7s)
# 3. browser snapshot (6.2s)

🛠️ 配置Activity Tab

基础配置

# ~/.openclaw/config.yaml
activity:
  enabled: true
  refresh_interval: 1000  # 刷新间隔(ms)
  retention_hours: 24     # 保留24小时活动记录
  metrics:
    - token_usage
    - cost
    - latency
    - success_rate
  alerts:
    - type: cost
      threshold: 10.00  # 单次会话成本超过$10告警
    - type: latency
      threshold: 5000   # 单次调用超过5秒告警

Web UI访问

# 启动Activity Tab Web界面
openclaw activity serve --port 8080

# 浏览器访问：
# http://localhost:8080/activity

🚀 高级功能

导出分析报告

# 导出为HTML报告
openclaw activity export --session abc123 \
  --format html \
  --include-flamegraph \
  --output report.html

对比多个Session

# 对比不同session的性能
openclaw activity compare \
  --sessions abc123,def456,ghi789 \
  --metric cost_per_task

与Prometheus集成

# 暴露Prometheus指标
activity:
  prometheus:
    enabled: true
    port: 9090

🔗 相关资源