Gestionar agentes IA suele significar pelearse con ventanas de terminal, sesiones SSH y archivos de configuración dispersos. Office Claws reemplaza todo eso con un único CLI — además de una app de escritorio con una oficina en pixel art donde cada agente se sienta en su propio escritorio. Cada agente se ejecuta en un VPS de tu propia cuenta de Contabo y se comunica con tu ordenador a través de tu propia red Tailscale. Esta guía te lleva por cada paso de la configuración — desde instalar el CLI hasta chatear con tu primer agente.
Lo Que Necesitas Antes de Empezar
Reúne lo siguiente antes de comenzar. Tenerlo todo listo hace que la configuración lleve solo unos minutos.
Cuentas y Credenciales
- Una suscripción a Office Claws. Hay un único plan, Self-Hosted, por $4.99/mes. Necesitas una suscripción activa antes de aprovisionar un agente — te suscribes desde el CLI en el Paso 2.
- Una cuenta de Contabo con un VPS. Tu agente se ejecuta en un VPS de tu propia cuenta de Contabo, que pagas directamente a Contabo — un VPS pequeño cuesta unos pocos euros al mes. Contrata el VPS en Contabo antes de empezar el onboarding. Office Claws ejecuta un agente por VPS.
- Credenciales de la API de Contabo. Abre my.contabo.com/api/details y anota tu Client ID y Client secret (en "API Data"), tu API user (el email con el que entras en Contabo) y tu API password. La contraseña de la API no es la contraseña de acceso a la web — si nunca la has configurado, haz clic en "Set password" en esa página.
- Una cuenta de Tailscale y una clave de autenticación. Tailscale crea la red cifrada entre tu ordenador y el VPS de tu agente. Crea una cuenta gratuita en tailscale.com y genera una clave de autenticación en la consola de administración, en Settings > Keys > Generate auth key.
- Una suscripción a ChatGPT con Codex. Tu agente funciona con tu propia suscripción de OpenAI Codex (ChatGPT), que conectas iniciando sesión en el navegador en el Paso 5. No necesitas ninguna clave API.
- Un ordenador con macOS o Linux, con Tailscale instalado y conectado. El CLI llega a tus agentes a través de tu tailnet.
Pon en marcha tu primer agente en unos 3 minutos
Instala la CLI de Office Claws, conecta tu cuenta de Contabo y tu suscripción de Codex, y tu agente tendrá su propio VPS y un escritorio en la oficina.
curl -fsSL https://officeclaws.com/downloads/install.sh | sh$4.99/mes + tu propio VPS de Contabo · las claves se quedan en tu llavero
Cómo Funcionan los Precios
Office Claws tiene un único plan: Self-Hosted, $4.99/mes. Incluye el CLI, la app de escritorio con su oficina en pixel art, chat en tiempo real con los agentes, logs, tareas programadas y canales como Telegram. La infraestructura sigue siendo tuya: el VPS está en tu cuenta de Contabo y lo factura Contabo, y el modelo funciona con tu propia suscripción de Codex.
No hay prueba gratuita — se requiere una suscripción activa antes de aprovisionar. Los reembolsos se rigen por nuestra Política de Reembolsos.
Paso 1: Instala el CLI
Instala el CLI officeclaws con un solo comando:
curl -fsSL https://officeclaws.com/downloads/install.sh | shEjecuta officeclaws version para confirmar que está en tu PATH. ¿Prefieres una interfaz gráfica? La app de escritorio con la oficina en pixel art está disponible en la página principal y funciona con la misma cuenta y los mismos agentes.
Paso 2: Crea Tu Cuenta y Suscríbete
officeclaws register # o: officeclaws login
officeclaws subscriberegister crea tu cuenta de Office Claws con un email y una contraseña; usa login si ya tienes una. subscribe abre el checkout en tu navegador (si no puede abrirlo, imprime el enlace para que lo copies). Una vez completado el pago, tu cuenta está lista para aprovisionar agentes.
Paso 3: Haz el Onboarding de Tu Primer Agente
officeclaws onboard --name MonaEl onboarding es interactivo. Este:
- Comprueba que tu suscripción está activa. Si no lo está, te remite a
officeclaws subscribe. - Pide tus cuatro credenciales de la API de Contabo y las valida. Se guardan en el llavero de tu sistema operativo, así que solo las introduces una vez.
- Pide tu clave de autenticación de Tailscale, que también se guarda en el llavero.
- Crea una clave SSH que el CLI usa para llegar a tus agentes.
- Sincroniza los VPS de tu cuenta de Contabo y te deja elegir el que se convertirá en agente.
Si omites --name, el onboarding te lo pregunta. Dos flags opcionales personalizan el agente: --comm-style friendly|business|creative define su tono y --avatar elige uno de los 12 avatares en pixel art que se ven en la oficina de escritorio. Cada pregunta tiene también su flag (--contabo-client-id, --tailscale-authkey, --vps, etc.), así que el onboarding puede ejecutarse de forma totalmente no interactiva — officeclaws help los lista todos.
Paso 4: Sigue el Aprovisionamiento
Tras elegir un VPS, Office Claws lo aprovisiona y muestra el progreso directamente en tu terminal mientras:
- Instala el agente desde una imagen preconstruida de Office Claws.
- Une el VPS a tu red Tailscale.
- Endurece el servidor y arranca el runtime del agente en Docker.
- Configura el gateway del agente, accesible solo a través de tu tailnet.
Todo el proceso tarda unos 2 a 3 minutos. La imagen ya trae todo lo que el agente necesita, así que el servidor no instala paquetes desde cero — eso es lo que mantiene rápido el aprovisionamiento. Al terminar, el CLI te muestra tus dos siguientes comandos.
Si el VPS ya contiene datos que quieres reemplazar, --reinstall lo borra y lo reinstala desde la imagen de Office Claws. Úsalo solo en un servidor que no te importe borrar.
Paso 5: Conecta Tu Suscripción de Codex
officeclaws connect-codexEsto abre la página de inicio de sesión de OpenAI en tu navegador (o imprime el enlace). Inicia sesión con la cuenta de ChatGPT que tiene Codex; el CLI espera a que termines (hasta cinco minutos) y confirma cuando tu agente ya funciona con tu suscripción. Codex es la vía de modelo soportada para los agentes de Office Claws — Claude Code y otras suscripciones de Anthropic no están soportadas.
Paso 6: Empieza a Chatear con Tu Agente
officeclaws chatEsto abre un chat interactivo con tu agente principal (pulsa Ctrl-D para salir). Usa officeclaws chat -m "..." para un mensaje suelto, --agent <id> para hablar con un agente concreto, officeclaws agents para listar tus agentes y officeclaws logs --follow para seguir los logs de un agente.
Prueba estos primeros mensajes para verificar tu configuración:
- "¿En qué puedes ayudarme?"
- "Resume este documento: [pega el texto]"
- "Revisa este código en busca de errores: [pega el código]"
En la app de escritorio, el mismo agente aparece en un escritorio de la oficina en pixel art — haz clic en su sprite para abrir el panel de chat, que conserva todo el historial para que retomes la conversación donde la dejaste.
Entendiendo la Oficina en Pixel Art
Si usas la app de escritorio, la oficina es más que un adorno visual. Te da una vista general del estado de todos tus agentes de un vistazo:
- Escribiendo en un escritorio — El agente está procesando activamente o disponible.
- Tomando café — El agente está en un breve ciclo de inactividad.
- Descansando en el sofá — El agente está en un estado de inactividad prolongado.
- Sentado en el área offline — El VPS del agente no es accesible.
A medida que agregas más agentes, cada uno se asigna a un escritorio en la oficina. El diseño soporta hasta seis escritorios en la sala principal, un escritorio en la oficina lateral y asientos de descanso en las áreas de recreo.
Cómo Se Mantienen Seguras Tus Credenciales
La seguridad es una preocupación habitual cuando una herramienta toca tus cuentas de nube e IA. Así lo gestiona Office Claws:
- Almacenamiento en el llavero local. Tus credenciales de la API de Contabo, tu clave de autenticación de Tailscale y tu sesión del CLI se guardan en el llavero de tu sistema operativo, no en los servidores de Office Claws. Los valores secretos nunca se imprimen — los listados solo muestran vistas previas enmascaradas.
- Tu propia red. El CLI y la app de escritorio llegan a tu agente por SSH a través de tu red Tailscale. Los puertos SSH, HTTPS y del gateway del agente solo están abiertos en tu tailnet.
- Tu propia suscripción. La conexión de Codex usa el flujo de inicio de sesión de OpenAI: entras en la página de OpenAI y no se copia ninguna clave API de un lado a otro. La sesión resultante vive en el VPS de tu agente.
- Conexión directa. El chat y los logs viajan directamente entre tu ordenador y tu agente por tu tailnet. Una vez que ejecutas
officeclaws connect-codex, las peticiones al modelo van del VPS de tu agente directamente a OpenAI; antes de eso, una pequeña asignación inicial pasa por el gateway LLM de Office Claws. Office Claws sí guarda una copia de tu historial de chat en tu cuenta; la página de seguridad detalla exactamente qué se almacena.
Lo Que Office Claws Automatiza: La Configuración Manual Que Te Ahorras
Para entender el valor del aprovisionamiento con un solo comando, ayuda ver cómo es configurar un VPS seguro para un agente IA sin él. A continuación están todos los pasos que Office Claws realiza automáticamente entre bastidores. Si lo hicieras tú mismo, calcula entre 45 minutos y una hora de trabajo en terminal por servidor — suponiendo que aciertes cada comando a la primera.
Crear y Acceder al Servidor
Manualmente, tendrías que entrar en tu proveedor cloud (Contabo, Hetzner, DigitalOcean u otro), crear un servidor Ubuntu 24.04, esperar a que arranque y conectarte por SSH como root. También tienes que generar un par de claves SSH, subir la clave pública y confirmar que puedes conectarte.
Crear un Usuario No Root
Ejecutar servicios como root es un riesgo de seguridad. Necesitarías crear un usuario dedicado, agregarlo al grupo sudo, copiar tu clave pública SSH en su archivo authorized_keys y establecer los permisos correctos (700 para el directorio .ssh, 600 para el archivo de clave). Luego configurar acceso sudo sin contraseña para comandos específicos — firewall, Tailscale y Docker — para que el proceso del agente pueda gestionar esos servicios sin privilegios completos de root.
Endurecer SSH
De fábrica, SSH en un servidor Ubuntu nuevo permite el inicio de sesión como root y la autenticación por contraseña — ambos son vectores de ataque comunes. Necesitas escribir una configuración de endurecimiento que deshabilite todo lo siguiente:
- Inicio de sesión como root (
PermitRootLogin no) - Autenticación por contraseña (
PasswordAuthentication no) - Autenticación challenge-response
- X11 forwarding
- Agent forwarding
Luego validar la sintaxis de la configuración con sshd -t y reiniciar el servicio SSH. Un error tipográfico en este archivo y te quedas fuera del servidor.
Instalar y Configurar el Firewall
A continuación, instalar ufw (Uncomplicated Firewall) y establecer una política predeterminada de denegar todo el tráfico entrante. Temporalmente permites SSH en todas las interfaces para no perder tu conexión, luego — después de que Tailscale esté funcionando — restringes SSH, HTTPS y el puerto del gateway del agente (18789) solo a la interfaz de Tailscale y eliminas la regla pública de SSH. El estado final del firewall:
- Todo el tráfico entrante denegado por defecto
- Puerto 22 (SSH): permitido solo a través de Tailscale
- Puerto 443 (HTTPS): permitido solo a través de Tailscale
- Puerto 18789 (gateway del agente): permitido solo a través de Tailscale
- Todo el tráfico saliente permitido
Equivocarte en el orden de las operaciones aquí — restringir SSH antes de que Tailscale esté activo — significa perder el acceso al servidor por completo.
Configurar la Prevención de Intrusiones
Instalar y habilitar fail2ban, que monitorea los registros de autenticación y bloquea temporalmente las direcciones IP que muestran patrones de inicio de sesión por fuerza bruta. Esto añade una capa de defensa incluso si SSH eventualmente queda expuesto por una mala configuración.
Habilitar Actualizaciones de Seguridad Automáticas
Instalar unattended-upgrades y apt-listchanges, luego configurarlos con dpkg-reconfigure. Esto asegura que el servidor aplique parches de seguridad automáticamente sin intervención manual. Omitir este paso significa que tu servidor se queda atrás en parches en cuestión de semanas.
Asignar Memoria Swap
Crear un archivo de swap de 2 GB en /swapfile, establecer permisos a 600, formatearlo con mkswap, activarlo con swapon y agregarlo a /etc/fstab para que persista entre reinicios. Sin swap, un pico de memoria en el proceso del agente puede matar el contenedor o hacer que el servidor se caiga.
Instalar y Configurar Tailscale
Instalar Tailscale desde su script de instalación oficial, activarlo con tu clave de autenticación y un nombre de host, esperar a que se asigne una IP (hasta 60 segundos), establecer el operador como tu usuario no root, solicitar un certificado TLS y habilitar el servicio HTTPS en el puerto del gateway del agente. Esto crea el túnel cifrado que reemplaza la exposición pública a internet para toda la comunicación del agente.
Instalar Docker y Descargar la Imagen del Agente
Instalar Docker desde el script de instalación oficial, agregar tu usuario no root al grupo docker, autenticarse con el registro de contenedores si es necesario y pre-descargar la imagen del runtime del agente. Luego lanzar el contenedor con las variables de entorno correctas, límites de memoria (1800 MB con 2 GB de swap), red del host, un volumen persistente y una política de reinicio para que sobreviva a los reinicios.
Conectar el Proveedor del Modelo
Configura el acceso del agente al modelo — una clave API pasada al contenedor como variable de entorno, o un inicio de sesión de suscripción como el de Codex — y configura el gateway con conectividad WebSocket, TLS y permisos de operador. Luego espera a que el gateway se inicialice y extrae el token de autenticación de los logs del contenedor.
Verificar Que Todo Funciona
Confirmar que las reglas del firewall son correctas, que Tailscale está conectado, que el contenedor Docker está funcionando, que el agente responde a través del gateway y que tu máquina local puede alcanzarlo a través de la red de Tailscale. Actualizar tu configuración SSH local y known_hosts para un acceso más conveniente en el futuro.
A Qué Equivale Todo Esto
Aquí está la lista completa de paquetes y servicios configurados en cada VPS de agente de Office Claws:
| Componente | Propósito |
|---|---|
ufw | Firewall con reglas de acceso solo por Tailscale |
fail2ban | Prevención de intrusiones por fuerza bruta |
unattended-upgrades | Parches de seguridad automáticos |
| Configuración de endurecimiento SSH | Deshabilita inicio de sesión como root, contraseñas, reenvío |
| Tailscale | Red cifrada y certificados TLS |
| Docker | Runtime de agente en contenedor con límites de memoria |
| 2 GB de swap | Protección contra desbordamiento de memoria |
| Usuario no root con sudo limitado | Principio de mínimo privilegio |
Son ocho capas de seguridad configuradas en aproximadamente 20 pasos manuales, cada uno con sus propios modos de fallo. Te equivocas en el orden del firewall y te quedas fuera. Olvidas el swap y el agente se cae bajo carga. Omites unattended-upgrades y tu servidor acumula vulnerabilidades. Configuras mal el endurecimiento de SSH y dejas la puerta abierta — o te la cierras a ti mismo.
Con Office Claws, ejecutas officeclaws onboard, sigues el progreso durante dos o tres minutos y obtienes todo — endurecido, probado y conectado. El aprovisionamiento basado en imagen significa que cada servidor arranca desde una imagen preconstruida y verificada, así que no hay ninguna diferencia entre lo que esperas y lo que obtienes.
Solución de Problemas Comunes de Configuración
"No active subscription"
El onboarding se detiene si tu cuenta no tiene una suscripción activa. Ejecuta officeclaws subscribe, completa el checkout y vuelve a ejecutar officeclaws onboard.
Las credenciales de Contabo son rechazadas
Revisa los cuatro valores en my.contabo.com/api/details. El error más común es introducir la contraseña de acceso a la web en lugar de la contraseña de la API. Si nunca has configurado una contraseña de la API, configúrala primero en esa página.
"No VPSes found on your account"
El onboarding convierte en agente un VPS que ya existe en tu cuenta de Contabo. Contrata un VPS en Contabo, espera a que esté en marcha y vuelve a ejecutar officeclaws onboard.
El aprovisionamiento tarda más de lo esperado
El aprovisionamiento suele tardar de 2 a 3 minutos. Si va mucho más lento, puede que Contabo aún esté preparando el servidor — revisa su estado en el panel de control de Contabo. Una ejecución con --reinstall tarda más porque Contabo primero tiene que reinstalar la imagen del servidor. Si el aprovisionamiento falla, el CLI muestra el error, officeclaws agents indica el estado del agente y los logs completos están en ~/.openclaw/logs.
La clave de autenticación de Tailscale es rechazada
Asegúrate de que la clave no ha caducado y, si es de un solo uso, de que no se ha usado ya. Genera una nueva en la consola de administración de Tailscale y pásala con officeclaws onboard --tailscale-authkey <clave>.
El agente aparece offline o el chat no conecta
Verifica que Tailscale está en ejecución en tu ordenador. chat y logs llegan al agente a través de tu tailnet, así que ambos lados deben estar conectados. Abre la app de Tailscale y confirma que tu máquina aparece como "Connected".
Qué Viene Después
Una vez que tu primer agente esté en marcha:
- Añade más agentes. Cada agente tiene su propio VPS y su propio escritorio en la oficina. Contrata otro VPS en Contabo y vuelve a ejecutar
officeclaws onboard. - Programa trabajo recurrente.
officeclaws cron addconfigura tareas programadas, yofficeclaws telegram sette permite hablar con un agente desde Telegram. - Explora personalidades de agente. Distintos valores de
--comm-styleproducen patrones de interacción notablemente diferentes.
Configurar Office Claws lleva unos minutos, pero el resultado es un espacio de trabajo IA persistente que sigue funcionando tanto si tu terminal o la app están abiertos como si no. Tus agentes siguen trabajando en su VPS y tú te reconectas cuando los necesites.