Mission Claw 活动日志记录

将重要任务记录到 Mission Claw 活动动态中，用于跟踪智能体工作、Token 使用量及项目进展。

前提条件

• Mission Claw CLI：主机系统上必须已安装 mclaw 二进制可执行文件。
• OpenClaw 内置工具：依赖 session_status 工具获取当前 Token 使用量。

CLI 使用方式

mclaw log "任务描述" 
  --agent "AgentName" 
  --project "ProjectName" 
  --status completed 
  --duration "Xm Ys" 
  --input-tokens N 
  --output-tokens N 
  --total-tokens N

必填字段

• action — 简要任务描述（位置参数）
• --agent — 智能体名称（例如："J"、"mission-claw"、"type-alchemy"）
• --total-tokens — 使用的总 Token 数（必须始终提供）

可选字段

• --details — 对所完成工作的详细说明
• --project — 项目名称
• --status — 状态值：completed（默认）、in_progress 或 failed
• --duration — 耗时（例如："5m"、"1h 30m"）
• --input-tokens / --output-tokens — Token 的输入/输出细分

何时记录日志

在完成以下任务后进行记录：

• 重要的开发任务
• 缺陷修复或功能实现
• 调研或探索性工作
• 配置变更
• 任何值得追踪的任务

获取 Token 使用量

记录前，请先查看当前会话的 Token 使用情况：

• 使用内置 session_status 工具查看当前 Token 数量
• 对于子智能体（subagents），Token 数量包含在其完成通知中

示例

# 功能实现
mclaw log "为仪表板添加日期时间筛选器" 
  --agent "mission-claw" 
  --project "Mission Claw" 
  --status completed 
  --duration "10m" 
  --total-tokens 15000

# 快速修复
mclaw log "修复时区缺陷" 
  --agent "J" 
  --project "ContentMorph" 
  --duration "2m" 
  --total-tokens 3500

# 进行中的工作
mclaw log "实现支付流程" 
  --agent "J" 
  --project "TypeAlchemy" 
  --status in_progress

其他命令

mclaw list                    # 查看最近活动
mclaw list --agent J          # 按智能体过滤
mclaw status                  # 查看简要统计信息与服务状态
mclaw dashboard start         # 启动 Web 仪表板（默认地址为 localhost:3101）

API 替代方案

CLI 默认向本地守护进程（地址为 http://localhost:3100）发送日志。你也可以直接向 API 发起 POST 请求：

POST http://localhost:3100/api/activity

{
  "action": "任务名称",
  "agent": "J",
  "project": "Project",
  "status": "completed",
  "totalTokens": 5000,
  "inputTokens": 4000,
  "outputTokens": 1000
}