Actualizado: junio de 2026 · Apéndice AUpdated: June 2026 · Appendix A
Cheatsheet de comandosCommand cheatsheet
Referencia rápida para instalar, diagnosticar y recuperar tu entorno cuando algo falla.A quick reference for installing, diagnosing, and recovering your environment when something breaks.
Qué cubreWhat this covers
Comandos esenciales de OpenClaw, Gateway, Docker, terminal, logs, firewall, diagnóstico y recuperación.Essential OpenClaw, Gateway, Docker, terminal, log, firewall, diagnostic, and recovery commands.
Uso seguroSafe use
Copia solo lo que entiendas. Adapta rutas y revisa backups antes de ejecutar comandos que borren, muevan, abran puertos, cambien permisos o toquen secretos.Copy only what you understand. Adapt paths and review backups before running commands that delete, move, open ports, change permissions, or touch secrets.
Busca por problema, no por memoriaSearch by problem, not by memory
Escribe lo que estás intentando resolver: docker logs, disco lleno, gateway, ssh, api key u openclaw doctor. El buscador solo compara texto en esta página; no ejecuta nada.Type what you are trying to solve: docker logs, disk full, gateway, ssh, api key, or openclaw doctor. Search only compares text on this page; it never runs anything.
25 comandos listos para copiar con revisión humana.25 commands ready to copy with human review.
OpenClawOpenClaw
Instalar, verificar y diagnosticar la CLI y el Gateway.Install, verify, and diagnose the CLI and Gateway.
SEGUROSAFE
Instalar OpenClaw y comprobar versiónInstall OpenClaw and check the version
Qué haceWhat it does
Instala la CLI global, abre el asistente inicial y confirma qué versión tienes disponible.Installs the global CLI, opens the initial assistant, and confirms which version is available.
Cuándo usarloWhen to use it
Necesito instalar OpenClaw desde cero.I need to install OpenClaw from scratch.
Antes de ejecutarBefore running
Ejecuta esto en tu máquina o VPS con Node/npm funcionando. Si npm falla, revisa primero Node.Run this on your machine or VPS with Node/npm working. If npm fails, check Node first.
Configurar OpenClaw como servicio en VPSConfigure OpenClaw as a VPS service
Qué haceWhat it does
Lanza el onboarding preparado para instalar el daemon systemd en un servidor.Launches onboarding prepared to install the systemd daemon on a server.
Cuándo usarloWhen to use it
Quiero que OpenClaw quede funcionando como servicio.I want OpenClaw to keep running as a service.
Antes de ejecutarBefore running
Úsalo solo en tu VPS. Ten claro el usuario con el que instalas OpenClaw y guarda tus credenciales fuera de capturas o commits.Use this only on your VPS. Know which user installs OpenClaw and keep credentials out of screenshots and commits.
terminal
openclaw onboard --install-daemon
openclaw gateway status
PRECAUCIÓNCAUTION
Arrancar, parar o reiniciar el GatewayStart, stop, or restart the Gateway
Qué haceWhat it does
Gestiona el servicio principal de OpenClaw y revisa si queda activo.Manages OpenClaw’s main service and checks whether it stays active.
Cuándo usarloWhen to use it
El Gateway no responde o acabo de cambiar configuración crítica.The Gateway is not responding, or I just changed critical configuration.
Antes de ejecutarBefore running
Si hay tareas en curso, espera a que terminen. Reiniciar corta sesiones activas durante unos segundos.If tasks are running, wait for them to finish. Restarting interrupts active sessions for a few seconds.
terminal
openclaw gateway status
openclaw gateway restart
openclaw gateway status
PRECAUCIÓNCAUTION
Diagnóstico general con openclaw doctorGeneral diagnostics with openclaw doctor
Qué haceWhat it does
Revisa configuración, providers, puertos, permisos y estado general del entorno OpenClaw.Reviews configuration, providers, ports, permissions, and overall OpenClaw environment state.
Cuándo usarloWhen to use it
Algo falla y no sé por dónde empezar.Something is failing and I do not know where to start.
Antes de ejecutarBefore running
Copia la salida para analizarla, pero borra tokens, emails internos, rutas sensibles y secretos antes de compartirla.Copy the output for analysis, but remove tokens, internal emails, sensitive paths, and secrets before sharing it.
terminal
openclaw doctor
openclaw configure
SEGUROSAFE
Listar agentes y canales vinculadosList agents and linked channels
Qué haceWhat it does
Muestra agentes configurados y bindings de canales para revisar el mapa operativo.Shows configured agents and channel bindings so you can review the operating map.
Cuándo usarloWhen to use it
Quiero ver qué agentes existen y dónde están conectados.I want to see which agents exist and where they are connected.
Antes de ejecutarBefore running
Es un comando de lectura. Úsalo antes de borrar o recrear agentes.This is read-only. Use it before deleting or recreating agents.
terminal
openclaw agents list --bindings
openclaw channels status
PELIGROSODANGEROUS
Eliminar un sub-agenteDelete a sub-agent
Qué haceWhat it does
Borra un sub-agente por nombre. Es una acción mutante y conviene revisar antes los bindings.Deletes a sub-agent by name. This changes state, so review bindings first.
Cuándo usarloWhen to use it
Necesito borrar un agente que ya no uso.I need to delete an agent I no longer use.
Antes de ejecutarBefore running
Sustituye NOMBRE_AGENTE. Lista agentes antes y confirma que no depende de tareas o canales activos.Replace NOMBRE_AGENTE. List agents first and confirm it does not depend on active tasks or channels.
Placeholders:NOMBRE_AGENTE
Aviso: este comando puede borrar datos, cambiar permisos, abrir puertos, tocar secretos, matar procesos o modificar tareas. Revisa backups y entorno antes de copiarlo.Warning: this command can delete data, change permissions, open ports, touch secrets, kill processes, or modify tasks. Review backups and environment before copying it.
terminal
openclaw agents list --bindings
openclaw agents delete NOMBRE_AGENTE
PELIGROSODANGEROUS
Añadir canal de TelegramAdd a Telegram channel
Qué haceWhat it does
Registra un canal de Telegram usando un token de bot.Registers a Telegram channel with a bot token.
Cuándo usarloWhen to use it
Quiero conectar OpenClaw con Telegram.I want to connect OpenClaw to Telegram.
Antes de ejecutarBefore running
Sustituye TU_TOKEN_AQUI en tu terminal local. No pegues tokens reales en chats, issues, capturas, logs ni commits.Replace TU_TOKEN_AQUI in your local terminal. Do not paste real tokens in chats, issues, screenshots, logs, or commits.
Placeholders:TU_TOKEN_AQUI
Aviso: este comando puede borrar datos, cambiar permisos, abrir puertos, tocar secretos, matar procesos o modificar tareas. Revisa backups y entorno antes de copiarlo.Warning: this command can delete data, change permissions, open ports, touch secrets, kill processes, or modify tasks. Review backups and environment before copying it.
terminal
openclaw channels add --channel telegram --token "TU_TOKEN_AQUI"
openclaw channels status
PRECAUCIÓNCAUTION
Revisar skills con ClawHubReview skills with ClawHub
Qué haceWhat it does
Lista skills y revisa opciones disponibles desde ClawHub.Lists skills and reviews available options from ClawHub.
Cuándo usarloWhen to use it
Quiero ver o actualizar skills disponibles.I want to see or update available skills.
Antes de ejecutarBefore running
Si un comando cambia en tu versión, ejecuta la ayuda del propio comando antes de instalar nada.If a command changed in your version, run the command help before installing anything.
terminal
clawhub --help
clawhub list
clawhub update
DockerDocker
Levantar servicios, revisar estado, logs y consumo de disco.Start services, review status, inspect logs, and measure disk use.
SEGUROSAFE
Levantar el stack DockerStart the Docker stack
Qué haceWhat it does
Arranca los servicios en segundo plano y comprueba que quedan vivos.Starts services in the background and confirms they stay alive.
Cuándo usarloWhen to use it
Tengo un docker-compose.yml y quiero arrancar servicios.I have a docker-compose.yml and want to start services.
Antes de ejecutarBefore running
Entra antes en la carpeta donde vive tu docker-compose.yml.First enter the folder where your docker-compose.yml lives.
terminal
docker compose up -d
docker compose ps
SEGUROSAFE
Ver logs del stack DockerView Docker stack logs
Qué haceWhat it does
Muestra logs en directo del stack completo o de un servicio concreto.Shows live logs for the whole stack or a specific service.
Cuándo usarloWhen to use it
Un servicio falla y necesito ver qué está pasando.A service is failing and I need to see what is happening.
Antes de ejecutarBefore running
Ejecuta desde la carpeta del stack. Para salir del seguimiento en directo usa Ctrl+C.Run this from the stack folder. Use Ctrl+C to leave live follow mode.
Lista contenedores, muestra logs de uno concreto y abre una shell interactiva.Lists containers, shows logs for a specific one, and opens an interactive shell.
Cuándo usarloWhen to use it
Necesito saber qué contenedores existen y entrar en uno.I need to know which containers exist and enter one.
Antes de ejecutarBefore running
Sustituye NOMBRE_CONTENEDOR. Entrar en un contenedor es útil para diagnosticar, pero evita editar datos a mano si no sabes qué toca.Replace NOMBRE_CONTENEDOR. Entering a container helps diagnosis, but avoid editing data by hand unless you know what it affects.
Medir espacio ocupado por DockerMeasure Docker disk usage
Qué haceWhat it does
Mide el uso de Docker antes de borrar nada.Measures Docker usage before deleting anything.
Cuándo usarloWhen to use it
El servidor se está quedando sin disco.The server is running out of disk.
Antes de ejecutarBefore running
Empieza siempre midiendo. No limpies volúmenes si no sabes qué datos guardan.Always start by measuring. Do not clean volumes if you do not know what data they hold.
terminal
docker system df
docker volume ls
df -h
du -h --max-depth=1 . | sort -h
PELIGROSODANGEROUS
Limpiar imágenes y recursos no usadosClean unused images and resources
Qué haceWhat it does
Limpia imágenes colgantes y recursos Docker no usados. No toca volúmenes en la primera pasada.Cleans dangling images and unused Docker resources. The first pass does not touch volumes.
Cuándo usarloWhen to use it
Ya he medido el disco y necesito liberar espacio.I have measured disk usage and need to free space.
Antes de ejecutarBefore running
Revisa `docker compose ps`, `docker system df` y backups. No lo ejecutes en producción desconocida.Review `docker compose ps`, `docker system df`, and backups. Do not run it on unknown production.
Aviso: este comando puede borrar datos, cambiar permisos, abrir puertos, tocar secretos, matar procesos o modificar tareas. Revisa backups y entorno antes de copiarlo.Warning: this command can delete data, change permissions, open ports, touch secrets, kill processes, or modify tasks. Review backups and environment before copying it.
terminal
docker compose ps
docker system df
docker image prune -f
docker system prune -f
PELIGROSODANGEROUS
Último recurso: limpiar volúmenes DockerLast resort: clean Docker volumes
Qué haceWhat it does
Elimina volúmenes no asociados a contenedores. Puede borrar datos importantes.Deletes volumes not attached to containers. It can delete important data.
Cuándo usarloWhen to use it
Necesito borrar volúmenes no usados después de confirmar backups.I need to delete unused volumes after confirming backups.
Antes de ejecutarBefore running
Haz backup, revisa `docker volume ls`, confirma qué servicios usan cada volumen y no lo ejecutes por impulso.Make a backup, review `docker volume ls`, confirm which services use each volume, and do not run it on impulse.
Aviso: este comando puede borrar datos, cambiar permisos, abrir puertos, tocar secretos, matar procesos o modificar tareas. Revisa backups y entorno antes de copiarlo.Warning: this command can delete data, change permissions, open ports, touch secrets, kill processes, or modify tasks. Review backups and environment before copying it.
terminal
docker volume ls
docker volume prune -f
PRECAUCIÓNCAUTION
Smoke test de OpenClaw en DockerOpenClaw smoke test in Docker
Qué haceWhat it does
Clona el repo, arranca configuración Docker base y comprueba endpoints locales del Gateway.Clones the repo, starts the base Docker setup, and checks local Gateway endpoints.
Cuándo usarloWhen to use it
Quiero validar que la instalación Docker responde.I want to validate that the Docker installation responds.
Antes de ejecutarBefore running
Úsalo como prueba controlada. Si ya tienes un stack productivo, no mezcles carpetas ni tokens.Use it as a controlled test. If you already have a production stack, do not mix folders or tokens.
Entrar al servidor, mover archivos y comprobar rutas.Connect to the server, move files, and check paths.
SEGUROSAFE
Entrar al VPS por SSHConnect to the VPS over SSH
Qué haceWhat it does
Abre una sesión SSH con usuario, IP o dominio.Opens an SSH session with user, IP, or domain.
Cuándo usarloWhen to use it
Quiero conectarme a mi servidor.I want to connect to my server.
Antes de ejecutarBefore running
Sustituye USUARIO e IP_DEL_VPS. Usa una clave SSH propia y evita contraseñas si puedes.Replace USUARIO and IP_DEL_VPS. Use your own SSH key and avoid passwords when possible.
Placeholders:USUARIO, IP_DEL_VPS, TU_DOMINIO
terminal
ssh USUARIO@IP_DEL_VPS
ssh USUARIO@TU_DOMINIO
PELIGROSODANGEROUS
Copiar archivos entre local y VPSCopy files between local and VPS
Qué haceWhat it does
Usa scp para copias puntuales y rsync para sincronizar carpetas.Uses scp for one-off copies and rsync for folder synchronization.
Cuándo usarloWhen to use it
Necesito subir o bajar archivos del servidor.I need to upload or download files from the server.
Antes de ejecutarBefore running
Revisa origen y destino. Rsync puede sobrescribir archivos si apuntas mal la ruta.Review source and destination. Rsync can overwrite files if you point at the wrong path.
Placeholders:USUARIO, IP_DEL_VPS
Aviso: este comando puede borrar datos, cambiar permisos, abrir puertos, tocar secretos, matar procesos o modificar tareas. Revisa backups y entorno antes de copiarlo.Warning: this command can delete data, change permissions, open ports, touch secrets, kill processes, or modify tasks. Review backups and environment before copying it.
Firewall, permisos y secretosFirewall, permissions, and secrets
Abrir puertos, proteger ficheros y evitar fugas de tokens.Open ports, protect files, and prevent token leaks.
PELIGROSODANGEROUS
Revisar y activar firewall UFWReview and enable UFW firewall
Qué haceWhat it does
Muestra reglas, permite SSH y activa UFW si procede.Shows rules, allows SSH, and enables UFW if appropriate.
Cuándo usarloWhen to use it
Necesito comprobar el firewall del VPS.I need to check the VPS firewall.
Antes de ejecutarBefore running
Nunca actives UFW sin permitir antes SSH. Podrías quedarte fuera del servidor.Never enable UFW before allowing SSH. You could lock yourself out of the server.
Aviso: este comando puede borrar datos, cambiar permisos, abrir puertos, tocar secretos, matar procesos o modificar tareas. Revisa backups y entorno antes de copiarlo.Warning: this command can delete data, change permissions, open ports, touch secrets, kill processes, or modify tasks. Review backups and environment before copying it.
terminal
ufw status verbose
ufw allow OpenSSH
ufw enable
ufw status verbose
PELIGROSODANGEROUS
Proteger archivos de secretosProtect secret files
Qué haceWhat it does
Aplica permisos restrictivos a archivos que suelen contener secretos o certificados.Applies restrictive permissions to files that commonly contain secrets or certificates.
Cuándo usarloWhen to use it
Quiero ajustar permisos de .env, acme.json o claves.I want to adjust permissions for .env, acme.json, or keys.
Antes de ejecutarBefore running
Sustituye rutas reales. Un chmod/chown mal aplicado puede romper servicios.Replace real paths. A bad chmod/chown can break services.
Aviso: este comando puede borrar datos, cambiar permisos, abrir puertos, tocar secretos, matar procesos o modificar tareas. Revisa backups y entorno antes de copiarlo.Warning: this command can delete data, change permissions, open ports, touch secrets, kill processes, or modify tasks. Review backups and environment before copying it.
Revisar tareas periódicas y preparar copias básicas.Review recurring tasks and prepare basic backups.
PELIGROSODANGEROUS
Revisar tareas programadasReview scheduled tasks
Qué haceWhat it does
Lista cron del usuario actual y abre el editor para modificar tareas programadas.Lists the current user crontab and opens the editor for scheduled tasks.
Cuándo usarloWhen to use it
Quiero saber qué tareas se ejecutan solas.I want to know which tasks run automatically.
Antes de ejecutarBefore running
Haz copia del crontab antes de editar. Una tarea mal puesta puede lanzar procesos repetidos.Back up the crontab before editing. A bad task can launch repeated processes.
Aviso: este comando puede borrar datos, cambiar permisos, abrir puertos, tocar secretos, matar procesos o modificar tareas. Revisa backups y entorno antes de copiarlo.Warning: this command can delete data, change permissions, open ports, touch secrets, kill processes, or modify tasks. Review backups and environment before copying it.
Crear backup comprimido de una carpetaCreate a compressed backup of a folder
Qué haceWhat it does
Genera un archivo tar.gz con fecha para guardar una carpeta antes de hacer cambios.Creates a dated tar.gz archive for a folder before making changes.
Cuándo usarloWhen to use it
Necesito una copia rápida antes de tocar configuración.I need a quick copy before touching configuration.
Antes de ejecutarBefore running
Sustituye RUTA_A_COPIAR. Comprueba después que el archivo existe y pesa más que cero.Replace RUTA_A_COPIAR. Afterward, verify the file exists and is larger than zero.
Placeholders:RUTA_A_COPIAR
terminal
tar -czf backup-$(date +%Y%m%d-%H%M%S).tar.gz RUTA_A_COPIAR
ls -lh backup-*.tar.gz
TroubleshootingTroubleshooting
Buscar síntomas frecuentes cuando algo deja de responder.Search common symptoms when something stops responding.
SEGUROSAFE
Ver logs de systemdView systemd logs
Qué haceWhat it does
Consulta estado y logs recientes de un servicio gestionado por systemd.Checks status and recent logs for a systemd-managed service.
Cuándo usarloWhen to use it
Un servicio Linux no arranca o se reinicia solo.A Linux service does not start or keeps restarting.
Antes de ejecutarBefore running
Sustituye NOMBRE_SERVICIO. Si no sabes el nombre exacto, lista unidades primero.Replace NOMBRE_SERVICIO. If you do not know the exact name, list units first.
Ver qué proceso usa un puertoSee which process uses a port
Qué haceWhat it does
Identifica procesos escuchando en puertos y, si hace falta, mata uno concreto.Identifies processes listening on ports and, if needed, kills a specific one.
Cuándo usarloWhen to use it
Un puerto está ocupado y el servicio no arranca.A port is busy and the service will not start.
Antes de ejecutarBefore running
No mates procesos sin saber qué son. Sustituye PUERTO y PID después de revisar la salida.Do not kill processes unless you know what they are. Replace PUERTO and PID after reviewing the output.
Placeholders:PUERTO, PID
Aviso: este comando puede borrar datos, cambiar permisos, abrir puertos, tocar secretos, matar procesos o modificar tareas. Revisa backups y entorno antes de copiarlo.Warning: this command can delete data, change permissions, open ports, touch secrets, kill processes, or modify tasks. Review backups and environment before copying it.
terminal
ss -tulpn | grep PUERTO
lsof -i :PUERTO
kill PID
SEGUROSAFE
Comprobar Node y npmCheck Node and npm
Qué haceWhat it does
Muestra versiones instaladas y dónde resuelven los binarios.Shows installed versions and where binaries resolve.
Cuándo usarloWhen to use it
OpenClaw o npm fallan y quiero validar la base.OpenClaw or npm fails and I want to validate the base.
Antes de ejecutarBefore running
Úsalo antes de reinstalar nada. La salida ayuda a diagnosticar PATH o versiones antiguas.Use it before reinstalling anything. The output helps diagnose PATH or old versions.