openclaw CLI-Automatisierung

Manuelle Konfigurationen sind nervig, wenn du eigentlich nur schnell eine neue Umgebung aufsetzen oder ein Tool in deine CI/CD-Pipeline integrieren willst. Niemand möchte sich durch einen Wizard klicken, wenn die Parameter bereits feststehen. Es ist effizienter, den Prozess zu scripten und direkt zum produktiven Teil überzugehen.

Wenn du openclaw in Scripts verwendest, solltest du den Prozess automatisieren, um manuelle Eingaben zu vermeiden.

Voraussetzungen

• Installierte openclaw CLI
• API Keys für deine Provider (z. B. Anthropic, Gemini oder Moonshot)

Schnellstart

Verwende das Flag --non-interactive, um openclaw onboard ohne Benutzereingaben auszuführen. Ein wichtiger Punkt: Das Flag --json sorgt zwar für eine maschinenlesbare Ausgabe, deaktiviert aber nicht die interaktiven Abfragen. Für Scripte musst du zwingend --non-interactive (und idealerweise --workspace) nutzen.

Baseline Beispiel (non-interactive)

Hier ist ein Beispiel für ein lokales Setup mit 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

Du kannst --json anhängen, um am Ende eine strukturierte Zusammenfassung zu erhalten.

Provider-Beispiele

Je nach Provider ändern sich die benötigten Flags. Hier sind die gängigsten Varianten:

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

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

Moonshot

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

Synthetic

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

OpenCode Zen

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

Weitere Agents hinzufügen

Mit dem Befehl openclaw agents add <name> erstellst du separate Agents, die eigene Workspaces, Sessions und Auth-Profile nutzen. Ohne das Flag --workspace startet die CLI automatisch den interaktiven Wizard.

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

Dieser Befehl konfiguriert folgende Punkte automatisch:

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir
• Standard-Workspaces unter ~/.openclaw/workspace-<agentId>

Für die Automatisierung sind die Flags --model, --agent-dir, --bind und --non-interactive entscheidend.

Fehlerbehebung

Problem: Die CLI fragt trotz des --json Flags nach Eingaben. Lösung: Das --json Flag allein deaktiviert die Interaktivität nicht. Du musst zusätzlich das Flag --non-interactive verwenden.

AI Setup Assistant

Nächste Schritte

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