Configurar

`openclaw configure`

Prompt interactivo para realizar cambios específicos en una configuración existente: credenciales, dispositivos, valores predeterminados del agente, puerta de enlace, canales, complementos, habilidades y comprobaciones de estado.

Use openclaw onboard para el recorrido guiado completo de primera ejecución, openclaw setup solo para la configuración/espacio de trabajo base y openclaw channels add cuando solo necesite configurar la cuenta del canal.

Note

La sección Model (Modelo) incluye una selección múltiple para la lista de permitidos (allowlist) de agents.defaults.models (lo que aparece en /model y en el selector de modelos). Las opciones de configuración con ámbito de proveedor fusionan sus modelos seleccionados en la lista de permitidos existente en lugar de reemplazar a los proveedores no relacionados ya presentes en la configuración.

Volver a ejecutar la autenticación del proveedor desde configure 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. Esto significa que agregar o volver a autenticar xAI, OpenRouter u otro proveedor debería hacer que el nuevo modelo esté disponible sin reemplazar a su modelo principal actual. Use `openclaw models auth login —provider

—set-defaultoopenclaw models set

` cuando intencionalmente desee cambiar el modelo predeterminado.

Cuando configure se inicia desde una elección de autenticación de proveedor, los selectores de modelo predeterminado y lista de permitidos prefieren automáticamente ese proveedor. Para proveedores emparejados como Volcengine y BytePlus, la misma preferencia también coincide con sus variantes de plan de codificación (volcengine-plan/*, byteplus-plan/*). Si el filtro de proveedor preferido produjera una lista vacía, configure recurre al catálogo sin filtrar en lugar de mostrar un selector en blanco.

Para la búsqueda web, openclaw configure --section web le permite elegir un proveedor y configurar sus credenciales. Algunos proveedores también muestran preguntas de seguimiento específicas del proveedor:

Grok puede ofrecer una configuración opcional de x_search con el mismo XAI_API_KEY y permitirle elegir un modelo x_search.
Kimi puede solicitar la región de la API de Moonshot (api.moonshot.ai vs api.moonshot.cn) y el modelo de búsqueda web predeterminado de Kimi.

Relacionado:

Referencia de configuración de Gateway: Configuration
CLI de configuración: Config

Opciones

--section <section>: filtro de sección repetible

Secciones disponibles:

workspace
model
web
gateway
daemon
channels
plugins
skills
health

Notas:

El asistente completo y las secciones relacionadas con el gateway preguntan dónde se ejecuta el Gateway y actualizan gateway.mode. Los filtros de sección que no incluyen gateway, daemon o health van directamente a la configuración solicitada.
Después de escribir la configuración local, configure instala los complementos descargables seleccionados cuando la ruta de configuración elegida los requiere. La configuración remota del Gateway no instala paquetes de complementos locales.
Los servicios orientados a canales (Slack/Discord/Matrix/Microsoft Teams) solicitan listas de permitidos (allowlists) de canales/salas durante la configuración. Puede ingresar nombres o ID; el asistente resuelve los nombres a ID cuando es posible.
Si ejecuta el paso de instalación del demonio, la autenticación de token requiere un token, y si gateway.auth.token está gestionado por SecretRef, configure valida el SecretRef pero no persiste los valores de token en texto sin formato resueltos en los metadatos del entorno del servicio supervisor.
Si la autenticación por token requiere un token y el SecretRef del token configurado no está resuelto, configure bloquea la instalación del demonio con una guía de remediation accionable.
Si tanto gateway.auth.token como gateway.auth.password están configurados y gateway.auth.mode no está establecido, configure bloquea la instalación del demonio hasta que el modo se establezca explícitamente.

Ejemplos

openclaw configure
openclaw configure --section web
openclaw configure --section model --section channels
openclaw configure --section gateway --section daemon