Edición de configuración de OpenClaw: Guía completa de configuración (2026)

Q: ¿Dónde se almacena el archivo de configuración de OpenClaw?

La ubicación predeterminada es ~/.openclaw/config.yaml. En algunas instalaciones puede estar en ~/.config/openclaw/config.yaml. Ejecuta openclaw config show --path para ver la ubicación exacta.

Q: ¿Cómo actualizo OpenClaw?

```bash pip install --upgrade openclaw

Q: ¿Cómo restablezco mi configuración a los valores predeterminados?

```bash openclaw config reset ```

TL;DR

Referencia rápida de los comandos de configuración más comunes de OpenClaw:

bash

# Abrir el editor de configuración
openclaw config edit

# Establecer un valor específico
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Ver la configuración actual
openclaw config show

# Validar y corregir problemas de configuración
openclaw doctor
openclaw doctor --fix

# Restablecer a los valores predeterminados
openclaw config reset

¿Qué es OpenClaw?

OpenClaw es un framework de asistente de IA de código abierto que conecta modelos de lenguaje extensos con canales de mensajería como WhatsApp, Discord, Telegram y Slack. Admite múltiples proveedores de modelos — OpenAI, Anthropic, Ollama (modelos locales), Google y más — y puede extenderse con habilidades y plugins personalizados.

El núcleo de OpenClaw es su sistema de configuración. Casi todo — qué canales están activos, qué modelo usar, qué habilidades están cargadas — se controla a través de archivos de configuración. Dominar openclaw config edit es la clave para que OpenClaw funcione como tú quieres.

openclaw config edit: Lo básico

Abrir el editor de configuración

El comando principal para configurar OpenClaw es:

bash

openclaw config edit

Esto abre tu archivo de configuración en tu editor de terminal predeterminado (generalmente nano, vim o el que esté definido en $EDITOR). El archivo de configuración suele encontrarse en ~/.openclaw/config.yaml o ~/.config/openclaw/config.yaml dependiendo de tu instalación.

Estructura del archivo de configuración

El archivo de configuración de OpenClaw tiene formato YAML y está organizado en secciones:

yaml

# Model configuration
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # model identifier string
  temperature: 0.7
  max_tokens: 4096

# Channel configuration
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# Skills and plugins
skills:
  - web_search
  - calculator
  - weather

# Speech-to-text
stt:
  provider: whisper
  model: whisper-1

# System prompt
system_prompt: "You are a helpful assistant."

Establecer valores individuales

En lugar de editar el archivo completo, puedes establecer valores de configuración individuales desde la línea de comandos:

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

Esto es útil para scripts o cambios rápidos sin abrir un editor.

Configuración de canales

La integración de WhatsApp requiere una cuenta de Meta Business y acceso a la WhatsApp Business API.

bash

# Habilitar el canal de WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

Problema común: WhatsApp requiere una URL de webhook. Necesitas exponer OpenClaw a internet usando un proxy inverso (nginx, Caddy) o un servicio de túnel (ngrok, Cloudflare Tunnel).

bash

# Establecer la URL del webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

La configuración de Discord es más sencilla: solo necesitas un token de bot del Discord Developer Portal.

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

Consejo: Asegúrate de que tu bot de Discord tenga habilitado el "Message Content" privileged intent en el Developer Portal, de lo contrario no podrá leer los mensajes.

Telegram requiere un token de bot de @BotFather:

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram admite los modos polling y webhook. Polling es más fácil para el desarrollo (no se necesita una URL pública):

bash

openclaw config set channels.telegram.mode polling

Para producción, utiliza el modo webhook:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

La integración de Slack utiliza Socket Mode (recomendado) o la Events API:

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

Se recomienda Socket Mode porque no requiere una URL pública.

Configuración de proveedores de modelos

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

Establece tu clave API como una variable de entorno (no la pongas en el archivo de configuración):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (Modelos locales)

Aquí es donde OpenClaw destaca para los usuarios preocupados por la privacidad. Ollama te permite ejecutar modelos localmente sin claves API y sin que los datos salgan de tu máquina.

bash

# Primero instala Ollama
# https://ollama.ai

# Descarga un modelo
ollama pull llama3.3

# Configura OpenClaw para usar Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Problema común: Si OpenClaw no puede conectarse a Ollama, asegúrate de que Ollama se esté ejecutando (ollama serve) y que la URL base coincida. El puerto predeterminado de Ollama es 11434.

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI utiliza una API compatible con OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # Usa la clave de xAI con el proveedor de OpenAI

Errores comunes de configuración y soluciones

Error: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

Esto suele significar que hay un error tipográfico en la clave de configuración. Revisa la ortografía. Errores comunes:

chanels → channels

providr → provider

telgram → telegram

Ejecuta openclaw config show para ver todas las claves válidas.

Error: "Channel auto-enabled without credentials"

Algunas versiones de OpenClaw habilitan automáticamente los canales cuando estableces las credenciales, incluso si no los has habilitado explícitamente. Esto puede causar fallos en el inicio si las credenciales están incompletas.

Solución:

bash

# Deshabilita explícitamente los canales que no estés usando
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Error: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Necesitas establecer la variable de entorno correspondiente. OpenClaw intencionadamente no almacena claves API en el archivo de configuración por razones de seguridad.

Solución: Añade la clave API a tu perfil de shell (~/.bashrc, ~/.zshrc) o utiliza un archivo .env:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

Uso de openclaw doctor

El comando openclaw doctor valida toda tu configuración e informa de los problemas:

bash

openclaw doctor

Ejemplo de salida:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

La bandera --fix intenta resolver los problemas automáticamente:

bash

openclaw doctor --fix

Esto deshabilitará los canales con credenciales faltantes, corregirá problemas de formato conocidos y sugerirá correcciones manuales para problemas que no pueda resolver automáticamente.

Configuración avanzada

Habilidades personalizadas

OpenClaw admite habilidades personalizadas (plugins) que extienden las capacidades del asistente:

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

O a través de la línea de comandos:

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

Configuración de Speech-to-Text (STT)

Para soporte de mensajes de voz en WhatsApp y Telegram:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # auto-detect o especificar "en", "es", etc.

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Integración de casa inteligente Tuya

OpenClaw puede controlar dispositivos de casa inteligente compatibles con Tuya:

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

Esto te permite controlar luces, interruptores, termostatos y otros dispositivos Tuya a través de comandos de lenguaje natural en cualquier canal conectado.

Múltiples configuraciones de modelos

Puedes definir ajustes preestablecidos de modelos y cambiar entre ellos:

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# o cambiar en tiempo de ejecución
openclaw --model fast

Preguntas frecuentes

¿Dónde se almacena el archivo de configuración de OpenClaw?

La ubicación predeterminada es ~/.openclaw/config.yaml. En algunas instalaciones puede estar en ~/.config/openclaw/config.yaml. Ejecuta openclaw config show --path para ver la ubicación exacta.

¿Puedo usar OpenClaw sin ninguna API en la nube?

Sí. Configura Ollama como tu proveedor de modelos y usa Telegram en modo polling. Esto te ofrece un asistente de IA totalmente local y privado, sin que ningún dato salga de tu máquina.

¿Cómo actualizo OpenClaw?

bash

pip install --upgrade openclaw
# o
npm update -g openclaw

Después de actualizar, ejecuta openclaw doctor para comprobar si hay cambios en el formato de configuración.

¿Puedo ejecutar varios canales simultáneamente?

Sí. Habilita tantos canales como quieras — OpenClaw los gestiona de forma concurrente. Cada canal comparte la misma configuración de modelo y habilidades.

¿Cómo restablezco mi configuración a los valores predeterminados?

bash

openclaw config reset

Esto sobrescribe tu archivo de configuración con la plantilla predeterminada. Haz una copia de seguridad de tu configuración actual primero si es necesario.

¿Quieres algo más sencillo?

OpenClaw es potente pero requiere comodidad con la terminal y configuración manual. Si quieres construir y lanzar productos impulsados por IA sin gestionar archivos de configuración, proveedores de modelos e integraciones de canales por tu cuenta:

Y Build se encarga de todo el stack — despliegue, videos de producto, SEO de IA y analíticas. Sin archivos de configuración. Sin terminal. Solo construye y lanza. Empieza gratis →

Fuentes:

TL;DR

Referencia rápida de los comandos de configuración más comunes de OpenClaw:

bash

# Abrir el editor de configuración
openclaw config edit

# Establecer un valor específico
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Ver la configuración actual
openclaw config show

# Validar y corregir problemas de configuración
openclaw doctor
openclaw doctor --fix

# Restablecer a los valores predeterminados
openclaw config reset

¿Qué es OpenClaw?

openclaw config edit: Lo básico

Abrir el editor de configuración

El comando principal para configurar OpenClaw es:

bash

openclaw config edit

Estructura del archivo de configuración

El archivo de configuración de OpenClaw tiene formato YAML y está organizado en secciones:

yaml

# Model configuration
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # model identifier string
  temperature: 0.7
  max_tokens: 4096

# Channel configuration
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# Skills and plugins
skills:
  - web_search
  - calculator
  - weather

# Speech-to-text
stt:
  provider: whisper
  model: whisper-1

# System prompt
system_prompt: "You are a helpful assistant."

Establecer valores individuales

En lugar de editar el archivo completo, puedes establecer valores de configuración individuales desde la línea de comandos:

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

Esto es útil para scripts o cambios rápidos sin abrir un editor.

Configuración de canales

La integración de WhatsApp requiere una cuenta de Meta Business y acceso a la WhatsApp Business API.

bash

# Habilitar el canal de WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

Problema común: WhatsApp requiere una URL de webhook. Necesitas exponer OpenClaw a internet usando un proxy inverso (nginx, Caddy) o un servicio de túnel (ngrok, Cloudflare Tunnel).

bash

# Establecer la URL del webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

La configuración de Discord es más sencilla: solo necesitas un token de bot del Discord Developer Portal.

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

Consejo: Asegúrate de que tu bot de Discord tenga habilitado el "Message Content" privileged intent en el Developer Portal, de lo contrario no podrá leer los mensajes.

Telegram requiere un token de bot de @BotFather:

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram admite los modos polling y webhook. Polling es más fácil para el desarrollo (no se necesita una URL pública):

bash

openclaw config set channels.telegram.mode polling

Para producción, utiliza el modo webhook:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

La integración de Slack utiliza Socket Mode (recomendado) o la Events API:

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

Se recomienda Socket Mode porque no requiere una URL pública.

Configuración de proveedores de modelos

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

Establece tu clave API como una variable de entorno (no la pongas en el archivo de configuración):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (Modelos locales)

Aquí es donde OpenClaw destaca para los usuarios preocupados por la privacidad. Ollama te permite ejecutar modelos localmente sin claves API y sin que los datos salgan de tu máquina.

bash

# Primero instala Ollama
# https://ollama.ai

# Descarga un modelo
ollama pull llama3.3

# Configura OpenClaw para usar Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Problema común: Si OpenClaw no puede conectarse a Ollama, asegúrate de que Ollama se esté ejecutando (ollama serve) y que la URL base coincida. El puerto predeterminado de Ollama es 11434.

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI utiliza una API compatible con OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # Usa la clave de xAI con el proveedor de OpenAI

Errores comunes de configuración y soluciones

Error: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

Esto suele significar que hay un error tipográfico en la clave de configuración. Revisa la ortografía. Errores comunes:

chanels → channels

providr → provider

telgram → telegram

Ejecuta openclaw config show para ver todas las claves válidas.

Error: "Channel auto-enabled without credentials"

Solución:

bash

# Deshabilita explícitamente los canales que no estés usando
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Error: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Necesitas establecer la variable de entorno correspondiente. OpenClaw intencionadamente no almacena claves API en el archivo de configuración por razones de seguridad.

Solución: Añade la clave API a tu perfil de shell (~/.bashrc, ~/.zshrc) o utiliza un archivo .env:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

Uso de openclaw doctor

El comando openclaw doctor valida toda tu configuración e informa de los problemas:

bash

openclaw doctor

Ejemplo de salida:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

La bandera --fix intenta resolver los problemas automáticamente:

bash

openclaw doctor --fix

Esto deshabilitará los canales con credenciales faltantes, corregirá problemas de formato conocidos y sugerirá correcciones manuales para problemas que no pueda resolver automáticamente.

Configuración avanzada

Habilidades personalizadas

OpenClaw admite habilidades personalizadas (plugins) que extienden las capacidades del asistente:

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

O a través de la línea de comandos:

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

Configuración de Speech-to-Text (STT)

Para soporte de mensajes de voz en WhatsApp y Telegram:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # auto-detect o especificar "en", "es", etc.

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Integración de casa inteligente Tuya

OpenClaw puede controlar dispositivos de casa inteligente compatibles con Tuya:

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

Esto te permite controlar luces, interruptores, termostatos y otros dispositivos Tuya a través de comandos de lenguaje natural en cualquier canal conectado.

Múltiples configuraciones de modelos

Puedes definir ajustes preestablecidos de modelos y cambiar entre ellos:

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# o cambiar en tiempo de ejecución
openclaw --model fast

Preguntas frecuentes

¿Dónde se almacena el archivo de configuración de OpenClaw?

¿Puedo usar OpenClaw sin ninguna API en la nube?

Sí. Configura Ollama como tu proveedor de modelos y usa Telegram en modo polling. Esto te ofrece un asistente de IA totalmente local y privado, sin que ningún dato salga de tu máquina.

¿Cómo actualizo OpenClaw?

bash

pip install --upgrade openclaw
# o
npm update -g openclaw

Después de actualizar, ejecuta openclaw doctor para comprobar si hay cambios en el formato de configuración.

¿Puedo ejecutar varios canales simultáneamente?

Sí. Habilita tantos canales como quieras — OpenClaw los gestiona de forma concurrente. Cada canal comparte la misma configuración de modelo y habilidades.

¿Cómo restablezco mi configuración a los valores predeterminados?

bash

openclaw config reset

Esto sobrescribe tu archivo de configuración con la plantilla predeterminada. Haz una copia de seguridad de tu configuración actual primero si es necesario.

¿Quieres algo más sencillo?

Y Build se encarga de todo el stack — despliegue, videos de producto, SEO de IA y analíticas. Sin archivos de configuración. Sin terminal. Solo construye y lanza. Empieza gratis →

Fuentes: