Automatización de CLI

Use --non-interactive para automatizar openclaw onboard.

Ejemplo no interactivo de línea base

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-bootstrap \
  --skip-skills

Añada --json para obtener un resumen legible por máquina.

Use --skip-bootstrap cuando su automatización precargue los archivos del espacio de trabajo y no desea que la incorporación cree los archivos de arranque predeterminados.

Use --secret-input-mode ref para almacenar referencias respaldadas por variables de entorno en perfiles de autenticación en lugar de valores de texto plano. La selección interactiva entre referencias de entorno y referencias de proveedor configuradas (file o exec) está disponible en el flujo de incorporación.

En el modo ref no interactivo, las variables de entorno del proveedor deben establecerse en el entorno del proceso. Pasar indicadores 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 del proveedor

Ejemplo de clave de API de Anthropic

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Ejemplo de Gemini

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice gemini-api-key \
  --gemini-api-key "$GEMINI_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Ejemplo de Z.AI

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice zai-api-key \
  --zai-api-key "$ZAI_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Ejemplo de Vercel AI Gateway

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Ejemplo de Cloudflare AI Gateway

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cloudflare-ai-gateway-api-key \
  --cloudflare-ai-gateway-account-id "your-account-id" \
  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Ejemplo de Moonshot

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice moonshot-api-key \
  --moonshot-api-key "$MOONSHOT_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Ejemplo de Mistral

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice mistral-api-key \
  --mistral-api-key "$MISTRAL_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Ejemplo sintético

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice synthetic-api-key \
  --synthetic-api-key "$SYNTHETIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Abrir ejemplo de código

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice opencode-zen \
  --opencode-zen-api-key "$OPENCODE_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Cambie a --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" para el catálogo de Go.

Ejemplo de Ollama

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ollama \
  --custom-model-id "qwen3.5:27b" \
  --accept-risk \
  --gateway-port 18789 \
  --gateway-bind loopback

Ejemplo de proveedor personalizado

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --custom-api-key "$CUSTOM_API_KEY" \
  --custom-provider-id "my-custom" \
  --custom-compatibility anthropic \
  --custom-image-input \
  --gateway-port 18789 \
  --gateway-bind loopback

--custom-api-key es opcional. Si se omite, el onboarding verifica CUSTOM_API_KEY. OpenClaw marca los IDs de modelos de visión comunes como con capacidad de imagen automáticamente. Agregue --custom-image-input para IDs de visión personalizados desconocidos, o --custom-text-input para forzar metadatos de solo texto.

Variante en modo de referencia:

export CUSTOM_API_KEY="your-key"
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --secret-input-mode ref \
  --custom-provider-id "my-custom" \
  --custom-compatibility anthropic \
  --custom-image-input \
  --gateway-port 18789 \
  --gateway-bind loopback

En este modo, el onboarding almacena apiKey como { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.

El token de configuración de Anthropic sigue disponible como una ruta de token de onboarding admitida, pero OpenClaw ahora prefiere reutilizar la CLI de Claude cuando está disponible. Para producción, prefiera una clave de API de Anthropic.

Agregar otro agente

Use openclaw agents add <name> 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.5 \
  --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>.
Agregue bindings para enrutar mensajes entrantes (el asistente puede hacer esto).
Marcas no interactivas: --model, --agent-dir, --bind, --non-interactive.

Documentos relacionados

Centro de onboarding: Onboarding (CLI)
Referencia completa: CLI Setup Reference
Referencia de comandos: openclaw onboard