Comandos de OpenClaw

Comandos completos de OpenClaw para gestionar tu agente personal de IA a través de múltiples canales de mensajería y plataformas.

Instalación

Plataforma	Comando
macOS/Linux	curl -fsSL https://openclaw.ai/install.sh | bash
npm (global)	npm install -g openclaw
Actualizar	openclaw update
Verificar	openclaw --version

Configuración inicial e incorporación

Comando	Descripción
openclaw onboard	Asistente interactivo de configuración para gateway, workspace, canales y habilidades
openclaw onboard --install-daemon	Configurar e instalar el gateway como servicio en segundo plano
openclaw onboard --flow quickstart	Configuración rápida con valores predeterminados razonables
openclaw onboard --flow advanced	Configuración completa con todas las opciones
openclaw onboard --non-interactive	Configuración sin interfaz (requiere flags explícitos)
openclaw setup --workspace ~/my-agent	Inicializar configuración y directorio de workspace
openclaw configure	Asistente interactivo para modelos, canales, habilidades y gateway
openclaw doctor	Verificaciones de estado y correcciones rápidas para configuración y gateway
openclaw doctor --deep	Escaneo profundo incluyendo servicios del sistema
openclaw reset --scope config	Restablecer solo la configuración
openclaw reset --scope full --yes	Restablecimiento completo de configuración, credenciales y sesiones

Configuración

Comando	Descripción
openclaw config get <path>	Mostrar un valor de configuración
openclaw config set <path> <value>	Establecer un valor de configuración (JSON5 o cadena)
openclaw config unset <path>	Eliminar un valor de configuración
openclaw configure	Iniciar el asistente interactivo de configuración

Variables de entorno

Variable	Propósito
OPENCLAW_HOME	Sobrescribir directorio home predeterminado
OPENCLAW_STATE_DIR	Directorio de estado personalizado
OPENCLAW_CONFIG_PATH	Ruta personalizada del archivo de configuración

Gestión del Gateway

Comando	Descripción
openclaw gateway run	Ejecutar el Gateway WebSocket en primer plano
openclaw gateway run --port 18789	Ejecutar el gateway en un puerto específico
openclaw gateway run --bind lan	Vincular a la interfaz LAN
openclaw gateway run --bind tailnet	Vincular vía Tailscale
openclaw gateway status	Verificar el estado del gateway vía RPC
openclaw gateway health	Obtener estado de salud del gateway en ejecución
openclaw gateway install	Instalar el gateway como servicio del sistema
openclaw gateway start	Iniciar el servicio instalado
openclaw gateway stop	Detener el servicio en ejecución
openclaw gateway restart	Reiniciar el servicio
openclaw gateway uninstall	Eliminar el servicio
openclaw gateway discover	Descubrir gateways en la red
openclaw logs --follow	Seguir los registros del gateway en tiempo real
openclaw logs --limit 100 --json	Últimas 100 entradas del registro en formato JSON

Gestión de canales

Comando	Descripción
openclaw channels list	Mostrar todos los canales configurados y perfiles de autenticación
openclaw channels status	Verificar accesibilidad del gateway y estado de los canales
openclaw channels add --channel telegram	Agregar canal de Telegram
openclaw channels add --channel whatsapp	Agregar canal de WhatsApp
openclaw channels add --channel discord	Agregar canal de Discord
openclaw channels add --channel slack	Agregar canal de Slack
openclaw channels add --channel signal	Agregar canal de Signal
openclaw channels add --channel imessage	Agregar canal de iMessage
openclaw channels add --channel msteams	Agregar canal de Microsoft Teams
openclaw channels remove --channel telegram	Eliminar un canal
openclaw channels login --channel discord	Inicio de sesión interactivo en un canal
openclaw channels logout --channel telegram	Cerrar sesión en un canal
openclaw channels logs --channel whatsapp	Mostrar registros recientes del canal

Mensajería

Comando	Descripción
openclaw message send --text "Hello"	Enviar un mensaje
openclaw message send --to user123 --text "Hi"	Enviar a un destinatario específico
openclaw message poll	Consultar mensajes nuevos
openclaw message read	Marcar mensajes como leídos
openclaw message edit --text "Updated"	Editar un mensaje enviado
openclaw message delete	Eliminar un mensaje
openclaw message react --emoji "👍"	Reaccionar a un mensaje
openclaw message reactions	Listar reacciones de un mensaje
openclaw message search --text "query"	Buscar mensajes
openclaw message pin	Fijar un mensaje
openclaw message unpin	Desfijar un mensaje
openclaw message pins	Listar mensajes fijados
openclaw message thread create	Crear un hilo de mensajes
openclaw message thread list	Listar hilos
openclaw message thread reply	Responder en un hilo

