Guides

Automatización de la CLI

Use --non-interactive para automatizar openclaw onboard.

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

Agrega --json para obtener un resumen legible por máquina.

Usa --skip-bootstrap cuando tu automatización precargue archivos de espacio de trabajo y no quieras que la incorporación cree los archivos bootstrap predeterminados.

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

En modo ref no interactivo, las variables env del proveedor deben estar definidas en el entorno del proceso. Pasar flags de clave en línea sin la variable env correspondiente ahora falla rápido.

Ejemplo:

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

Ejemplos específicos de 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 de Synthetic

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

Ejemplo de OpenCode

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

Cambia 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, la incorporación comprueba CUSTOM_API_KEY. OpenClaw marca automáticamente los ID de modelo de visión comunes como compatibles con imágenes. Agrega --custom-image-input para ID de visión personalizados desconocidos, o --custom-text-input para forzar metadatos solo de texto.

Variante en modo ref:

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, la incorporación almacena apiKey como { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.

El setup-token de Anthropic sigue disponible como ruta de token de incorporación compatible, pero OpenClaw ahora prefiere reutilizar Claude CLI cuando esté disponible. Para producción, prefiere una clave de API de Anthropic.

Agregar otro agente

Usa openclaw agents add <name> para crear un agente separado con su propio espacio de trabajo, sesiones y perfiles de autenticación. Ejecutarlo 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 define:

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

Notas:

Los espacios de trabajo predeterminados siguen ~/.openclaw/workspace-<agentId>.
Agrega bindings para enrutar mensajes entrantes (el asistente puede hacerlo).
Flags no interactivos: --model, --agent-dir, --bind, --non-interactive.

Documentos relacionados

Centro de incorporación: Incorporación (CLI)
Referencia completa: Referencia de configuración de CLI
Referencia de comandos: openclaw onboard

# Ejemplo base no interactivo

# Ejemplos específicos de proveedor

# Agregar otro agente

# Documentos relacionados

Ejemplo base no interactivo

Ejemplos específicos de proveedor

Agregar otro agente

Documentos relacionados