Comandos de la CLI de OpenClaw: la hoja de referencia completa (2026)

OpenClaw se ha convertido rápidamente en una de las plataformas de agentes de IA de las que más se habla en 2026, y su interfaz de línea de comandos es donde reside la mayor parte de su poder. Ya sea que estés configurando tu primer agente, gestionando flujos de comunicación multicanal o automatizando tareas recurrentes, la CLI es tu principal superficie de control.

Esta guía cubre todos los comandos de la CLI de OpenClaw disponibles a abril de 2026, organizados por categoría, con desgloses completos de sintaxis, flags comunes y ejemplos prácticos. Guarda esta página en marcadores: volverás a ella a menudo.

Tabla de contenidos

1. Antes de empezar: instalación y requisitos previos
2. Comandos de configuración
3. Comandos de gestión de modelos
4. Comandos de canales
5. Comandos de skills
6. Comandos de chat y mensajería
7. Comandos de cron y programación
8. Comandos de configuración
9. Comandos de seguridad
10. Comandos de estado y registro
11. Tabla de hoja de referencia imprimible
12. Preguntas frecuentes

Antes de empezar: instalación y requisitos previos

Antes de sumergirte en los comandos, asegúrate de que OpenClaw esté instalado en tu sistema. La CLI requiere Node.js 20+ o puede instalarse como un binario independiente.

# Install via npm
npm install -g openclaw

# Or via Homebrew (macOS/Linux)
brew install openclaw

# Verify installation
openclaw --version

Una vez instalado, usarás el prefijo openclaw para cada comando. La sintaxis general sigue este patrón:

openclaw <category> <action> [options] [flags]

Flags globales disponibles en cada comando:

Para la documentación oficial completa, visita https://docs.openclaw.ai/cli.

Comandos de configuración

Los comandos de configuración gestionan la configuración inicial, las comprobaciones de salud del sistema y la gestión del gateway. Ejecútalos primero al instalar OpenClaw en una máquina nueva.

openclaw onboard

Ejecuta el asistente de incorporación interactivo que configura tu entorno de OpenClaw paso a paso.

Sintaxis:

openclaw onboard [flags]

Flags:

Ejemplo:

# Full interactive onboarding
openclaw onboard

# Onboarding with a specific provider
openclaw onboard --provider anthropic

# Non-interactive setup for automation
openclaw onboard --non-interactive --provider openai

El asistente de incorporación te guía por la introducción de la clave de API, la selección del modelo predeterminado y la configuración opcional de canales. Escribe sus resultados en ~/.openclaw/config.yaml.

openclaw doctor

Diagnostica tu instalación de OpenClaw e informa de cualquier problema con dependencias, conectividad o configuración.

Sintaxis:

openclaw doctor [flags]

Flags:

Ejemplo:

# Run full diagnostics
openclaw doctor

# Auto-fix issues
openclaw doctor --fix

# Check only model connectivity
openclaw doctor --check models

Salida de ejemplo:

[PASS] Node.js version: 22.4.0
[PASS] Config file: ~/.openclaw/config.yaml
[PASS] API key: anthropic (valid)
[WARN] Channel: email (not configured)
[PASS] Gateway: running on port 7654
[PASS] Skills directory: 3 skills installed

4 passed, 1 warning, 0 errors

openclaw gateway

Gestiona el servidor gateway local de OpenClaw, que maneja la comunicación entre procesos, la entrada de webhooks y la orquestación de skills.

Sintaxis:

openclaw gateway <action> [flags]

Acciones:

Flags:

Ejemplo:

# Start gateway in background
openclaw gateway start -d

# Start on a custom port
openclaw gateway start --port 8080

# Check if gateway is running
openclaw gateway status

# Restart with verbose logging
openclaw gateway restart --log-level debug

Comandos de gestión de modelos

Los comandos de modelos te permiten configurar qué modelos de lenguaje grande utiliza OpenClaw, comprobar su disponibilidad y gestionar las credenciales de los proveedores.

openclaw models status

Muestra el estado de todos los modelos configurados, incluido el proveedor, la disponibilidad y el predeterminado actual.

Sintaxis:

openclaw models status [flags]

Flags:

Ejemplo:

# Show all configured models
openclaw models status

# Show only Anthropic models
openclaw models status --provider anthropic

# Test connectivity
openclaw models status --ping

Salida de ejemplo:

PROVIDER       MODEL                    STATUS    DEFAULT
anthropic      claude-sonnet-4-20250514    online    *
anthropic      claude-opus-4-20250514       online
openai         gpt-4o                  online
openai         o3                      online
local          llama-3.3-70b           offline

