OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Guides

Automatización de la CLI

Usa 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 solicitar confirmación, por lo que esta opción constituye la aceptación explícita del riesgo.

Ejemplo básico no interactivo

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

Añade --json para obtener un resumen legible por máquinas.

  • --gateway-port usa 18789 de forma predeterminada; pásalo únicamente para sustituir ese valor.
  • --skip-bootstrap omite la creación de los archivos predeterminados del espacio de trabajo, para automatizaciones que preparan de antemano su propio espacio de trabajo.
  • --secret-input-mode ref almacena en el perfil de autenticación una referencia respaldada por una variable de entorno ({ source: "env", provider: "default", id: "<ENV_VAR>" }) en lugar de la clave en texto sin formato. En el modo no interactivo ref, 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 provoca un fallo inmediato.
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref

Ejemplos específicos de proveedores

Ejemplo con una clave de API de Anthropic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --gateway-bind loopback
Ejemplo con Cloudflare AI Gateway
bash
openclaw onboard --non-interactive --accept-risk \  --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-bind loopback
Ejemplo con Gemini
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY" \  --gateway-bind loopback
Ejemplo con Mistral
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY" \  --gateway-bind loopback
Ejemplo con Moonshot
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice moonshot-api-key \  --moonshot-api-key "$MOONSHOT_API_KEY" \  --gateway-bind loopback
Ejemplo con Ollama
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ollama \  --custom-model-id "qwen3.5:27b" \  --gateway-bind loopback
Ejemplo con OpenCode
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice opencode-zen \  --opencode-zen-api-key "$OPENCODE_API_KEY" \  --gateway-bind loopback

Sustituye esta opción por --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" para usar el catálogo de Go.

Ejemplo con Synthetic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice synthetic-api-key \  --synthetic-api-key "$SYNTHETIC_API_KEY" \  --gateway-bind loopback
Ejemplo con Vercel AI Gateway
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ai-gateway-api-key \  --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \  --gateway-bind loopback
Ejemplo con Z.AI
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice zai-api-key \  --zai-api-key "$ZAI_API_KEY" \  --gateway-bind loopback
Ejemplo con un proveedor personalizado
bash
openclaw onboard --non-interactive --accept-risk \  --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-bind loopback

--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, si se omite, se deriva automáticamente de la URL base. El valor predeterminado de --custom-compatibility es openai (otros valores: openai-responses, anthropic).

OpenClaw deduce 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ñade --custom-image-input para forzar su activación en un modelo de visión no reconocido, o --custom-text-input para forzar que solo admita texto.

Variante del modo ref, que almacena apiKey como { source: "env", provider: "default", id: "CUSTOM_API_KEY" }:

bash
export CUSTOM_API_KEY="your-key"openclaw onboard --non-interactive --accept-risk \  --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-bind loopback

La autenticación mediante un token de configuración de Anthropic sigue siendo compatible, pero OpenClaw prefiere reutilizar la CLI de Claude cuando existe una sesión local disponible en ella. Para producción, es preferible 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, sesiones y perfiles de autenticación. Si se ejecuta sin --workspace (y sin ninguna otra opción), inicia el asistente interactivo; pasar cualquiera de las opciones --workspace, --model, --agent-dir, --bind o --non-interactive hace que se ejecute de forma no interactiva y, en ese caso, requiere --workspace.

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

Claves de configuración que escribe (entrada agents.list[] correspondiente al 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]> puede repetirse; añade vinculaciones para dirigir los mensajes entrantes al nuevo agente (el asistente también permite hacerlo de forma interactiva).
  • El nombre del agente se normaliza para convertirlo en un identificador de agente válido; main está reservado.

Documentación relacionada

Was this useful?
On this page

On this page