Configuración del Agent Runtime en OpenClaw

Configurar un agente suele ser un proceso caótico. Terminas con archivos de configuración dispersos, contextos que se pierden entre sesiones y herramientas que no se comportan como esperas. OpenClaw simplifica esto al centralizar todo en un único workspace, permitiendo que tu agente mantenga la coherencia sin complicaciones innecesarias.

Requisitos previos

• Tener definido un directorio en agents.defaults.workspace.
• Configurar channels.whatsapp.allowFrom (si planeas usar ese canal).

Inicio rápido

Para tener tu agente funcionando en menos de 5 minutos, te recomiendo seguir este camino:

1. Inicializa el entorno: Ejecuta openclaw setup. Esto creará el archivo ~/.openclaw/openclaw.json y preparará los archivos básicos en tu workspace.
2. Configura el modelo: Define tu modelo en el archivo de configuración siguiendo el formato provider/model.
3. Define la identidad: Edita los archivos SOUL.md e IDENTITY.md dentro de tu workspace para establecer el tono y nombre del agente.

Archivos de Bootstrap

OpenClaw inyecta automáticamente el contenido de ciertos archivos en el contexto del agente al iniciar una sesión. Puedes editarlos para personalizar el comportamiento:

• AGENTS.md: Instrucciones operativas y “memoria”.
• SOUL.md: Personalidad, límites y tono.
• TOOLS.md: Notas sobre cómo quieres que el agente use las herramientas.
• IDENTITY.md: Nombre y emoji del agente.
• USER.md: Tu perfil y cómo prefieres que te llamen.

Si prefieres usar un workspace ya configurado y no quieres que OpenClaw cree estos archivos, usa este ajuste:

{ agent: { skipBootstrap: true } }

Gestión de Herramientas y Skills

Las herramientas básicas como lectura, ejecución y escritura siempre están disponibles. Sin embargo, algunas funciones como apply_patch son opcionales y dependen de la configuración en tools.exec.applyPatch.

OpenClaw busca skills en dos áreas principales:

1. Globales: Skills incluidas en la instalación y las ubicadas en ~/.openclaw/skills.
2. Locales: Skills dentro de la carpeta skills de tu workspace.

Configuración de Modelos

Para configurar los modelos en agents.defaults.model, OpenClaw divide el texto en la primera barra diagonal (/).

• Usa siempre el formato provider/model.
• Si usas OpenRouter y el ID del modelo ya tiene una barra, incluye el prefijo del proveedor: openrouter/moonshotai/kimi-k2.
• Si omites el proveedor, OpenClaw intentará usar el default provider.

Solución de problemas

• El archivo BOOTSTRAP.md no aparece: Este archivo solo se genera en workspaces totalmente nuevos. Si ya existen otros archivos de bootstrap, no se volverá a crear.
• Los cambios en TOOLS.md no activan herramientas nuevas: Recuerda que TOOLS.md solo sirve para dar instrucciones al agente. La existencia de las herramientas se controla mediante la configuración del Gateway y las políticas de herramientas.
• Los mensajes entrantes interrumpen al agente: Si el queue mode está en steer, los mensajes nuevos detendrán las llamadas a herramientas pendientes para procesar la nueva instrucción. Cambia a followup si prefieres que el agente termine su turno actual primero.
• No se leen las sesiones antiguas de Pi/Tau: OpenClaw utiliza su propio sistema de almacenamiento en ~/.openclaw/agents/<agentId>/sessions/ en formato JSONL y no es compatible con carpetas de sesiones legadas.

Si necesitas ayuda para ajustar tu configuración, consulta al AI Setup Assistant.

Próximos pasos

• Agent workspace
• Gateway configuration
• Queue
• Streaming + chunking