Gestión de agentes

Comando	Descripción
openclaw agent --message "Research this topic"	Ejecutar un turno del agente vía gateway
openclaw agent --message "Hello" --thinking high	Turno del agente con pensamiento extendido
openclaw agent --message "task" --local	Ejecutar agente localmente (embebido)
openclaw agent --message "task" --deliver	Entregar respuesta al canal
openclaw agents list	Listar agentes configurados
openclaw agents add myagent --workspace ~/work	Agregar agente aislado con workspace
openclaw agents add myagent --model claude-sonnet	Agregar agente con modelo específico
openclaw agents delete myagent --force	Eliminar un agente

Configuración de modelos

Comando	Descripción
openclaw models list	Listar modelos disponibles
openclaw models list --all	Listar todos los modelos incluyendo no disponibles
openclaw models list --local	Listar solo modelos locales
openclaw models list --provider anthropic	Filtrar por proveedor
openclaw models status	Mostrar estado de tokens y autenticación
openclaw models status --probe	Verificar perfiles de autenticación en vivo
openclaw models set claude-sonnet	Establecer modelo principal
openclaw models set-image dall-e-3	Establecer modelo principal de imágenes
openclaw models scan	Escanear y descubrir modelos disponibles
openclaw models auth add	Asistente interactivo de autenticación
openclaw models auth setup-token --provider openai	Configurar token del proveedor
openclaw models fallbacks add gpt-4o	Agregar modelo de respaldo
openclaw models fallbacks list	Listar modelos de respaldo
openclaw models aliases add sonnet claude-sonnet	Crear alias de modelo

Control del navegador

Comando	Descripción
openclaw browser start	Iniciar navegador controlado
openclaw browser stop	Cerrar navegador
openclaw browser status	Verificar estado del navegador
openclaw browser open "https://example.com"	Abrir URL en el navegador
openclaw browser tabs	Listar pestañas abiertas
openclaw browser focus <targetId>	Enfocar una pestaña específica
openclaw browser close <targetId>	Cerrar una pestaña específica
openclaw browser screenshot	Captura de pantalla del viewport
openclaw browser screenshot --full-page	Captura de página completa
openclaw browser snapshot --format aria	Obtener árbol de accesibilidad
openclaw browser navigate "https://url"	Navegar a una URL
openclaw browser click <ref>	Hacer clic en un elemento
openclaw browser type <ref> "text"	Escribir texto en un elemento
openclaw browser press Enter	Presionar una tecla del teclado
openclaw browser evaluate --fn "document.title"	Ejecutar JavaScript
openclaw browser pdf	Generar PDF de la página actual
openclaw browser profiles	Listar perfiles del navegador
openclaw browser create-profile --name work	Crear perfil del navegador

Gestión de nodos

Comando	Descripción
openclaw node run --host gateway.local --port 18789	Ejecutar nodo sin interfaz gráfica
openclaw node install --host gw.local	Instalar nodo como servicio
openclaw node status	Verificar estado del nodo
openclaw nodes list	Listar todos los nodos
openclaw nodes status --connected	Mostrar solo nodos conectados
openclaw nodes pending	Mostrar solicitudes de aprobación pendientes
openclaw nodes approve <requestId>	Aprobar solicitud de nodo
openclaw nodes run --node mypc "ls -la"	Ejecutar comando en nodo remoto
openclaw nodes camera snap --node phone	Capturar imagen de la cámara
openclaw nodes screen record --node desktop	Grabar pantalla
openclaw nodes location get --node mobile	Obtener ubicación del dispositivo

Tareas programadas (Cron)

Comando	Descripción
openclaw cron list	Listar todas las tareas programadas
openclaw cron status	Mostrar estado del sistema cron
openclaw cron add --name "Daily report" --every 24h --message "Generate daily report"	Agregar tarea recurrente
openclaw cron add --name "Morning brief" --at "08:00" --message "Brief me"	Agregar tarea basada en horario
openclaw cron add --name "Backup" --cron "0 2 * * *" --system-event "run backup"	Agregar tarea con expresión cron
openclaw cron enable <id>	Habilitar una tarea
openclaw cron disable <id>	Deshabilitar una tarea
openclaw cron run <id>	Ejecutar tarea inmediatamente
openclaw cron runs --id <id>	Mostrar historial de ejecuciones
openclaw cron edit <id>	Modificar tarea existente
openclaw cron rm <id>	Eliminar una tarea

