mission-claw（任务爪）

Mission Claw Activity Logging

Log significant tasks to the Mission Claw activity feed for tracking agent work, token usage, and project progress.

Prerequisites

• Mission Claw CLI: The mclaw binary must be installed on the host system.
• OpenClaw Built-ins: Relies on the session_status tool to retrieve current token usage.

CLI Usage

mclaw log "Task description" \
  --agent "AgentName" \
  --project "ProjectName" \
  --status completed \
  --duration "Xm Ys" \
  --input-tokens N \
  --output-tokens N \
  --total-tokens N

Required Fields

• action - Brief task description (positional argument)
• --agent - Agent name (e.g., "J", "mission-claw", "type-alchemy")
• --total-tokens - Total tokens used (always include)

Optional Fields

• --details - Longer description of work done
• --project - Project name
• --status - completed (default), in_progress, or failed
• --duration - Time taken (e.g., "5m", "1h 30m")
• --input-tokens / --output-tokens - Token breakdown

When to Log

Log after completing:

• Significant development tasks
• Bug fixes or feature implementations
• Research or investigation work
• Configuration changes
• Any task worth tracking

Getting Token Usage

Before logging, check your session's token usage:

• Use the built-in session_status tool to see current tokens
• For subagents, tokens are in the completion announcement

Examples

# Feature implementation
mclaw log "Added date-time filter to dashboard" \
  --agent "mission-claw" \
  --project "Mission Claw" \
  --status completed \
  --duration "10m" \
  --total-tokens 15000

# Quick fix
mclaw log "Fixed timezone bug" \
  --agent "J" \
  --project "ContentMorph" \
  --duration "2m" \
  --total-tokens 3500

# In-progress work
mclaw log "Implementing payment flow" \
  --agent "J" \
  --project "TypeAlchemy" \
  --status in_progress

Other Commands

mclaw list                    # Recent activities
mclaw list --agent J          # Filter by agent
mclaw status                  # Quick stats and service status
mclaw dashboard start         # Start web dashboard (localhost:3101 by default)

API Alternative

The CLI logs to a local daemon (defaulting to http://localhost:3100). You can also POST directly to the API:

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

{
  "action": "Task name",
  "agent": "J",
  "project": "Project",
  "status": "completed",
  "totalTokens": 5000,
  "inputTokens": 4000,
  "outputTokens": 1000
}