Automatización CLI

Usa --non-interactive para automatizar openclaw onboard.

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

Ejemplo básico 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 obtener un resumen en formato legible por máquinas.

Usa --secret-input-mode ref para almacenar referencias respaldadas por variables de entorno en los perfiles de auth en lugar de valores en texto plano. En el flujo del asistente de onboarding interactivo, puedes elegir entre referencias de entorno y referencias de proveedor configuradas (file o exec).

En modo no interactivo con ref, las variables de entorno del proveedor deben estar definidas en el entorno del proceso. Pasar flags de key inline sin la variable de entorno correspondiente ahora falla inmediatamente.

Ejemplo:

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

Ejemplos por proveedor

Ejemplo con Gemini

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

Ejemplo con Z.AI

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

Ejemplo con Vercel AI Gateway

```bash
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 con Cloudflare AI Gateway

```bash
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 con Moonshot

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

Ejemplo con Mistral

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

Ejemplo con Synthetic

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

Ejemplo con OpenCode

```bash
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 Go.

Ejemplo con Ollama

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

Ejemplo con proveedor personalizado

```bash
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 \
  --gateway-port 18789 \
  --gateway-bind loopback
```

`--custom-api-key` es opcional. Si se omite, el onboarding busca `CUSTOM_API_KEY`.

Variante en modo ref:

```bash
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 \
  --gateway-port 18789 \
  --gateway-bind loopback
```

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

Añadir otro agente

Usa openclaw agents add <nombre> para crear un agente independiente con su propio workspace, sesiones y perfiles de auth. Ejecutarlo sin --workspace lanza el asistente.

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

Qué configura:

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

Notas:

Los workspaces por defecto siguen el patrón ~/.openclaw/workspace-<agentId>.
Añade bindings para enrutar mensajes entrantes (el asistente puede hacerlo).
Flags no interactivos: --model, --agent-dir, --bind, --non-interactive.

Documentación relacionada

Hub de onboarding: Asistente de onboarding (CLI)
Referencia completa: Referencia del onboarding CLI
Referencia del comando: openclaw onboard