Los comandos esenciales de OpenClaw
Qué cubre este artículo sobre comandos de OpenClaw
- Los comandos principales para comenzar con OpenClaw.
- Configuración inicial, incorporación y setup básico.
- Modelos, Gateway, Agentes y Sesiones.
- Seguridad, diagnóstico y mantenimiento.
- Ejemplos breves para el uso diario.
Introducción: Los comandos esenciales de OpenClaw
OpenClaw se controla a través de la línea de comandos. Dominar los comandos principales te permite configurar la herramienta más rápidamente, acotar errores y trabajar de forma más eficiente en producción. Este artículo reúne los comandos que necesitarás con mayor frecuencia durante la instalación, configuración y operación continua.
Todos los comandos se invocan con openclaw <comando>. Para obtener una vista general de todas las opciones disponibles, usa openclaw --help o openclaw <comando> --help.
Términos importantes
- CLI: Command Line Interface, la interfaz de línea de comandos.
- Gateway: Interfaz de red de OpenClaw.
- Agent: Instancia que ejecuta tareas.
- Channel: Conexión a un servicio o mensajería.
- Skill: Capacidad preconfigurada para el agente.
- Plugin: Extensión para OpenClaw.
- Session: Conversación o tarea en curso.
Setup e Incorporación
| Comando | Propósito |
|---|
openclaw o openclaw setup | Inicia el asistente de configuración. |
openclaw onboard | Incorporación interactiva. |
openclaw onboard --classic | Incorporación clásica. |
openclaw onboard --non-interactive | Incorporación automatizada. |
openclaw configure | Modifica la configuración. |
openclaw config | Abre la interfaz de configuración. |
openclaw config file | Muestra la ruta de la configuración activa. |
Configuración
| Comando | Propósito |
|---|
openclaw config get <ruta> | Lee un valor de la configuración. |
openclaw config set <ruta> <valor> | Establece un valor. |
openclaw config unset <ruta> | Elimina un valor. |
openclaw config schema | Muestra el esquema JSON de la configuración. |
openclaw config validate | Valida la configuración. |
Ejemplo:
openclaw config set models.default.primary "anthropic/claude-opus-4-8"
openclaw config set models.default.fallbacks '["ollama/llama3.1:8b"]'
Modelos
| Comando | Propósito |
|---|
openclaw models list | Lista los modelos disponibles. |
openclaw models list --provider anthropic | Filtra modelos de un proveedor. |
openclaw models list --provider ollama | Muestra modelos de Ollama. |
openclaw models status | Verifica el estado de los modelos. |
openclaw models set <nombre> | Establece el modelo predeterminado. |
openclaw models fallbacks list | Lista los fallbacks. |
openclaw models fallbacks add <nombre> | Añade un fallback. |
Gateway
| Comando | Propósito |
|---|
openclaw gateway install | Instala Gateway como servicio. |
openclaw gateway start | Inicia el Gateway. |
openclaw gateway stop | Detiene el Gateway. |
openclaw gateway restart | Reinicia el Gateway. |
openclaw gateway status | Verifica el estado del Gateway. |
openclaw gateway health | Realiza una verificación de salud. |
openclaw gateway call <acción> | Invoca una acción del Gateway. |
Agentes y Sesiones
| Comando | Propósito |
|---|
openclaw agent | Inicia un agente. |
openclaw agents list | Lista los agentes. |
openclaw agents add <nombre> | Añade un agente. |
openclaw agents delete <nombre> | Elimina un agente. |
openclaw sessions | Muestra las sesiones activas. |
openclaw message | Envía un mensaje al agente. |
Seguridad
| Comando | Propósito |
|---|
openclaw security audit | Ejecuta una auditoría de seguridad. |
openclaw security audit --deep | Auditoría de seguridad profunda. |
openclaw security audit --fix | Soluciona problemas encontrados. |
openclaw security audit --json | Salida de auditoría en JSON. |
openclaw secrets reload | Recarga los secretos. |
openclaw secrets audit | Verifica los secretos. |
Diagnóstico y Mantenimiento
| Comando | Propósito |
|---|
openclaw doctor | Verificación de salud. |
openclaw doctor --fix | Reparaciones automáticas. |
openclaw doctor --lint | Verificación estructurada. |
openclaw doctor --lint --json | Lint en formato JSON. |
openclaw doctor --deep | Verificación profunda. |
openclaw status | Estado general. |
openclaw health | Verificación de salud. |
Backup y Actualización
| Comando | Propósito |
|---|
openclaw backup create | Crea una copia de seguridad. |
openclaw backup verify | Verifica la copia de seguridad. |
openclaw update | Actualiza OpenClaw. |
openclaw update status | Verifica el estado de la actualización. |
openclaw update repair | Repara la instalación. |
Plugins y Skills
| Comando | Propósito |
|---|
openclaw plugins list | Lista los plugins instalados. |
openclaw plugins install <nombre> | Instala un plugin. |
openclaw plugins uninstall <nombre> | Desinstala un plugin. |
openclaw skills list | Lista los skills disponibles. |
openclaw skills install <nombre> | Instala un skill. |
Logs y Sistema
| Comando | Propósito |
|---|
openclaw logs | Muestra los logs. |
openclaw system event | Muestra eventos del sistema. |
openclaw dashboard | Abre el dashboard web. |
Secuencias de comandos frecuentes
Después de la instalación
openclaw --version
openclaw doctor
openclaw config file
openclaw config validate
Conectar Ollama
openclaw config set models.providers.ollama.apiKey "ollama-local"
openclaw config set models.providers.ollama.baseUrl "http://127.0.0.1:11434"
openclaw models list --provider ollama
Iniciar y verificar el Gateway
openclaw gateway install
openclaw gateway start
openclaw gateway status
openclaw gateway health
Verificar seguridad
openclaw security audit
openclaw security audit --deep
openclaw doctor --fix
Errores comunes
- Comando no encontrado: Verifica la ruta, ejecuta
which openclaw.
- Gateway no inicia: Valida la configuración, usa
openclaw doctor.
- Modelo no visible: Comprueba la configuración del proveedor y las claves API.
- Auditoría de seguridad bloqueada: Proporciona
--password o --token para auditoría profunda.
- Cambios de configuración sin efecto: Reinicia el Gateway o el servicio.
Enlaces y recursos adicionales
FAQ: Comandos de OpenClaw
¿Dónde encuentro una lista completa?
Con openclaw --help y openclaw <comando> --help.
¿Cuál es la diferencia entre doctor y security audit?
doctor verifica la salud y configuración, security audit se enfoca en seguridad.
¿Puedo usar OpenClaw completamente sin interacción?
Sí, con --non-interactive y --yes en muchos comandos.
¿Cómo inicio el Gateway?
Con openclaw gateway start o a través del servicio systemd.
¿Dónde están los logs?
En openclaw logs o journalctl -u openclaw.
Fuentes y lecturas adicionales
Resumen: Los comandos esenciales de OpenClaw
OpenClaw proporciona una CLI completa para setup, configuración, modelos, Gateway, seguridad y mantenimiento. Los comandos más importantes son onboard, config, models, gateway, doctor, security audit y logs. Dominar estos comandos te permite configurar OpenClaw, establecer conexiones, monitorear y resolver problemas rápidamente. Para setups automatizados, utiliza --non-interactive y --fix.
