Configuración de OpenClaw

Configurar una herramienta nueva suele ser un dolor de cabeza. Entre dependencias que no cargan y archivos de configuración que se pierden al actualizar, es fácil perder la paciencia antes de ver el primer resultado.

Aquí tienes los pasos para dejar OpenClaw listo sin dramas, separando tus ajustes personales del código base para que nada se rompa en la próxima actualización.

Requisitos previos

• Node >=22
• pnpm
• Docker (opcional, solo para instalaciones con contenedores o e2e)

Inicio rápido

La mejor estrategia es mantener tus personalizaciones fuera del repositorio. Guarda tu configuración en ~/.openclaw/openclaw.json y tu espacio de trabajo en ~/.openclaw/workspace.

Opción 1: Workflow estable (macOS)

Es la ruta recomendada si quieres que todo funcione sin complicaciones técnicas.

1. Instala y abre OpenClaw.app desde la barra de menú.
2. Completa el onboarding y acepta los permisos de TCC.
3. Asegúrate de que el Gateway esté en modo Local (la app lo gestionará por ti).
4. Vincula tus canales (ejemplo: WhatsApp) con este comando:

openclaw channels login

Verifica que todo esté en orden:

openclaw health

Opción 2: Workflow de desarrollo (Bleeding edge)

Usa esta opción si quieres trabajar en el Gateway de TypeScript con hot reload mientras mantienes la interfaz de la app de macOS conectada.

1. Instala dependencias y arranca el Gateway en modo watch:

pnpm install
pnpm gateway:watch

2. En OpenClaw.app, cambia el Connection Mode a Local. La app se conectará automáticamente al proceso que corre en tu terminal.

Si necesitas ejecutar el CLI directamente después de un pnpm build, usa:

node openclaw.mjs gateway --port 18789 --verbose

Solución de problemas

• Puerto incorrecto: El Gateway usa por defecto ws://127.0.0.1:18789. Verifica que tanto la app como el CLI usen el mismo puerto.
• Servicio detenido en Linux: Systemd suele matar procesos de usuario al cerrar la sesión. Si el Gateway se apaga, activa el “lingering” para tu usuario:

sudo loginctl enable-linger $USER

¿Necesitas ayuda específica con tu entorno? Prueba el AI Setup Assistant.

Próximos pasos

• Gateway runbook
• Gateway configuration
• Discord
• Telegram