openclaw models add

Añade un nuevo proveedor de modelos o modelo a tu configuración.

Sintaxis:

openclaw models add <provider> [flags]

Flags:

Ejemplo:

# Add Anthropic with API key
openclaw models add anthropic --key sk-ant-xxxx

# Add a specific OpenAI model as default
openclaw models add openai --key sk-xxxx --model gpt-4o --default

# Add a local model with custom endpoint
openclaw models add local --base-url http://localhost:11434 --model llama-3.3-70b

openclaw models remove

Elimina un proveedor de modelos o un modelo específico de tu configuración.

Sintaxis:

openclaw models remove <provider> [flags]

Flags:

Ejemplo:

# Remove an entire provider
openclaw models remove local

# Remove a specific model
openclaw models remove openai --model gpt-3.5-turbo

# Force removal without confirmation
openclaw models remove local --force

openclaw models default

Obtiene o establece el modelo predeterminado utilizado para las interacciones del agente.

Sintaxis:

openclaw models default [provider/model]

Ejemplo:

# Show current default
openclaw models default

# Set a new default
openclaw models default anthropic/claude-sonnet-4-20250514

openclaw models test

Ejecuta un prompt de prueba rápido contra un modelo especificado para verificar la conectividad y la calidad de la respuesta.

Sintaxis:

openclaw models test <provider/model> [flags]

Flags:

Ejemplo:

# Test default model
openclaw models test

# Test a specific model with custom prompt
openclaw models test anthropic/claude-sonnet-4-20250514 --prompt "What is 2+2?"

Comandos de canales

Los canales son el mecanismo de OpenClaw para la comunicación multiplataforma. Cada canal representa una plataforma de mensajería (correo electrónico, WhatsApp, Telegram, SMS, Slack) que el agente puede usar.

openclaw channels list

Lista todos los canales configurados y su estado actual.

Sintaxis:

openclaw channels list [flags]

Flags:

Ejemplo:

# List all channels
openclaw channels list

# List only active channels
openclaw channels list --status active

Salida de ejemplo:

CHANNEL       TYPE        STATUS    PROVIDER
personal      email       active    gmail
work-slack    slack       active    slack-api
whatsapp      whatsapp    active    twilio
sms-alerts    sms         inactive  inbounter

openclaw channels add

Añade un nuevo canal de comunicación.

Sintaxis:

openclaw channels add <type> [flags]

Tipos compatibles: email, sms, whatsapp, telegram, slack, discord, webhook

Flags:

Ejemplo:

# Add an email channel via Gmail
openclaw channels add email --name personal --provider gmail

# Add SMS via Inbounter
openclaw channels add sms --name alerts --provider inbounter --token ibnt_xxxx

# Add a WhatsApp channel via Twilio
openclaw channels add whatsapp --name support --provider twilio --token twl_xxxx

# Add a Telegram bot
openclaw channels add telegram --name my-bot --token bot_xxxx

Para canales de correo electrónico y SMS, Inbounter proporciona una API amigable para desarrolladores que se integra a la perfección con OpenClaw. La configuración de su canal lleva menos de dos minutos.

openclaw channels remove

Elimina un canal configurado.

Sintaxis:

openclaw channels remove <name> [flags]

Flags:

Ejemplo:

# Remove a channel
openclaw channels remove work-slack

# Force removal
openclaw channels remove old-email --force

openclaw channels test

Envía un mensaje de prueba a través de un canal para verificar que funciona.

Sintaxis:

openclaw channels test <name> [flags]

Flags:

Ejemplo:

# Test email channel
openclaw channels test personal --to you@example.com

# Test SMS with custom message
openclaw channels test sms-alerts --to +15551234567 --message "Test from OpenClaw"

Comandos de skills

Las skills son plugins instalables que amplían las capacidades de OpenClaw. Van desde la navegación web y la manipulación de archivos hasta herramientas de automatización específicas de un dominio.

openclaw skills install

Instala una skill desde el registro de skills de OpenClaw.

Sintaxis:

openclaw skills install <skill-name> [flags]

Flags:

Ejemplo:

# Install a skill
openclaw skills install web-browser

# Install a specific version
openclaw skills install file-manager --version 2.1.0

# Install from local development
openclaw skills install ./my-skill --dev

openclaw skills uninstall

Elimina una skill instalada.

Sintaxis:

openclaw skills uninstall <skill-name> [flags]

Flags:

Ejemplo:

# Uninstall a skill
openclaw skills uninstall web-browser

