Referencia de la CLI
Todos los comandos y flags de officeclaws en un solo lugar.
Ejecuta officeclaws help para ver el resumen integrado. La mayoría de los comandos que actúan sobre un agente aceptan --agent <id>. Sin él, usan tu primer agente.
Cuenta
| Comando | Descripción |
|---|---|
officeclaws register [--email] [--name] [--password-stdin] | Crea una cuenta e inicia sesión |
officeclaws login [--email] [--password-stdin] | Inicia sesión |
officeclaws logout [--keep-credentials] | Cierra sesión. También borra las credenciales guardadas, salvo que pases --keep-credentials. |
officeclaws whoami | Muestra la cuenta actual y si tiene un agente |
officeclaws subscribe [--plan selfHosted] [--locale en] | Abre el pago vinculado a tu cuenta |
--password-stdin lee la contraseña desde la entrada estándar, para scripts. Ejemplo: echo "$PW" | officeclaws login --email [email protected] --password-stdin.
Agentes
| Comando | Descripción |
|---|---|
officeclaws onboard [flags] | Configura un VPS de Contabo como agente. Consulta Crea tu agente. |
officeclaws agents | Lista tus agentes |
officeclaws connect-codex [--agent] | Conecta tu suscripción de ChatGPT |
officeclaws chat [--agent] [-m "message"] | Chatea de forma interactiva o envía un solo mensaje |
officeclaws logs [--agent] [--lines N] [-f] | Muestra o sigue en directo los logs del agente |
Flags de onboard: --name, --vps, --reinstall, --ssh-pubkey, --avatar, --comm-style, --tailscale-hostname, --tailscale-authkey, --contabo-client-id, --contabo-client-secret, --contabo-api-user, --contabo-api-password. --reinstall está pensada para nuestras imágenes de servidor preparadas internas y no borra tu VPS. Para empezar con un servidor limpio, reinstala Ubuntu 24.04 desde el panel de control de Contabo.
Tareas programadas
| Comando | Descripción |
|---|---|
officeclaws cron list | Lista las tareas programadas |
officeclaws cron add --name --schedule --message [--timezone] [--channel] [--target] | Añade una tarea |
officeclaws cron rm <name-or-id> | Elimina una tarea |
Telegram
| Comando | Descripción |
|---|---|
officeclaws telegram set [--bot-token] [--dm-policy pairing|allowlist|open|disabled] | Conecta o actualiza el bot |
officeclaws telegram show | Muestra la configuración actual |
officeclaws telegram pairings | Lista los códigos de vinculación pendientes |
officeclaws telegram approve <code> | Aprueba a un usuario de Telegram |
officeclaws telegram disable | Desactiva Telegram |
Credenciales y dispositivos
| Comando | Descripción |
|---|---|
officeclaws vault list [--type contabo|tailscale|telegram] | Lista las credenciales guardadas (valores ocultos) |
officeclaws vault apply <id> | Convierte un conjunto guardado en el activo |
officeclaws vault rm <id> | Borra un conjunto guardado |
officeclaws devices list / approve <id> | Solicitudes de dispositivos en el gateway del agente |
officeclaws pairing list / approve <id> / reject <id> / repair | Solicitudes de vinculación de operador; repair soluciona "1008 pairing required" |
Avanzado
| Comando | Descripción |
|---|---|
officeclaws adopt --vps <id> --host <tailscale-ip> --name <name> | Registra un agente que ya está funcionando cuando la configuración se interrumpió después de que el servidor estuviera listo. Úsalo solo si soporte te lo pide. |
officeclaws version | Muestra la versión |
Variables de entorno
| Variable | Descripción |
|---|---|
OFFICECLAWS_DEBUG=1 | Muestra logs detallados en stderr |
OPENCLAW_RPC=0 | Usa la conexión de chat alternativa (rara vez hace falta) |
Dónde se guardan las cosas
| Qué | Dónde |
|---|---|
| Sesión, credenciales de Contabo y Tailscale, vault | Llavero del sistema, servicio openclaw-office |
| Clave SSH usada para gestionar tus agentes | ~/.ssh/openclaw_id_ed25519 |
| Logs de la configuración | ~/.openclaw/logs |