Saltar al contenido principal

​
openclaw configure

Solicitud interactiva para configurar credenciales, dispositivos y valores predeterminados del agente. Nota: La sección Model ahora incluye una selección múltiple para la lista de permitidos agents.defaults.models (lo que aparece en /model y en el selector de modelos). Cuando configure se inicia desde una opción de autenticación del proveedor, los selectores de modelo predeterminado y de lista de permitidos prefieren automáticamente ese proveedor. Para proveedores emparejados como Volcengine/BytePlus, esta misma preferencia también coincide con sus variantes de plan de código (volcengine-plan/*, byteplus-plan/*). Si el filtro del proveedor preferido produjera una lista vacía, configure recurre al catálogo sin filtrar en lugar de mostrar un selector vacío. Consejo: openclaw config sin subcomando abre el mismo asistente. Usa openclaw config get|set|unset para ediciones no interactivas. Para la búsqueda web, openclaw configure --section web te permite elegir un proveedor y configurar sus credenciales. Algunos proveedores también muestran solicitudes de seguimiento específicas del proveedor:
  • Grok puede ofrecer una configuración opcional de x_search con la misma XAI_API_KEY y permitirte elegir 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.
Relacionado:

​
Opciones

  • --section <section>: filtro de sección repetible
Secciones disponibles:
  • workspace
  • model
  • web
  • gateway
  • daemon
  • channels
  • plugins
  • skills
  • health
Notas:
  • Elegir dónde se ejecuta el Gateway siempre actualiza gateway.mode. Puedes seleccionar “Continue” sin otras secciones si eso es todo lo que necesitas.
  • Los servicios orientados a canales (Slack/Discord/Matrix/Microsoft Teams) solicitan listas de permitidos de canales/salas durante la configuración. Puedes introducir nombres o IDs; el asistente resuelve nombres a IDs cuando es posible.
  • Si ejecutas el paso de instalación del daemon, la autenticación por token requiere un token, y gateway.auth.token está gestionado por SecretRef; configure valida el SecretRef, pero no conserva valores de token en texto sin formato resueltos en los metadatos de 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 daemon con una guía de corrección 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 daemon 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