Ir al contenido

Referencia de la CLI

openclaw es el punto de entrada principal de la CLI. Cada comando principal tiene una página de referencia dedicada o está documentado junto con el comando al que hace alias; este índice lista los comandos, los indicadores globales y las reglas de estilo de salida que se aplican en toda la CLI.

Use los comandos de configuración por intención:

  • openclaw setup crea la configuración base y el espacio de trabajo sin pasar por todo el flujo de incorporación guiada.
  • openclaw onboard es la ruta guiada completa de primer uso para la puerta de enlace, autenticación del modelo, espacio de trabajo, canales, habilidades y estado.
  • openclaw configure cambia partes específicas de una configuración existente, como la autenticación del modelo, la puerta de enlace, canales, complementos o habilidades.
  • openclaw channels add configura las cuentas de los canales después de que exista la base; ejecútelo sin indicadores para una configuración guiada de canales o con indicadores específicos del canal para scripts.
ÁreaComandos
Configuración e incorporacióncrestodian · setup · onboard · configure · config · completion · doctor · dashboard
Restablecer y desinstalarbackup · reset · uninstall · update
Mensajería y agentesmessage · agent · agents · acp · mcp
Salud y sesionesstatus · health · sessions
Puerta de enlace y registrosgateway · logs · system
Modelos e inferenciamodels · infer · capability (alias de infer) · memory · commitments · wiki
Red y nodosdirectory · nodes · devices · node
Tiempo de ejecución y sandboxapprovals · exec-policy (ver approvals) · sandbox · tui · chat/terminal (alias de tui --local) · browser
Automatizacióncron · tasks · hooks · webhooks
Descubrimiento y documentacióndns · docs
Emparejamiento y canalespairing · qr · channels
Seguridad y complementossecurity · secrets · skills · plugins · proxy
Alias heredadosdaemon (servicio de puerta de enlace) · clawbot (espacio de nombres)
Complementos (opcional)path · voicecall (si está instalado)
MarcaPropósito
--devAislar el estado bajo ~/.openclaw-dev y cambiar los puertos predeterminados
--profile <name>Aislar el estado bajo ~/.openclaw-<name>
--container <name>Apuntar a un contenedor con nombre para su ejecución
--no-colorDeshabilitar colores ANSI (NO_COLOR=1 también se respeta)
--updateAbreviatura de openclaw update (solo instalaciones desde código fuente)
-V, --version, -vImprimir versión y salir
  • Los colores ANSI y los indicadores de progreso solo se muestran en sesiones TTY.
  • Los hipervínculos OSC-8 se representan como enlaces en los que se admiten; de lo contrario, la interfaz de línea de comandos (CLI) recurre a URL simples.
  • --json (y --plain donde se admite) desactiva el estilo para una salida limpia.
  • Los comandos de larga duración muestran un indicador de progreso (OSC 9;4 cuando se admite).

Fuente de verdad de la paleta: src/terminal/palette.ts.

Árbol de comandos completo
openclaw [--dev] [--profile

]

crestodian setup onboard configure config get set unset file schema validate completion doctor dashboard backup create verify security audit secrets reload audit configure apply reset uninstall update wizard status channels list status capabilities resolve logs add remove login logout directory self peers list groups list|members skills search install update list info check plugins list inspect install uninstall update enable disable doctor marketplace list memory status index search path resolve find set validate emit commitments list dismiss wiki status doctor init ingest compile lint search get apply bridge import unsafe-local import obsidian status|search|open|command|daily message send broadcast poll react reactions read edit delete pin unpin pins permissions search thread create|list|reply emoji list|upload sticker send|upload role info|add|remove channel info|list member info voice status event list|create timeout kick ban agent agents list add delete bindings bind unbind set-identity acp mcp serve list show set unset status health sessions cleanup tasks list audit maintenance show notify cancel flow list|show|cancel gateway call usage-cost health status probe discover install uninstall start stop restart run daemon status install uninstall start stop restart logs system event heartbeat last|enable|disable presence models list status set set-image aliases list|add|remove fallbacks list|add|remove|clear image-fallbacks list|add|remove|clear scan infer (alias: capability) list inspect model run|list|inspect|providers|auth login|logout|status image generate|edit|describe|describe-many|providers audio transcribe|providers tts convert|voices|providers|status|enable|disable|set-provider video generate|describe|providers web search|fetch|providers embedding create|providers auth add|login|login-github-copilot|setup-token|paste-token auth order get|set|clear sandbox list recreate explain cron status list get add edit rm enable disable runs run nodes status describe list pending approve reject rename invoke notify push canvas snapshot|present|hide|navigate|eval canvas a2ui push|reset camera list|snap|clip screen record location get devices list remove clear approve reject rotate revoke node run status install uninstall stop restart approvals get set allowlist add|remove exec-policy show preset set browser status start stop reset-profile tabs open focus close profiles create-profile delete-profile screenshot snapshot navigate resize click type press hover drag select upload fill dialog wait evaluate console pdf hooks list info check enable disable install update webhooks gmail setup|run proxy start run coverage sessions query blob purge pairing list approve qr clawbot qr docs dns setup tui chat (alias: tui —local) terminal (alias: tui —local)

Los complementos pueden agregar comandos de nivel superior adicionales (por ejemplo `openclaw voicecall`).

Los mensajes de chat admiten comandos /.... Consulte slash commands.

Aspectos destacados:

  • /status — diagnósticos rápidos.
  • /trace — líneas de seguimiento/depuración de complementos con alcance de sesión.
  • /config — cambios de configuración persistentes.
  • /debug — anulaciones de configuración solo en tiempo de ejecución (memoria, no disco; requiere commands.debug: true).

openclaw status --usage y la interfaz de usuario de Control muestran el uso/cuota del proveedor cuando hay credenciales de OAuth/API disponibles. Los datos provienen directamente de los puntos de conexión de uso del proveedor y se normalizan a X% left. Proveedores con ventanas de uso actuales: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi y z.ai.

Consulte Usage tracking para obtener más detalles.