OpenClaw en español: configuración completa del idioma y el agente

La documentación oficial de OpenClaw está disponible en español en docs.openclaw.ai/es . Esta versión cubre la arquitectura del gateway, la configuración de agentes, la referencia de la CLI y los tutoriales de integración con canales como Telegram, WhatsApp y Discord. Es la fuente primaria para hispanohablantes que empiecen con OpenClaw.

La interfaz web del gateway (accesible en http://localhost:18789 tras instalar OpenClaw) muestra los textos del sistema en inglés, pero el contenido generado por el agente — conversaciones, respuestas, resúmenes de memoria — puede aparecer completamente en español si así lo configuras. La distinción importante es: la UI del sistema está en inglés; las respuestas del agente pueden estar en el idioma que definas.

Acceder a la documentación en español

Cuando instalas OpenClaw, el gateway crea automáticamente varios archivos en el directorio de workspace del agente (por defecto ~/.openclaw/workspace/). El más importante para el idioma es SOUL.md, que OpenClaw inyecta como contexto en cada conversación. Tiene cuatro secciones: Core truths (verdades que guían el razonamiento), Boundaries (restricciones), Vibe (estilo de comunicación) y Continuity (gestión de memoria entre sesiones).

SOUL.md mínimo para un agente en español

# SOUL.md — Asistente personal en español

## Core truths
- Eres un asistente personal de IA local-first, honesto y directo.
- Tu idioma principal de comunicación es el español de España.
- Usas tildes, ñ y signos de puntuación correctamente en todo momento.
- Cuando no sabes algo, lo dices claramente en lugar de inventar.

## Boundaries
- No mezcles inglés y español en la misma respuesta salvo que el usuario te lo pida.
- No uses anglicismos innecesarios cuando existe un término español equivalente claro.
- No generes contenido dañino ni información sensible sin confirmación explícita.

## Vibe
- Responde siempre en español completo con ortografía correcta.
- Tono: profesional pero cercano. Sin formalidades excesivas.
- Sé conciso: ve al punto, evita relleno. Si la respuesta es larga, usa listas o secciones.
- Adapta el registro (informal/formal) según el tono del usuario.

## Continuity
- Recuerda las preferencias del usuario a lo largo de la sesión.
- Al inicio de cada sesión revisa MEMORY.md para contexto acumulado.
- Registra aprendizajes importantes sobre el usuario en MEMORY.md al finalizar.

Personalizar el IDENTITY.md

El archivo IDENTITY.md define el nombre y el rol del agente. Para un agente en español, configúralo así:

# IDENTITY.md

## Nombre
Asistente Personal

## Idioma
Español (España). Responder siempre en español salvo instrucción contraria explícita del usuario.

## Rol
Asistente personal de IA para tareas de productividad, investigación y comunicación.

## Personalidad
Directo, preciso, útil. Sin rodeos innecesarios.

Puedes editar estos archivos directamente con cualquier editor de texto o usar el comando openclaw config edit soul para abrirlos desde la CLI. Los cambios tienen efecto en la siguiente conversación sin necesidad de reiniciar el gateway.

Múltiples agentes con idiomas distintos

OpenClaw permite correr varios agentes en el mismo gateway, cada uno con su propio workspace. Para tener un agente en español y otro en inglés simultáneamente:

# openclaw.json — configuración multi-agente

{
  "agents": {
    "asistente-es": {
      "workspace": "~/.openclaw/workspaces/espanol",
      "model": "anthropic/claude-sonnet-4-6",
      "description": "Agente en español"
    },
    "assistant-en": {
      "workspace": "~/.openclaw/workspaces/english",
      "model": "anthropic/claude-sonnet-4-6",
      "description": "English assistant"
    }
  }
}

Cada workspace tiene su propio SOUL.md, IDENTITY.md y MEMORY.md, completamente independientes entre sí.

OpenClaw procesa el system prompt en capas. El orden de prioridad, de mayor a menor, es: instrucciones en tiempo real del usuario, archivo SOUL.md, archivo AGENTS.md, y la configuración del proveedor en openclaw.json. Para garantizar español en todos los escenarios, conviene reforzarlo en al menos dos capas.

Instrucción de idioma en el proveedor

# openclaw.json — instrucción de idioma a nivel de proveedor

{
  "providers": {
    "anthropic": {
      "apiKey": "${ANTHROPIC_API_KEY}",
      "model": "claude-sonnet-4-6",
      "systemPromptSuffix": "Responde siempre en español con ortografía completa: tildes, ñ, signos de puntuación. No respondas en inglés salvo que el usuario lo solicite explícitamente."
    }
  }
}

AGENTS.md con instrucciones de idioma globales

# AGENTS.md — instrucciones globales de agente

## Idioma
Este agente opera en español. Aplica siempre:
- Tildes obligatorias: está, también, más, qué, cómo, cuál, información, configuración.
- Uso correcto de ñ en palabras como español, configuración, diseño, año.
- Signos de apertura: ¿ para preguntas, ¡ para exclamaciones.
- No traducir términos técnicos que no tienen equivalente en español (framework,
  gateway, token, prompt) pero usarlos en minúscula como sustantivos integrados.

## Respuesta a usuarios en inglés
Si el usuario escribe en inglés, responde en español y añade al final:
"(Puedo responder en inglés si lo prefieres / I can respond in English if you prefer.)"

Verificar el idioma del agente con un test rápido

# Comprobar que el agente responde en español
openclaw chat "Hola, ¿en qué idioma prefieres comunicarte?"

# Resultado esperado (ejemplo):
# Hola. Me comunico en español. Puedo ayudarte con tareas de productividad,
# investigación, escritura y mucho más. ¿Qué necesitas?

Si el agente responde en inglés a pesar de la configuración, revisa que el SOUL.md se está cargando correctamente con openclaw config show soul. El problema más común es que el archivo tenga un nombre distinto o esté en un workspace diferente al que usa el agente activo.

OpenClaw almacena todos los archivos de workspace en UTF-8 y transmite los mensajes con codificación completa. Los modelos LLM modernos (Claude, GPT-5, Qwen) generan texto UTF-8 correcto con tildes y ñ cuando se les instruye en español. El origen más frecuente de problemas de codificación no es OpenClaw, sino el terminal o el canal de entrada/salida.

Caracteres que debes verificar en tus archivos

Cuando editas SOUL.md o AGENTS.md directamente en un editor, asegúrate de que el editor guarde en UTF-8 (sin BOM). Los editores más comunes lo hacen por defecto, pero conviene verificarlo si ves que los acentos se guardan como secuencias de dos caracteres (é en lugar de é).

# Verificar codificación de un archivo de workspace
file ~/.openclaw/workspace/SOUL.md
# Resultado esperado:
# /home/usuario/.openclaw/workspace/SOUL.md: UTF-8 Unicode text

# Ver el contenido con acentos correctos
cat ~/.openclaw/workspace/SOUL.md | head -5

Test de caracteres especiales en el agente

# Test rápido de caracteres especiales
openclaw chat "¿Puedes escribir esta frase exactamente? 'La configuración del agente en español incluye diseño, selección y revisión.'"

# Resultado esperado (el agente debe reproducir la frase con todos los acentos):
# Claro: "La configuración del agente en español incluye diseño, selección y revisión."

OpenClaw soporta más de 30 proveedores de modelos. Para uso en español, la selección importa: algunos modelos tienen datos de entrenamiento con mucho más español que otros y producen texto significativamente más natural, con gramática correcta y respeto estricto de las convenciones ortográficas.

Configurar un modelo para uso en español

# openclaw.json — configurar claude-sonnet-4-6 para español

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4-6"
    }
  },
  "providers": {
    "anthropic": {
      "apiKey": "${ANTHROPIC_API_KEY}",
      "defaultParams": {
        "temperature": 0.7,
        "maxTokens": 4096
      }
    }
  }
}

