Automatización de la CLI con openclaw

Configurar herramientas manualmente cada vez que preparas un entorno nuevo es una pérdida de tiempo. Si intentas integrar procesos en tus scripts o simplemente quieres evitar pasar por menús interactivos una y otra vez, necesitas una forma directa de automatizar la configuración.

Para estas situaciones, mi recomendación es usar el flag --non-interactive. Esto permite que openclaw se configure solo sin esperar a que presiones ninguna tecla.

Requisitos previos

• CLI de openclaw instalada.
• API keys de tus proveedores (Anthropic, Gemini, etc.).
• Node.js (si usas el daemon-runtime de Node).

Inicio rápido

La forma más rápida de configurar openclaw onboard sin intervención manual es pasar todos los parámetros necesarios en una sola línea.

Usa este ejemplo base para una configuración local con Anthropic:

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

Si necesitas que la salida sea procesable por otras herramientas, añade el flag --json para obtener un resumen que las máquinas puedan leer.

Ejemplos por proveedor

Aquí tienes cómo configurar otros proveedores específicos de forma automática:

Gemini

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

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

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

Moonshot

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

Gestión de agentes adicionales

Puedes crear agentes separados con su propio workspace y perfiles de autenticación usando openclaw agents add <name>. Si ejecutas este comando sin el flag --workspace, se activará el asistente interactivo, así que asegúrate de incluirlo para automatizarlo.

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

Este comando configura automáticamente estos elementos:

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir
• bindings (para rutear mensajes entrantes)

Solución de problemas

El comando se detiene y pide datos aunque use --json Es un error común pensar que --json activa el modo automático. El flag --json solo cambia el formato de salida. Para evitar que la CLI te haga preguntas, debes usar obligatoriamente el flag --non-interactive.

Faltan parámetros en scripts Si usas scripts, asegúrate de incluir siempre --non-interactive y --workspace. Sin ellos, la CLI podría intentar abrir el asistente interactivo si detecta que falta alguna configuración necesaria.

Si necesitas ayuda personalizada para configurar tu entorno, consulta nuestro AI Setup Assistant.

Próximos pasos

• Onboarding Wizard (CLI)
• CLI Onboarding Reference
• Command reference: openclaw onboard