Skip to main content

​
openclaw configure

Indicaciones interactivas para realizar cambios específicos en una configuración existente: credenciales, dispositivos, valores predeterminados del agente, Gateway, canales, plugins, Skills y comprobaciones de estado. Use openclaw onboard o openclaw setup para completar todo el proceso guiado de la primera ejecución, openclaw setup --baseline solo para la configuración y el espacio de trabajo básicos, y openclaw channels add cuando únicamente necesite configurar una cuenta de canal.
openclaw config sin subcomando abre el mismo asistente. Use openclaw config get|set|unset para realizar cambios no interactivos.

​
Opciones

--section <section>: filtro de secciones que puede repetirse. Secciones disponibles: workspace, model, web, gateway, daemon, channels, plugins, skills, health
Al seleccionar gateway, daemon o health (o ejecutar el asistente completo sin --section), se solicita dónde se ejecuta el Gateway y se actualiza gateway.mode. Los filtros de secciones que omiten las tres opciones pasan directamente a la configuración solicitada sin preguntar por el modo del Gateway. Al elegir el modo de Gateway remoto, se escribe la configuración remota y se sale inmediatamente; no se ejecutan pasos exclusivos del entorno local, como la instalación de plugins.
openclaw configure requiere un terminal interactivo (tanto stdin como stdout deben ser TTY). Sin uno, muestra los comandos no interactivos equivalentes de openclaw config get|set|patch|validate y finaliza con un error en lugar de ejecutarse parcialmente.

​
Sección de modelos

Modelo incluye una selección múltiple para la lista explícita agents.defaults.modelPolicy.allow (lo que aparece en /model y en el selector de modelos). Las opciones de configuración específicas de un proveedor combinan los modelos seleccionados con la lista existente, en lugar de sustituir a los proveedores no relacionados que ya están en la configuración. Los alias y parámetros de cada modelo permanecen en agents.defaults.models; esas entradas no restringen por sí solas las sustituciones de modelos.Al volver a ejecutar la autenticación del proveedor desde la configuración, se conserva un agents.defaults.model.primary existente, incluso cuando el paso de autenticación del proveedor devuelve un parche de configuración con su propio modelo predeterminado recomendado. Añadir o volver a autenticar un proveedor hace que sus modelos estén disponibles sin sustituir el modelo principal actual. Use openclaw models auth login --provider <id> --set-default o openclaw models set <model> para cambiar intencionadamente el modelo predeterminado.
Cuando la configuración se inicia desde una opción de autenticación de proveedor, los selectores de modelo predeterminado y política de modelos dan preferencia automáticamente a ese proveedor. Para proveedores emparejados como Volcengine y BytePlus, la misma preferencia también coincide con sus variantes de planes de programación (volcengine-plan/*, byteplus-plan/*). Si el filtro del proveedor preferido generase una lista vacía, la configuración recurre al catálogo sin filtrar en lugar de mostrar un selector vacío.

​
Sección web

openclaw configure --section web selecciona un proveedor de búsqueda web y configura sus credenciales. Algunos proveedores muestran opciones de seguimiento específicas:
  • Grok puede ofrecer la configuración opcional de x_search con el mismo perfil de OAuth de xAI o la misma clave de API, y permitir seleccionar un modelo de x_search.
  • Kimi puede solicitar la región de la API de Moonshot (api.moonshot.ai frente a api.moonshot.cn) y el modelo predeterminado de búsqueda web de Kimi.

​
Otras notas

  • Después de escribir la configuración local, el proceso de configuración instala los plugins descargables seleccionados cuando la ruta de configuración elegida los requiere. La configuración del Gateway remoto no instala paquetes de plugins locales.
  • Los servicios orientados a canales (Slack/Discord/Matrix/Microsoft Teams) solicitan listas de canales o salas permitidos durante la configuración. Se pueden introducir nombres o identificadores; el asistente resuelve los nombres como identificadores cuando es posible.
  • Si se ejecuta el paso de instalación del daemon, la autenticación mediante token requiere un token. Si gateway.auth.token está gestionado por SecretRef, el proceso de configuración valida la SecretRef, pero no conserva los valores del token resueltos en texto sin formato en los metadatos del entorno del servicio supervisor; si la SecretRef no se puede resolver, bloquea la instalación del daemon y proporciona instrucciones de corrección prácticas.
  • Si tanto gateway.auth.token como gateway.auth.password están configurados y gateway.auth.mode no está definido, el proceso de configuración bloquea la instalación del daemon hasta que se establezca explícitamente el modo.

​
Contenido relacionado