Notas del LabOperations

Operations Cheatsheet

Referencia rápida para los comandos operacionales más comunes. Companion del [Runbook](/es/lab/60-operations/runbook).

Propósito

Esta página es una referencia rápida para operators. No sustituye al Runbook; provee los comandos que se usan más a menudo, en una forma que se puede copiar y pegar.

Path placeholders

PlaceholderValor real
{workspace-root}El workspace root del operator.
{coordinator-port}El puerto del gateway del Coordinator (default 18789).
{worker-port}El puerto del gateway del Research Worker (default 18790).
{media-port}El puerto del gateway del Media Agent (default 18791).
{backup-destination}La ubicación del backup (p. ej., disco externo o cloud).
{cold-storage-destination}El cold storage para misiones archivadas.

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
 
# Sesiones activas
{framework-cli} session list
 
# Misiones en curso
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

# Listar sesiones
{framework-cli} session list
 
# Reanudar una sesión
{framework-cli} session resume {session-id}
 
# Status de una sesión
{framework-cli} session status {session-id}
 
# Terminar una sesión
{framework-cli} session end {session-id}

Mission management

# Listar misiones
ls {workspace-root}/research/runs/
 
# Status de una misión
cat {workspace-root}/research/runs/{mission-id}/phase.json | jq .
 
# Logs de una fase
cat {workspace-root}/research/runs/{mission-id}/logs/{phase}.log
 
# Informe final
cat {workspace-root}/research/runs/{mission-id}/artifacts/final_report.md
 
# Resumen de la misión
cat {workspace-root}/research/runs/{mission-id}/run_summary.md

Coding Assistant

# Correr no interactivamente
{framework-cli} coding-assistant run \
  --prompt-file {prompt-path} \
  --workspace {workspace-root}/{project-name} \
  --trust-level workspace-write
 
# Comprobar el resultado
{framework-cli} coding-assistant status {run-id}

Browser

# Abrir una URL
{framework-cli} browser open {url}
 
# Snapshot de la página actual
{framework-cli} browser snapshot
 
# Tomar un screenshot
{framework-cli} browser screenshot
 
# Cerrar todas las pestañas
{framework-cli} browser close --all
 
# Reiniciar el browser
{framework-cli} browser restart

Memory

# Diario de hoy
cat {workspace-root}/memory/$(date +%Y-%m-%d).md
 
# Listar ficheros de memory
ls {workspace-root}/memory/
 
# Buscar en memory
{framework-cli} memory search "{query}"

Tests

# Proyecto Node
cd {workspace-root}/{project-name}
npm test
 
# Proyecto Python
cd {workspace-root}/{project-name}
pytest
 
# Con cobertura
pytest --cov={module} tests/

Backup

# Correr el backup
{workspace-root}/ops/cheatsheets/backup.sh
 
# Verificar el backup
{workspace-root}/ops/cheatsheets/verify-backup.sh {backup-name}
 
# Listar backups
ls -lt {backup-destination}/ | head -10

Audit

# Listar audit reports
ls -lt {workspace-root}/security/audits/ | head -10
 
# Abrir el report más reciente
cat $(ls -t {workspace-root}/security/audits/ | head -1)

Variables de entorno comunes

VariablePropósito
{framework-cli}Ruta al CLI del framework.
{workspace-root}El workspace root del operator.
EDITOREl editor de texto por defecto para ficheros de memory.
LOG_LEVELEl log level (debug, info, warn, error).

Cheatsheets de comandos mantenidos

El lab mantiene un pequeño conjunto de cheatsheets de comandos bajo {workspace-root}/comandos_terminal/. Estos son la referencia rápida del operator para los comandos CLI más comunes. Se mantienen actualizados como parte de la cadencia de operaciones.

CheatsheetPropósito
openclaw_cheatsheet.mdComandos de OpenClaw gateway, session y herramientas.
codex_cli_cheatsheet.mdInvocación y flags del CLI del Coding Assistant.
claude_code_cheatsheet.mdReferencia del CLI de Claude Code (para cross-checks).
tutorial_auth_minimax.mdAutenticación y renovación de quota para el provider del modelo.

Los cheatsheets están diseñados para hojearse, no para leerse. También son la fuente de la que derivan los bloques de cheatsheet de esta página: cuando un cheatsheet en comandos_terminal/ se actualiza, esta página se actualiza para reflejarlo.

Ver también