Operations Cheatsheet

Quick reference for the most common operational commands. Companion to the [Runbook](/en/lab/60-operations/runbook).

Purpose

This page is a quick reference for operators. It does not replace the Runbook; it provides the commands that are used most often, in a form that can be copied and pasted.

Path placeholders

Placeholder	Real value
`{workspace-root}`	The operator's workspace root.
`{coordinator-port}`	The Coordinator gateway port (default 18789).
`{worker-port}`	The Research Worker gateway port (default 18790).
`{media-port}`	The Media Agent gateway port (default 18791).
`{backup-destination}`	The backup location (e.g., external drive or cloud).
`{cold-storage-destination}`	The cold storage for archived missions.

Health checks

# Coordinator gateway
curl -s http://localhost:{coordinator-port}/health
 
# Research Worker gateway
curl -s http://localhost:{worker-port}/health
 
# Media Agent gateway
curl -s http://localhost:{media-port}/health
 
# Active sessions
{framework-cli} session list
 
# In-flight missions
ls {workspace-root}/research/runs/

Service management

macOS (launchd)

# Research Worker
launchctl kickstart -k gui/$(id -u)/{worker-launchagent-label}
launchctl list | grep {worker-launchagent-label}
 
# Media Agent
launchctl kickstart -k gui/$(id -u)/{media-launchagent-label}
launchctl list | grep {media-launchagent-label}
 
# Logs
tail -f /Users/{user}/.openclaw-scout/logs/gateway.log

Linux (systemd)

# Research Worker
sudo systemctl restart {worker-systemd-unit}.service
sudo systemctl status {worker-systemd-unit}.service
sudo journalctl -u {worker-systemd-unit}.service -n 100 -f
 
# Media Agent
sudo systemctl restart {media-systemd-unit}.service
sudo systemctl status {media-systemd-unit}.service
sudo journalctl -u {media-systemd-unit}.service -n 100 -f

Session management

# List sessions
{framework-cli} session list
 
# Resume a session
{framework-cli} session resume {session-id}
 
# Status of a session
{framework-cli} session status {session-id}
 
# End a session
{framework-cli} session end {session-id}

Mission management

# List missions
ls {workspace-root}/research/runs/
 
# Status of a mission
cat {workspace-root}/research/runs/{mission-id}/phase.json | jq .
 
# Logs of a phase
cat {workspace-root}/research/runs/{mission-id}/logs/{phase}.log
 
# Final report
cat {workspace-root}/research/runs/{mission-id}/artifacts/final_report.md
 
# Mission summary
cat {workspace-root}/research/runs/{mission-id}/run_summary.md

Coding Assistant

# Run non-interactively
{framework-cli} coding-assistant run \
  --prompt-file {prompt-path} \
  --workspace {workspace-root}/{project-name} \
  --trust-level workspace-write
 
# Check the result
{framework-cli} coding-assistant status {run-id}

Browser

# Open a URL
{framework-cli} browser open {url}
 
# Snapshot the current page
{framework-cli} browser snapshot
 
# Take a screenshot
{framework-cli} browser screenshot
 
# Close all tabs
{framework-cli} browser close --all
 
# Restart the browser
{framework-cli} browser restart

Memory

# Today's journal
cat {workspace-root}/memory/$(date +%Y-%m-%d).md
 
# List memory files
ls {workspace-root}/memory/
 
# Search memory
{framework-cli} memory search "{query}"

Tests

# Node project
cd {workspace-root}/{project-name}
npm test
 
# Python project
cd {workspace-root}/{project-name}
pytest
 
# With coverage
pytest --cov={module} tests/

Backup

# Run the backup
{workspace-root}/ops/cheatsheets/backup.sh
 
# Verify the backup
{workspace-root}/ops/cheatsheets/verify-backup.sh {backup-name}
 
# List backups
ls -lt {backup-destination}/ | head -10

Audit

# List audit reports
ls -lt {workspace-root}/security/audits/ | head -10
 
# Open the latest report
cat $(ls -t {workspace-root}/security/audits/ | head -1)

Common environment variables

Variable	Purpose
`{framework-cli}`	Path to the framework CLI.
`{workspace-root}`	The operator's workspace root.
`EDITOR`	The default text editor for memory files.
`LOG_LEVEL`	The log level (debug, info, warn, error).

Maintained command cheatsheets

The lab maintains a small set of command cheatsheets under {workspace-root}/comandos_terminal/. These are the operator's quick reference for the most common CLI commands. They are kept up to date as part of the operations cadence.

Cheatsheet	Purpose
`openclaw_cheatsheet.md`	OpenClaw gateway, session, and tool commands.
`codex_cli_cheatsheet.md`	Coding Assistant CLI invocation and flags.
`claude_code_cheatsheet.md`	Claude Code CLI reference (for cross-checks).
`tutorial_auth_minimax.md`	Authentication and quota renewal for the model provider.

The cheatsheets are designed to be skimmed, not read. They are also the source from which the cheatsheet blocks in this page are derived: when a cheatsheet in comandos_terminal/ is updated, this page is updated to match.