​

Configuración

​

TL;DR

• La personalización vive fuera del repo: ~/.openclaw/workspace (workspace) + ~/.openclaw/openclaw.json (config).
• Flujo estable: instale la app de macOS; deje que ejecute el Gateway incluido.
• Flujo bleeding edge: ejecute el Gateway usted mismo vía pnpm gateway:watch, luego deje que la app de macOS se adjunte en modo Local.

​

Requisitos previos (desde el código fuente)

• Node >=22
• pnpm
• Docker (opcional; solo para configuración en contenedores/e2e — ver Docker)

​

Estrategia de personalización (para que las actualizaciones no duelan)

• Configuración: ~/.openclaw/openclaw.json (tipo JSON/JSON5)
• Workspace: ~/.openclaw/workspace (skills, prompts, memorias; conviértalo en un repo git privado)

openclaw setup

openclaw setup

​

Ejecutar el Gateway desde este repo

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

​

Flujo estable (primero la app de macOS)

1. Instale y lance OpenClaw.app (barra de menús).
2. Complete la lista de verificación de onboarding/permisos (prompts TCC).
3. Asegúrese de que el Gateway esté Local y en ejecución (la app lo gestiona).
4. Vincule superficies (ejemplo: WhatsApp):

openclaw channels login

5. Verificación rápida:

openclaw health

• Ejecute openclaw setup, luego openclaw channels login, y después inicie el Gateway manualmente (openclaw gateway).

​

Flujo bleeding edge (Gateway en una terminal)

​

0. (Opcional) Ejecutar también la app de macOS desde el código fuente

./scripts/restart-mac.sh

​

1. Iniciar el Gateway de desarrollo

pnpm install
pnpm gateway:watch

​

2. Apuntar la app de macOS a su Gateway en ejecución

• Modo de conexión: Local La app se adjuntará al gateway en ejecución en el puerto configurado.

​

3. Verificar

• El estado del Gateway en la app debería decir “Using existing gateway …”
• O vía CLI:

openclaw health

​

Pistolas comunes

• Puerto incorrecto: el WS del Gateway por defecto es ws://127.0.0.1:18789; mantenga app + CLI en el mismo puerto.
• Dónde vive el estado:
  • Credenciales: ~/.openclaw/credentials/
  • Sesiones: ~/.openclaw/agents/<agentId>/sessions/
  • Registros: /tmp/openclaw/

​

Mapa de almacenamiento de credenciales

• WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
• Token del bot de Telegram: config/env o channels.telegram.tokenFile
• Token del bot de Discord: config/env (el archivo de token aún no es compatible)
• Tokens de Slack: config/env (channels.slack.*)
• Listas de permitidos de emparejamiento: ~/.openclaw/credentials/<channel>-allowFrom.json
• Perfiles de autenticación de modelos: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• Importación OAuth heredada: ~/.openclaw/credentials/oauth.json Más detalles: Security.

​

Actualización (sin destrozar su configuración)

• Mantenga ~/.openclaw/workspace y ~/.openclaw/ como “sus cosas”; no ponga prompts/config personales en el repo openclaw.
• Actualizar el código fuente: git pull + pnpm install (cuando cambie el lockfile) + siga usando pnpm gateway:watch.

​

Linux (servicio de usuario systemd)

sudo loginctl enable-linger $USER

​

Documentos relacionados

• Gateway runbook (flags, supervisión, puertos)
• Gateway configuration (esquema de configuración + ejemplos)
• Discord y Telegram (etiquetas de respuesta + configuraciones de replyToMode)
• Configuración del asistente de OpenClaw
• macOS app (ciclo de vida del gateway)