OpenClawDocs
Op deze pagina

Op deze pagina

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

Setup guides and reference

CLI-automatisering

Gebruik openclaw onboard --non-interactive voor installatie via scripts. Hiervoor is --accept-risk vereist: een niet-interactieve installatie kan referenties en daemonconfiguratie zonder bevestigingsprompt schrijven, dus de 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 ingesteld op 18789; geef dit 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 een door een omgevingsvariabele ondersteunde verwijzing ({ source: "env", provider: "default", id: "<ENV_VAR>" }) op in het authenticatieprofiel 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

Schakel over naar --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. Als dit wordt weggelaten, controleert het onboardingproces CUSTOM_API_KEY in de omgeving. --custom-provider-id is optioneel en wordt bij weglating automatisch afgeleid van de basis-URL. --custom-compatibility is standaard ingesteld op openai (andere waarden: openai-responses, anthropic).

OpenClaw leidt ondersteuning voor afbeeldingsinvoer af uit bekende patronen voor vision-model-id's (gpt-4o, claude-3/4, gemini, achtervoegsels -vl/vision en vergelijkbare patronen). Voeg --custom-image-input toe om dit voor een niet-herkend vision-model geforceerd in te schakelen, of --custom-text-input om alleen tekst af te dwingen.

Variant in verwijzingsmodus, waarbij apiKey als { source: "env", provider: "default", id: "CUSTOM_API_KEY" } wordt opgeslagen:

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-installatietoken blijft ondersteund, maar OpenClaw geeft de voorkeur aan hergebruik van de Claude CLI wanneer lokaal een Claude CLI-aanmelding beschikbaar is. Geef voor productie de voorkeur aan een Anthropic API-sleutel.

Nog een agent toevoegen

openclaw agents add <name> maakt een afzonderlijke agent met een eigen werkruimte, sessies en authenticatieprofielen. Als je dit uitvoert zonder --workspace (en zonder andere vlaggen), wordt de interactieve wizard gestart; als je een van --workspace, --model, --agent-dir, --bind of --non-interactive doorgeeft, wordt de opdracht niet-interactief uitgevoerd en is vervolgens --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.entries.*-item voor de nieuwe agent-id):

  • 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 worden herhaald; voeg bindingen toe om inkomende berichten naar de nieuwe agent te routeren (dit kan ook interactief via de wizard).
  • De agentnaam wordt genormaliseerd tot een geldige agent-id; main is gereserveerd.

Gerelateerde documentatie

Was this useful?