# Uninstall and remove all data
openclaw skills uninstall file-manager --purge

openclaw skills list

Lista todas las skills instaladas y su estado.

Sintaxis:

openclaw skills list [flags]

Flags:

Ejemplo:

# List all installed skills
openclaw skills list

# Show outdated skills
openclaw skills list --outdated

Salida de ejemplo:

SKILL              VERSION    STATUS     UPDATE
web-browser        1.4.2      enabled    -
file-manager       2.1.0      enabled    2.2.0
email-summarizer   1.0.1      disabled   -
calendar-sync      3.0.0      enabled    -

openclaw skills search

Busca skills disponibles en el registro de skills.

Sintaxis:

openclaw skills search <query> [flags]

Flags:

Ejemplo:

# Search for email-related skills
openclaw skills search email

# Search productivity skills sorted by downloads
openclaw skills search productivity --category automation --sort downloads

openclaw skills enable / openclaw skills disable

Activa o desactiva una skill sin desinstalarla.

Sintaxis:

openclaw skills enable <skill-name>
openclaw skills disable <skill-name>

Ejemplo:

# Disable a skill temporarily
openclaw skills disable email-summarizer

# Re-enable it later
openclaw skills enable email-summarizer

openclaw skills update

Actualiza una o todas las skills a sus versiones más recientes.

Sintaxis:

openclaw skills update [skill-name] [flags]

Flags:

Ejemplo:

# Update a specific skill
openclaw skills update web-browser

# Update all skills
openclaw skills update --all

Comandos de chat y mensajería

Estos comandos gestionan la interacción directa con el agente de IA y el envío de mensajes a través de los canales.

openclaw chat

Abre una sesión de chat interactiva con el agente en tu terminal.

Sintaxis:

openclaw chat [flags]

Flags:

Ejemplo:

# Start a chat session
openclaw chat

# Chat with a specific model
openclaw chat --model anthropic/claude-opus-4-20250514

# Chat with context from a file
openclaw chat --context ./project-notes.md

# Chat with responses also sent to Slack
openclaw chat --channel work-slack

openclaw send

Envía un único mensaje a través de un canal especificado sin iniciar una sesión interactiva.

Sintaxis:

openclaw send <channel> <message> [flags]

Flags:

Ejemplo:

# Send an email
openclaw send personal "Meeting notes attached" --to boss@company.com --subject "Q2 Planning" --attach ./notes.pdf

# Send an SMS
openclaw send sms-alerts "Server CPU at 95%" --to +15551234567

# Let AI compose and send
openclaw send personal --ai "Write a follow-up email to the client about the project delay" --to client@example.com

# Schedule a message
openclaw send work-slack "Reminder: standup in 15 minutes" --schedule "Mon-Fri 9:45am"

openclaw reply

Responde a un mensaje específico en un hilo de conversación.

Sintaxis:

openclaw reply <message-id> <message> [flags]

Flags:

Ejemplo:

# Reply to a message
openclaw reply msg_abc123 "Thanks, I'll review this today"

# AI-composed reply
openclaw reply msg_abc123 --ai "Write a polite decline"

Comandos de cron y programación

Los comandos de cron te permiten configurar tareas automatizadas recurrentes que el agente ejecuta según una programación.

openclaw cron add

Crea una nueva tarea programada.

Sintaxis:

openclaw cron add <schedule> <command> [flags]

Flags:

Ejemplo:

# Daily email digest at 8 AM
openclaw cron add "0 8 * * *" "Summarize my unread emails and send a digest" --name morning-digest --channel personal

# Weekly report every Friday at 5 PM
openclaw cron add "0 17 * * 5" "Generate weekly project status report" --name weekly-report --channel work-slack

# Hourly server health check
openclaw cron add "0 * * * *" "Check server status and alert if issues" --name health-check --channel sms-alerts

# Custom timezone
openclaw cron add "0 9 * * 1-5" "Good morning briefing" --timezone America/New_York --name morning-brief

openclaw cron list

Lista todas las tareas cron programadas.

Sintaxis:

openclaw cron list [flags]

Flags:

Ejemplo:

# List all cron jobs
openclaw cron list

# List only active jobs
openclaw cron list --active

Salida de ejemplo:

ID    NAME              SCHEDULE        NEXT RUN           STATUS
1     morning-digest    0 8 * * *       2026-04-06 08:00   active
2     weekly-report     0 17 * * 5      2026-04-11 17:00   active
3     health-check      0 * * * *       2026-04-05 14:00   active
4     old-task          0 12 * * *      -                  paused

openclaw cron remove

Elimina una tarea cron programada.

