Configura OpenClaw: Guía rápida de ajustes y gateway

Configurar herramientas nuevas suele ser un dolor de cabeza. Pasas más tiempo peleando con archivos de texto que construyendo lo que realmente importa, y lo único que quieres es que todo funcione a la primera sin leer manuales infinitos.

Aquí tienes una guía directa para dominar la configuración de OpenClaw sin perder los nervios.

Configuration Basics

Entender el sistema de configuración de OpenClaw es clave para personalizar tu flujo de trabajo.

¿Qué formato tiene la configuración? ¿Dónde está?

OpenClaw lee una configuración opcional en JSON5 desde la variable $OPENCLAW_CONFIG_PATH (por defecto es ~/.openclaw/openclaw.json).

Si el archivo no existe, el sistema utiliza valores por defecto seguros, incluyendo un workspace predeterminado en ~/.openclaw/workspace.

He configurado gateway.bind: "lan" (o "tailnet") y ahora nada escucha / la UI dice “unauthorized”

Los binds que no son loopback requieren autenticación obligatoriamente. Debes configurar gateway.auth.mode y gateway.auth.token, o simplemente usar la variable de entorno OPENCLAW_GATEWAY_TOKEN.

{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me"
    }
  }
}

¿Por qué necesito un token en localhost ahora?

El asistente genera un token para el Gateway por defecto, incluso en loopback. Esto significa que los clientes WS locales deben autenticarse para poder conectar. Es una medida de seguridad para evitar que otros procesos locales llamen a tu Gateway sin permiso.

Si realmente prefieres tener un loopback abierto y sin restricciones, elimina la sección gateway.auth de tu configuración.

¿Tengo que reiniciar después de cambiar la configuración?

El Gateway vigila los cambios en tu archivo y soporta hot-reload para que no cortes tu ritmo:

• gateway.reload.mode: "hybrid" (por defecto): aplica cambios seguros en caliente y reinicia el proceso automáticamente para cambios críticos.
• También puedes usar los modos hot, restart o off.

¿Cómo activo la búsqueda web (y el fetch web)?

La función web_fetch funciona directamente sin necesidad de una API key. Sin embargo, web_search requiere que tengas una API key de Brave Search.

Mi recomendación: ejecuta el comando openclaw configure --section web para guardarla correctamente en tools.web.search.apiKey.

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5
      },
      fetch: { enabled: true }
    }
  }
}

config.apply borró mi configuración. ¿Cómo la recupero y cómo evito esto?

El comando config.apply reemplaza la configuración completa. Si envías un objeto parcial, el sistema eliminará todo lo que no esté en ese nuevo objeto.

Para recuperar:

• Restaura el archivo desde un backup.
• Si no tienes backup, ejecuta openclaw doctor y vuelve a configurar tus preferencias.

Para evitarlo:

• Usa openclaw config set si solo quieres hacer cambios pequeños.
• Usa openclaw configure para realizar ediciones interactivas.

¿Cómo ejecuto un Gateway central con workers especializados en varios dispositivos?

El patrón más efectivo es tener un Gateway central conectado con nodos y agentes:

• Gateway (central): gestiona los canales, el routing y las sesiones.
• Nodos (dispositivos): tus dispositivos (Mac, iOS, Android) se conectan como periféricos y exponen herramientas locales.
• Agentes (workers): cerebros y workspaces independientes para roles específicos.
• Sub-agentes: lanzan tareas en segundo plano desde un agente principal.
• TUI: te permite conectar al Gateway y saltar entre diferentes agentes o sesiones.

¿Puede el navegador de OpenClaw ejecutarse en modo headless?

Sí, puedes controlarlo con una opción en tu configuración:

{
  browser: { headless: true },
  agents: {
    defaults: {
      sandbox: { browser: { headless: true } }
    }
  }
}

El valor por defecto es false (headful). Ten en cuenta que el modo headless suele activar con más facilidad los controles anti-bot en algunos sitios web.

¿Cómo uso Brave para el control del navegador?

Solo tienes que configurar browser.executablePath con la ruta de tu binario de Brave (o cualquier otro navegador basado en Chromium) y reiniciar el Gateway para aplicar el cambio.

---

¿Necesitas ayuda personalizada para tu entorno? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Guía de CLI
• Configuración avanzada de Agentes
• Seguridad en el Gateway
• Uso de herramientas web