Usar Ollama con modelo en español sin coste de API

# 1. Descargar el modelo Qwen2.5 para español
ollama pull qwen2.5:7b

# 2. Configurar OpenClaw para usar Ollama
# En openclaw.json:
{
  "providers": {
    "ollama": {
      "baseUrl": "http://localhost:11434",
      "model": "qwen2.5:7b"
    }
  },
  "agents": {
    "defaults": {
      "model": "ollama/qwen2.5:7b"
    }
  }
}

# 3. Iniciar el gateway
openclaw start

# 4. Test en español
openclaw chat "¿Qué ventajas tiene Qwen2.5 para uso en español?"

La comunidad hispanohablante usa mayoritariamente WhatsApp y Telegram como canales principales de mensajería. Ambos están soportados nativamente por OpenClaw y transmiten UTF-8 completo, por lo que los acentos y la ñ llegan sin problema a todos los dispositivos.

Configuración rápida de Telegram en español

# 1. Crear un bot en Telegram con @BotFather y obtener el token

# 2. Configurar el canal en openclaw.json
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "agent": "asistente-es"   // apunta al agente configurado en español
    }
  }
}

# 3. Iniciar OpenClaw
openclaw start

# 4. Escribe al bot en Telegram en español — el agente responderá en español

Puedes conectar varios canales al mismo agente en español simultáneamente: el mismo agente puede responder en WhatsApp, Telegram y Discord a la vez, manteniendo contexto separado por conversación y canal.