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

Guides

CLI-automatisering

Gebruik openclaw onboard --non-interactive om de configuratie te scripten. Hiervoor is --accept-risk vereist: niet-interactieve configuratie kan aanmeldgegevens en daemonconfiguratie wegschrijven zonder bevestigingsprompt, dus deze vlag is de expliciete erkenning van het risico.

Niet-interactief basisvoorbeeld

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

Voeg --json toe voor een machineleesbare samenvatting.

  • --gateway-port is standaard 18789; geef deze optie alleen door om de standaardwaarde te overschrijven.
  • --skip-bootstrap slaat het aanmaken van standaardwerkruimtebestanden over, voor automatisering die vooraf een eigen werkruimte vult.
  • --secret-input-mode ref slaat in het authenticatieprofiel een door een omgevingsvariabele ondersteunde verwijzing ({ source: "env", provider: "default", id: "<ENV_VAR>" }) op in plaats van de sleutel als platte tekst. In de niet-interactieve ref-modus moet de omgevingsvariabele van de provider al in de procesomgeving zijn ingesteld: het doorgeven van een inline sleutelvlag zonder de bijbehorende omgevingsvariabele mislukt onmiddellijk.
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref

Providerspecifieke voorbeelden

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

Gebruik --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" voor de Go-catalogus.

Voorbeeld met Synthetic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice synthetic-api-key \  --synthetic-api-key "$SYNTHETIC_API_KEY" \  --gateway-bind loopback
Voorbeeld met 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
Voorbeeld met 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
Voorbeeld met een aangepaste provider
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 is optioneel; sommige eindpunten vereisen geen authenticatie. Wanneer deze optie wordt weggelaten, controleert het onboardingproces de omgevingsvariabele CUSTOM_API_KEY. --custom-provider-id is optioneel en wordt bij weglating automatisch afgeleid van de basis-URL. --custom-compatibility is standaard openai (andere waarden: openai-responses, anthropic).

OpenClaw leidt ondersteuning voor beeldinvoer af uit bekende patronen voor model-ID's van beeldmodellen (gpt-4o, claude-3/4, gemini, de achtervoegsels -vl/vision en vergelijkbare patronen). Voeg --custom-image-input toe om deze ondersteuning af te dwingen voor een niet-herkend beeldmodel, of --custom-text-input om alleen tekst af te dwingen.

Variant voor de verwijzingsmodus, waarbij apiKey wordt opgeslagen als { 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

Authenticatie met een Anthropic-configuratietoken blijft ondersteund, maar OpenClaw geeft de voorkeur aan hergebruik van de Claude CLI wanneer lokaal een Claude CLI-aanmelding beschikbaar is. Gebruik voor productie bij voorkeur een Anthropic API-sleutel.

Nog een agent toevoegen

openclaw agents add <name> maakt een afzonderlijke agent met een eigen werkruimte, sessies en authenticatieprofielen. Als u deze opdracht zonder --workspace (en zonder andere vlaggen) uitvoert, wordt de interactieve wizard gestart; als u --workspace, --model, --agent-dir, --bind of --non-interactive doorgeeft, wordt de opdracht niet-interactief uitgevoerd en is --workspace vereist.

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

Configuratiesleutels die worden geschreven (agents.list[]-vermelding voor het ID van de nieuwe agent):

  • name
  • workspace
  • agentDir
  • model (alleen wanneer --model wordt doorgegeven)

Opmerkingen:

  • Standaardwerkruimte (wanneer --workspace in de interactieve wizard wordt weggelaten): ~/.openclaw/workspace-<agentId>.
  • --bind <channel[:accountId]> kan meerdere keren worden gebruikt; voeg bindingen toe om inkomende berichten naar de nieuwe agent te routeren (dit kan ook interactief in de wizard).
  • De naam van de agent wordt genormaliseerd naar een geldig agent-ID; main is gereserveerd.

Gerelateerde documentatie

Was this useful?
On this page

On this page