Plugins y habilidades

Comando	Descripción
openclaw plugins list	Descubrir plugins disponibles
openclaw plugins info <id>	Mostrar detalles del plugin
openclaw plugins install <path>	Instalar plugin desde ruta o npm
openclaw plugins enable <id>	Habilitar un plugin
openclaw plugins disable <id>	Deshabilitar un plugin
openclaw plugins doctor	Reportar errores de carga de plugins
openclaw skills list	Listar habilidades disponibles
openclaw skills list --eligible	Mostrar solo habilidades listas
openclaw skills info <name>	Mostrar detalles de habilidad
openclaw skills check	Resumen de preparación de todas las habilidades

Seguridad y aprobaciones

Comando	Descripción
openclaw security audit	Auditar configuración y estado local
openclaw security audit --deep	Verificación de seguridad en vivo del gateway
openclaw security audit --fix	Auto-ajustar valores predeterminados seguros
openclaw approvals get	Ver configuración actual de aprobaciones
openclaw approvals set	Configurar flujos de aprobación
openclaw approvals allowlist add	Agregar a la lista de permitidos
openclaw pairing list telegram	Listar solicitudes de emparejamiento pendientes
openclaw pairing approve telegram <code>	Aprobar emparejamiento de DM

Memoria y sesiones

Comando	Descripción
openclaw memory status	Mostrar estadísticas del índice de memoria
openclaw memory index	Reindexar archivos de memoria
openclaw memory search "query"	Búsqueda semántica sobre la memoria
openclaw sessions	Listar sesiones de conversación almacenadas
openclaw sessions --active 60	Mostrar sesiones activas en los últimos 60 min
openclaw status	Mostrar estado de la sesión vinculada
openclaw status --all --deep	Diagnóstico completo con verificación de canales

Casos de uso comunes

Configuración rápida con Telegram

# Instalar e incorporar
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

# Agregar canal de Telegram
openclaw channels add --channel telegram

# Verificar que todo funcione
openclaw doctor
openclaw status --all

Ejecutar agente con modelo personalizado

# Establecer modelo preferido
openclaw models set claude-sonnet

# Agregar respaldo
openclaw models fallbacks add gpt-4o

# Ejecutar turno del agente
openclaw agent --message "Summarize my emails" --thinking high

Programar reportes diarios

# Crear tarea diaria a las 8 AM
openclaw cron add \
  --name "Morning briefing" \
  --at "08:00" \
  --message "Give me a summary of today's tasks and any urgent notifications"

# Verificar que esté programada
openclaw cron list

Control remoto de nodos

# Listar nodos conectados
openclaw nodes status --connected

# Ejecutar comando en máquina remota
openclaw nodes run --node "desktop" "df -h"

# Tomar captura de pantalla remota
openclaw nodes screen record --node "desktop" --duration 5s

Mejores prácticas

• Usa --install-daemon durante la incorporación para ejecutar el gateway como servicio en segundo plano
• Ejecuta openclaw doctor regularmente para detectar problemas de configuración temprano
• Configura modelos de respaldo para asegurar disponibilidad cuando el modelo principal tenga límite de uso
• Usa --thinking high para tareas complejas del agente que requieren razonamiento profundo
• Crea perfiles del navegador para aislar contextos de navegación para diferentes tareas
• Usa el flag --json al crear scripts o dirigir la salida a otras herramientas
• Ejecuta auditorías de seguridad con el flag --deep antes de exponer el gateway a la red

Solución de problemas

Problema	Solución
El gateway no inicia	Ejecuta openclaw doctor --deep para diagnosticar
Canal desconectado	Verifica con openclaw channels status y vuelve a iniciar sesión
Falló la autenticación del modelo	Ejecuta openclaw models status --probe para probar tokens
Error al cargar plugin	Ejecuta openclaw plugins doctor para diagnósticos
El nodo no se conecta	Verifica con openclaw nodes pending y aprueba si es necesario
Respuestas lentas	Verifica openclaw status --usage para límites de uso
Configuración corrupta	Usa openclaw reset --scope config para restablecer de forma segura