OpenClaw ya tiene una guía completa en ruso sobre su configuración JSON5, la CLI y la configuración segura

Habr ha publicado una guía detallada de OpenClaw, una plataforma en la que casi toda la configuración operativa depende de un único archivo, openclaw.json, y de una CLI extensa. El material reúne en un solo lugar lo que antes había que rastrear en la ayuda oficial, en las issues de GitHub y en publicaciones de la comunidad.

Qué hay en la configuración

El autor explica cómo se organiza el nivel superior de la configuración y por qué OpenClaw exige cuidado al editarla a mano. El archivo usa JSON5, de modo que admite comentarios y comas finales, pero el esquema se valida de forma muy estricta al arrancar. Si se añade una clave desconocida, el gateway simplemente no se inicia. La guía describe por separado gateway, env, agents, models, auth, channels, session, cron, tools, sandbox y logging, así como el funcionamiento de la recarga en caliente sin reinicio completo.

• gateway: puerto, modo bind, token de acceso y comportamiento del hot reload
• agents y models: ajustes básicos, fallbacks y elección de proveedores
• auth y channels: cambio de perfiles, Telegram, Discord y otros canales
• session y cron: aislamiento de conversaciones, reinicios por tiempo y tareas en segundo plano
• env y secrets: prioridad de variables, SecretRef y almacenamiento de datos sensibles

El principal valor del material es que no se limita a una lista de campos. El texto explica cómo se relacionan los distintos niveles de configuración, dónde actúan los valores por defecto, cuándo se aplican los ajustes sin reiniciar y qué parámetros conviene no tocar a mano. Para quien ejecuta OpenClaw no en local, sino en un VPS o en un entorno de trabajo, ya no es un manual de consulta, sino un auténtico operational playbook.

Dónde falla la configuración

El bloque más útil trata no del happy path, sino de los fallos típicos. La guía subraya que algunos parámetros solo funcionan en agents.defaults y se ignoran en silencio si se trasladan a los ajustes de un agente concreto. Por eso la configuración puede parecer correcta y, aun así, no activar el comportamiento deseado. La recomendación es sencilla: usar con más frecuencia los comandos openclaw config get, set y unset en lugar de editar directamente, y ejecutar el diagnóstico tras cada cambio.

openclaw doctor es el comando más útil de toda la CLI.

También se analiza el problema de la hinchazón del contexto. OpenClaw usa dos mecanismos distintos: el pruning elimina resultados antiguos de herramientas antes de llamar al modelo, mientras que la compaction comprime el historial cuando la ventana de contexto está casi llena. Como ejemplo, se cita un caso en el que 35 mensajes se convirtieron en un archivo de sesión de 2,9 MB y un contexto de 208 467 tokens, por lo que el sistema dejó de responder con un límite del modelo de 200 000 tokens.

CLI para administradores

La CLI se describe por escenarios de trabajo y no por orden alfabético, lo que hace la guía más práctica. En un solo lugar se reúnen los comandos para arrancar el gateway, ver el estado del demonio, gestionar canales, logs, tareas cron, plugins, skills, sesiones y actualizaciones. Para los comandos de infraestructura se muestran aparte los modos seguros: health funciona incluso sin el demonio en marcha, security audit revisa la configuración en busca de riesgos y secrets audit ayuda a detectar filtraciones de credenciales antes de producción.

El último bloque importante trata de las variables de entorno y el control de versiones. La guía fija el orden de prioridad: primero el entorno del proceso, después el .env local, luego el .env global en el directorio de OpenClaw y solo al final las env.vars integradas. Para los secretos aconseja usar referencias a variables o SecretRef en lugar de valores en openclaw.json, y subir al repositorio únicamente una plantilla de configuración, excluyendo .env, las carpetas de sesiones, los archivos de memoria y el estado temporal.

Qué significa

OpenClaw se convierte en una herramienta no solo para entusiastas dispuestos a leer el código fuente, sino también para equipos que necesitan un operational playbook claro. Si un proyecto se apoya en varios modelos, canales y automatizaciones, una guía así reduce el riesgo de fallos silenciosos, filtración de secretos y comportamiento inestable tras las actualizaciones.