Skip to main content
Use openclaw onboard --non-interactive para automatizar la configuración mediante scripts. Requiere --accept-risk: la configuración no interactiva puede escribir credenciales y la configuración del daemon sin una solicitud de confirmación, por lo que la opción constituye el reconocimiento explícito del riesgo.
--json no implica el modo no interactivo. Pase --non-interactive --accept-risk explícitamente para los scripts.

​
Ejemplo básico no interactivo

Añada --json para obtener un resumen legible por máquina.
  • --gateway-port usa 18789 de forma predeterminada; páselo solo para sustituir ese valor.
  • --skip-bootstrap omite la creación de los archivos predeterminados del espacio de trabajo, para automatizaciones que preparan previamente su propio espacio de trabajo.
  • --secret-input-mode ref almacena una referencia respaldada por una variable de entorno ({ source: "env", provider: "default", id: "<ENV_VAR>" }) en el perfil de autenticación en lugar de la clave en texto sin formato. En el modo ref no interactivo, la variable de entorno del proveedor ya debe estar definida en el entorno del proceso: pasar una opción de clave en línea sin su variable de entorno correspondiente produce un error inmediato.

​
Ejemplos específicos de proveedores

Cambie a --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" para usar el catálogo de Go.
--custom-api-key es opcional; algunos endpoints no requieren autenticación. Si se omite, la incorporación comprueba CUSTOM_API_KEY en el entorno. --custom-provider-id es opcional y, cuando se omite, se deriva automáticamente de la URL base. --custom-compatibility usa openai de forma predeterminada (otros valores: openai-responses, anthropic).OpenClaw infiere la compatibilidad con la entrada de imágenes a partir de patrones conocidos de identificadores de modelos de visión (gpt-4o, claude-3/4, gemini, sufijos -vl/vision y similares). Añada --custom-image-input para activarla de forma forzada en un modelo de visión no reconocido, o --custom-text-input para forzar el uso exclusivo de texto.Variante del modo de referencia, que almacena apiKey como { source: "env", provider: "default", id: "CUSTOM_API_KEY" }:
La autenticación mediante token de configuración de Anthropic sigue siendo compatible, pero OpenClaw prefiere reutilizar la CLI de Claude cuando hay disponible un inicio de sesión local en dicha CLI. Para producción, se recomienda usar una clave de API de Anthropic.

​
Añadir otro agente

openclaw agents add <name> crea un agente independiente con su propio espacio de trabajo, sus propias sesiones y sus propios perfiles de autenticación. Ejecutarlo sin --workspace (y sin otras opciones) inicia el asistente interactivo; pasar cualquiera de --workspace, --model, --agent-dir, --bind o --non-interactive lo ejecuta de forma no interactiva y requiere además --workspace.
Claves de configuración que escribe (entrada agents.entries.* para el identificador del nuevo agente):
  • name
  • workspace
  • agentDir
  • model (solo cuando se pasa --model)
Notas:
  • Espacio de trabajo predeterminado (cuando se omite --workspace en el asistente interactivo): ~/.openclaw/workspace-<agentId>.
  • --bind <channel[:accountId]> se puede repetir; añada vinculaciones para dirigir los mensajes entrantes al nuevo agente (el asistente también permite hacerlo de forma interactiva).
  • El nombre del agente se normaliza como un identificador de agente válido; main está reservado.

​
Documentación relacionada