Agent Task Status

Use the bundled script to inspect OpenClaw session indexes and transcript files, then extract the latest assignment and structured report for each target agent.

Quick start

Run the script directly:

python3 /home/lyqadmin/.openclaw/workspace/skills/agent-task-status/scripts/check_agent_task_status.py --format summary

For more examples, read references/usage.md.

Workflow

1. Decide which agents to inspect.
   • Use --agents a,b,c for explicit targets.
   • Use --agent-file when the list comes from a file.
   • Use --discover when the deployment has many agents under the same root.
2. Set the agent storage root.
   • Default is ~/.openclaw/agents.
   • Override with --base or OPENCLAW_AGENTS_BASE in non-default environments.
3. Match the session shape.
   • Default session key template is agent:{agent}:main.
   • Override with --session-key-template if your target sessions use another pattern.
4. Match the assignment/report language.
   • Default assignment keyword is 正式任务分配：.
   • Default report prefixes are 任务： / 状态： / 结果： / 风险：.
   • Override these when the team uses different markers or another language.
5. Filter the output when needed.
   • --only-status filters by normalized status such as completed, blocked, accepted, no-assignment, assigned-no-report, error.
   • --contains filters by keyword across assignment text, parsed task, result, and risk.
6. Pick an output format.
   • table: best for human inspection
   • summary: compact overview
   • json: structured automation output
   • jsonl: line-oriented pipelines
7. Use --strict for CI/automation.
   • Exit 0: normal
   • Exit 1: partial problem such as missing assignment/report or agent error
   • Exit 2: script/runtime error
8. Use --output-file to persist results for later review or downstream automation.

Recommended commands

Human-readable table:

python3 /home/lyqadmin/.openclaw/workspace/skills/agent-task-status/scripts/check_agent_task_status.py --agents xiaocheng,xiaowen,xiaobian --format table

Only completed tasks:

python3 /home/lyqadmin/.openclaw/workspace/skills/agent-task-status/scripts/check_agent_task_status.py --discover --only-status completed --format summary

Filter by keyword:

python3 /home/lyqadmin/.openclaw/workspace/skills/agent-task-status/scripts/check_agent_task_status.py --discover --contains 自动化 --format table

Automation JSON:

python3 /home/lyqadmin/.openclaw/workspace/skills/agent-task-status/scripts/check_agent_task_status.py --agent-file ./agents.txt --format json --strict --output-file ./agent-status.json

What to inspect in the output

• sessionKey: which session was used
• sessionFile: exact transcript file path
• assignedAt / assignText: when and what was assigned
• reportAt: when the agent reported back
• task / status_raw / status_normalized / result / risk: parsed structured fields
• error: why the check failed for that agent

Limitations

• This skill assumes an OpenClaw-style agent root with sessions/sessions.json and transcript sessionFile paths.
• It only checks the target session pattern you specify; it does not automatically infer every possible routing form.
• If the assignment keyword or report field prefixes change, you must override them.
• It reports what is present in transcripts; it does not infer hidden work with no assignment/report markers.