Sintaxis:

openclaw cron remove <id|name> [flags]

Flags:

Ejemplo:

# Remove by name
openclaw cron remove old-task

# Remove by ID
openclaw cron remove 4 --force

openclaw cron pause / openclaw cron resume

Pausa o reanuda una tarea cron sin eliminarla.

Sintaxis:

openclaw cron pause <id|name>
openclaw cron resume <id|name>

Ejemplo:

# Pause a job during vacation
openclaw cron pause morning-digest

# Resume when back
openclaw cron resume morning-digest

openclaw cron run

Activa manualmente una tarea cron de inmediato, fuera de su programación.

Sintaxis:

openclaw cron run <id|name> [flags]

Flags:

Ejemplo:

# Manually trigger the morning digest
openclaw cron run morning-digest

# Dry run to test
openclaw cron run health-check --dry-run

Comandos de configuración

Los comandos de configuración gestionan los ajustes de OpenClaw, almacenados en ~/.openclaw/config.yaml.

openclaw config get

Lee un valor de configuración.

Sintaxis:

openclaw config get <key>

Ejemplo:

# Get the default model
openclaw config get default_model

# Get the gateway port
openclaw config get gateway.port

# Get all config (dump)
openclaw config get .

openclaw config set

Establece un valor de configuración.

Sintaxis:

openclaw config set <key> <value> [flags]

Flags:

Ejemplo:

# Set default model
openclaw config set default_model anthropic/claude-sonnet-4-20250514

# Set gateway port
openclaw config set gateway.port 8080

# Set a project-local config
openclaw config set context_file ./CONTEXT.md --local

openclaw config reset

Restablece la configuración a los valores predeterminados.

Sintaxis:

openclaw config reset [key] [flags]

Flags:

Ejemplo:

# Reset a specific key
openclaw config reset gateway.port

# Reset everything
openclaw config reset --all --force

openclaw config edit

Abre el archivo de configuración en tu editor predeterminado.

Sintaxis:

openclaw config edit [flags]

Flags:

Ejemplo:

# Open in default editor
openclaw config edit

# Open in VS Code
openclaw config edit --editor code

Comandos de seguridad

Los comandos de seguridad te ayudan a auditar tu configuración de OpenClaw en busca de posibles vulnerabilidades y a gestionar los controles de acceso.

openclaw audit

Ejecuta una auditoría de seguridad de tu instalación de OpenClaw, comprobando credenciales expuestas, configuraciones inseguras y permisos de skills.

Sintaxis:

openclaw audit [flags]

Flags:

Ejemplo:

# Full audit
openclaw audit

# Audit only skills
openclaw audit --scope skills

# Strict audit with report
openclaw audit --strict --report ./audit-report.json

# Auto-fix issues
openclaw audit --fix

Salida de ejemplo:

[PASS] Config file permissions: 600
[PASS] API keys: encrypted at rest
[WARN] Skill 'web-browser': has network access (expected)
[FAIL] Channel 'old-webhook': token expired
[PASS] Gateway: TLS enabled
[PASS] No credentials in environment variables

3 passed, 1 warning, 1 failure

openclaw audit permissions

Revisa y gestiona los permisos de las skills.

Sintaxis:

openclaw audit permissions [skill-name]

Ejemplo:

# Review all skill permissions
openclaw audit permissions

# Review a specific skill
openclaw audit permissions web-browser

Comandos de estado y registro

Estos comandos te dan visibilidad sobre lo que OpenClaw está haciendo, lo que ha ocurrido y la salud del sistema.

openclaw status

Muestra el estado actual de todos los componentes de OpenClaw.

Sintaxis:

openclaw status [flags]

Flags:

Ejemplo:

# Full status overview
openclaw status

# Watch mode
openclaw status -w

# Check specific component
openclaw status --component gateway

Salida de ejemplo:

OpenClaw v2.4.1

Gateway:    running (port 7654, uptime 3d 14h)
Model:      anthropic/claude-sonnet-4-20250514 (online)
Channels:   4 active, 1 inactive
Skills:     3 enabled, 1 disabled
Cron Jobs:  3 active, 1 paused
Queue:      0 pending, 247 processed today
Memory:     42 MB RSS

openclaw logs

Muestra los registros operativos de OpenClaw.

Sintaxis:

openclaw logs [flags]

Flags:

Ejemplo:

# Show last 50 log lines
openclaw logs -n 50

# Stream logs in real time
openclaw logs -f

# Show only errors from the last hour
openclaw logs --level error --since 1h

# Search for specific events
openclaw logs --search "channel:email" --since 24h

