Guías

Automatización CLI

Usa --non-interactive para automatizar openclaw onboard.

ℹ️ --json no implica modo no interactivo. Usa --non-interactive (y --workspace) para scripts.

Ejemplo base no interactivo

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --secret-input-mode plaintext \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills

Añade --json para un resumen legible por máquina. Usa --secret-input-mode ref para almacenar referencias respaldadas por variables de entorno en los perfiles de autenticación en lugar de valores en texto plano. La selección interactiva entre referencias de entorno y referencias de proveedor configuradas (file o exec) está disponible en el flujo del asistente de incorporación. En el modo ref no interactivo, las variables de entorno del proveedor deben estar configuradas en el entorno del proceso. Pasar banderas de clave en línea sin la variable de entorno correspondiente ahora falla rápidamente. Ejemplo:

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice openai-api-key \
  --secret-input-mode ref \
  --accept-risk

Ejemplos específicos por proveedor

Añadir otro agente

Usa openclaw agents add <nombre> para crear un agente separado con su propio espacio de trabajo, sesiones y perfiles de autenticación. Ejecutar sin --workspace inicia el asistente.

openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.2 \
  --bind whatsapp:biz \
  --non-interactive \
  --json

Lo que configura:

  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir

Notas:

  • Los espacios de trabajo predeterminados siguen ~/.openclaw/workspace-<agentId>.
  • Añade bindings para enrutar mensajes entrantes (el asistente puede hacer esto).
  • Banderas no interactivas: --model, --agent-dir, --bind, --non-interactive.

Documentación relacionada

Referencia CLI