​

Referencia de configuración de la CLI

​

Qué hace el asistente

• Configuración del modelo y la autenticación (OAuth de suscripción de OpenAI Code, Anthropic Claude CLI o clave de API, además de opciones para MiniMax, GLM, Ollama, Moonshot, StepFun y AI Gateway)
• Ubicación del workspace y archivos de arranque
• Configuración de Gateway (puerto, bind, autenticación, Tailscale)
• Canales y proveedores (Telegram, WhatsApp, Discord, Google Chat, Mattermost, Signal, BlueBubbles y otros plugins de canal incluidos)
• Instalación como daemon (LaunchAgent, unidad de usuario de systemd o Scheduled Task nativa de Windows con alternativa en la carpeta de Inicio)
• Comprobación de estado
• Configuración de Skills

​

Detalles del flujo local

​

Detalles del modo remoto

• URL del Gateway remoto (ws://...)
• Token si la autenticación del Gateway remoto es obligatoria (recomendado)

​

Opciones de autenticación y modelo

• Elige el modelo predeterminado entre las opciones detectadas, o introduce manualmente el proveedor y el modelo.
• Cuando la incorporación comienza desde una opción de autenticación de proveedor, el selector de modelos prioriza automáticamente ese proveedor. Para Volcengine y BytePlus, esa misma preferencia también coincide con sus variantes de plan de codificación (volcengine-plan/*, byteplus-plan/*).
• Si ese filtro de proveedor preferido quedara vacío, el selector vuelve al catálogo completo en lugar de no mostrar modelos.
• El asistente ejecuta una comprobación del modelo y advierte si el modelo configurado es desconocido o le falta autenticación.

• Perfiles de autenticación (claves de API + OAuth): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• Importación heredada de OAuth: ~/.openclaw/credentials/oauth.json

• El comportamiento predeterminado de incorporación guarda las claves de API como valores en texto plano en los perfiles de autenticación.
• --secret-input-mode ref habilita el modo de referencia en lugar del almacenamiento de claves en texto plano. En la configuración interactiva, puedes elegir cualquiera de estos:
  • referencia a variable de entorno (por ejemplo keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" })
  • referencia a proveedor configurado (file o exec) con alias e id del proveedor
• El modo de referencia interactivo ejecuta una validación previa rápida antes de guardar.
  • Referencias de entorno: valida el nombre de la variable y que tenga un valor no vacío en el entorno actual de incorporación.
  • Referencias de proveedor: valida la configuración del proveedor y resuelve el id solicitado.
  • Si la validación previa falla, la incorporación muestra el error y te permite reintentar.
• En modo no interactivo, --secret-input-mode ref solo se respalda con entorno.
  • Establece la variable de entorno del proveedor en el entorno del proceso de incorporación.
  • Los indicadores de clave en línea (por ejemplo --openai-api-key) requieren que esa variable de entorno esté configurada; de lo contrario, la incorporación falla de inmediato.
  • Para proveedores personalizados, el modo no interactivo ref almacena models.providers.<id>.apiKey como { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.
  • En ese caso de proveedor personalizado, --custom-api-key requiere que CUSTOM_API_KEY esté configurada; de lo contrario, la incorporación falla de inmediato.
• Las credenciales de autenticación de Gateway admiten opciones de texto plano y SecretRef en la configuración interactiva:
  • Modo token: Generar/almacenar token en texto plano (predeterminado) o Usar SecretRef.
  • Modo contraseña: texto plano o SecretRef.
• Ruta no interactiva de SecretRef para token: --gateway-token-ref-env <ENV_VAR>.
• Las configuraciones existentes en texto plano siguen funcionando sin cambios.

​

Salidas y aspectos internos

• agents.defaults.workspace
• agents.defaults.model / models.providers (si se eligió Minimax)
• tools.profile (la incorporación local usa por defecto "coding" cuando no está configurado; los valores explícitos existentes se conservan)
• gateway.* (modo, bind, autenticación, Tailscale)
• session.dmScope (la incorporación local establece por defecto este valor en per-channel-peer cuando no está configurado; los valores explícitos existentes se conservan)
• channels.telegram.botToken, channels.discord.token, channels.matrix.*, channels.signal.*, channels.imessage.*
• Listas permitidas de canales (Slack, Discord, Matrix, Microsoft Teams) cuando optas por ellas durante los prompts (los nombres se resuelven a IDs cuando es posible)
• skills.install.nodeManager
  • El indicador setup --node-manager acepta npm, pnpm o bun.
  • La configuración manual aún puede establecer después skills.install.nodeManager: "yarn".
• wizard.lastRunAt
• wizard.lastRunVersion
• wizard.lastRunCommit
• wizard.lastRunCommand
• wizard.lastRunMode

• wizard.start
• wizard.next
• wizard.cancel
• wizard.status

• Descarga el recurso de la versión correspondiente
• Lo almacena en ~/.openclaw/tools/signal-cli/<version>/
• Escribe channels.signal.cliPath en la configuración
• Las compilaciones JVM requieren Java 21
• Las compilaciones nativas se usan cuando están disponibles
• Windows usa WSL2 y sigue el flujo de signal-cli de Linux dentro de WSL

​

Documentación relacionada

• Centro de incorporación: Onboarding (CLI)
• Automatización y scripts: CLI Automation
• Referencia de comandos: openclaw onboard