# Filter by component
openclaw logs --component gateway -f

openclaw logs export

Exporta los registros a un archivo para compartirlos o analizarlos.

Sintaxis:

openclaw logs export <file> [flags]

Flags:

Ejemplo:

# Export last 24h of logs as JSON
openclaw logs export ./logs.json --format json --since 24h

# Export error logs for a date range
openclaw logs export ./errors.csv --format csv --level error --since 2026-04-01 --until 2026-04-05

Comandos de utilidad adicionales

Algunos comandos más que vale la pena conocer.

openclaw upgrade

Actualiza OpenClaw a la última versión.

Sintaxis:

openclaw upgrade [flags]

Flags:

Ejemplo:

# Check for updates
openclaw upgrade --check

# Upgrade to latest
openclaw upgrade

openclaw reset

Restablece partes o la totalidad de la instalación de OpenClaw.

Sintaxis:

openclaw reset [scope] [flags]

Alcances: config, channels, skills, cron, all

Ejemplo:

# Reset only channels
openclaw reset channels

# Full factory reset
openclaw reset all --force

openclaw completions

Genera scripts de autocompletado para la shell.

Sintaxis:

openclaw completions <shell>

Shells compatibles: bash, zsh, fish, powershell

Ejemplo:

# Generate zsh completions
openclaw completions zsh > ~/.zsh/completions/_openclaw

# Generate bash completions
openclaw completions bash >> ~/.bashrc

Tabla de hoja de referencia imprimible

Aquí tienes todos los comandos en una sola tabla. Imprímela o tenla en un segundo monitor.

Preguntas frecuentes

¿Cómo actualizo OpenClaw a la última versión?

Ejecuta openclaw upgrade. Usa primero openclaw upgrade --check para ver qué versión está disponible sin instalarla.

¿Dónde se almacena el archivo de configuración de OpenClaw?

La configuración global vive en ~/.openclaw/config.yaml. Las configuraciones locales del proyecto se almacenan en .openclaw/config.yaml en la raíz de tu proyecto.

¿Puedo usar varios proveedores de LLM al mismo tiempo?

Sí. Añade tantos proveedores como quieras con openclaw models add. Cada modelo se identifica mediante provider/model-name. Establece tu predeterminado preferido con openclaw models default.

¿Cómo añado capacidades de correo electrónico o SMS?

Usa openclaw channels add email o openclaw channels add sms. Para un enfoque fiable y orientado a la API, Inbounter proporciona API de correo electrónico y SMS diseñadas para la integración con agentes de IA y que funcionan a la perfección con el sistema de canales de OpenClaw.

¿Puedo ejecutar OpenClaw sin el gateway?

Algunos comandos básicos como openclaw chat funcionan sin el gateway, pero los canales, las tareas cron y las skills requieren que el gateway esté en ejecución. Inícialo con openclaw gateway start -d.

¿Cómo depuro una tarea cron que falla?

Usa openclaw cron run <name> --dry-run para probar la tarea sin ejecutarla, luego revisa openclaw logs --search "cron:<name>" para ver los detalles del error.

¿Es seguro usar OpenClaw con claves de API?

Ejecuta openclaw audit para verificar tu configuración. Las claves de API se cifran en reposo, y el comando de auditoría comprueba errores de configuración comunes como credenciales expuestas o permisos de archivo demasiado permisivos.

¿Cómo contribuyo con una skill personalizada?

Crea tu skill siguiendo el SDK de skills de OpenClaw, pruébala localmente con openclaw skills install ./my-skill --dev y envíala al registro a través del portal de la comunidad de OpenClaw.

Para terminar

Esta hoja de referencia cubre todos los comandos de la CLI de OpenClaw disponibles a abril de 2026. La CLI es la forma más rápida de configurar, automatizar e interactuar con tu agente de OpenClaw, y conocer estos comandos te ahorrará mucho tiempo a medida que construyas flujos de trabajo más sofisticados.

Para las últimas actualizaciones y nuevos comandos, consulta la documentación oficial de OpenClaw o ejecuta openclaw --help en cualquier momento.

Si estás creando agentes de IA que necesitan una entrega fiable de correo electrónico y SMS, echa un vistazo a la API de correo electrónico y SMS de Inbounter: está creada específicamente para la mensajería programática y de alto volumen que requieren los agentes de IA.

Artículos relacionados:

• OpenClaw vs Claude Code: ¿qué agente de IA deberías usar?
• OpenClaw vs Cursor: agente de IA vs IDE con IA
• Las 10 mejores alternativas a OpenClaw en 2026