OpenClawDocs
Na tej stronie

Na tej stronie

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

Setup guides and reference

Automatyzacja CLI

Użyj openclaw onboard --non-interactive, aby oskryptować konfigurację. Wymaga to opcji --accept-risk: konfiguracja nieinteraktywna może zapisywać dane uwierzytelniające i konfigurację demona bez monitu o potwierdzenie, dlatego ta opcja stanowi wyraźne potwierdzenie akceptacji ryzyka.

Podstawowy przykład konfiguracji nieinteraktywnej

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

Dodaj --json, aby uzyskać podsumowanie w formacie przeznaczonym do przetwarzania maszynowego.

  • Domyślna wartość --gateway-port to 18789; przekaż tę opcję tylko wtedy, gdy chcesz ją zastąpić.
  • Opcja --skip-bootstrap pomija tworzenie domyślnych plików obszaru roboczego na potrzeby automatyzacji, która wstępnie przygotowuje własny obszar roboczy.
  • Opcja --secret-input-mode ref zapisuje w profilu uwierzytelniania odwołanie oparte na zmiennej środowiskowej ({ source: "env", provider: "default", id: "<ENV_VAR>" }) zamiast klucza w postaci zwykłego tekstu. W nieinteraktywnym trybie ref zmienna środowiskowa dostawcy musi być już ustawiona w środowisku procesu: przekazanie opcji klucza bezpośrednio w wierszu poleceń bez odpowiadającej jej zmiennej środowiskowej powoduje natychmiastowe niepowodzenie.
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref

Przykłady dla poszczególnych dostawców

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

Aby użyć katalogu Go, zastąp tę opcję przez --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY".

Przykład Synthetic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice synthetic-api-key \  --synthetic-api-key "$SYNTHETIC_API_KEY" \  --gateway-bind loopback
Przykład 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
Przykład 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
Przykład niestandardowego dostawcy
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

Opcja --custom-api-key jest opcjonalna; niektóre punkty końcowe nie wymagają uwierzytelniania. Jeśli ją pominięto, proces wdrażania sprawdza zmienną CUSTOM_API_KEY w środowisku. Opcja --custom-provider-id jest opcjonalna, a po jej pominięciu identyfikator jest automatycznie wyprowadzany z bazowego adresu URL. Domyślna wartość --custom-compatibility to openai (pozostałe wartości: openai-responses, anthropic).

OpenClaw rozpoznaje obsługę danych wejściowych w postaci obrazów na podstawie znanych wzorców identyfikatorów modeli wizyjnych (gpt-4o, claude-3/4, gemini, przyrostki -vl/vision i podobne). Dodaj --custom-image-input, aby wymusić jej włączenie dla nierozpoznanego modelu wizyjnego, albo --custom-text-input, aby wymusić obsługę wyłącznie tekstu.

Wariant trybu odwołania, zapisujący apiKey jako { 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

Uwierzytelnianie za pomocą tokenu konfiguracyjnego Anthropic jest nadal obsługiwane, ale OpenClaw preferuje ponowne użycie CLI Claude, gdy dostępne jest lokalne logowanie w CLI Claude. W środowisku produkcyjnym preferuj klucz API Anthropic.

Dodawanie kolejnego agenta

Polecenie openclaw agents add <name> tworzy osobnego agenta z własnym obszarem roboczym, sesjami i profilami uwierzytelniania. Uruchomienie go bez opcji --workspace (i bez żadnych innych opcji) uruchamia interaktywny kreator; przekazanie dowolnej z opcji --workspace, --model, --agent-dir, --bind lub --non-interactive uruchamia polecenie nieinteraktywnie, co wymaga podania opcji --workspace.

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

Zapisywane klucze konfiguracji (wpis agents.list[] dla identyfikatora nowego agenta):

  • name
  • workspace
  • agentDir
  • model (tylko gdy przekazano --model)

Uwagi:

  • Domyślny obszar roboczy (gdy w interaktywnym kreatorze pominięto --workspace): ~/.openclaw/workspace-<agentId>.
  • Opcję --bind <channel[:accountId]> można podać wielokrotnie; dodaj powiązania, aby kierować wiadomości przychodzące do nowego agenta (można to również zrobić interaktywnie w kreatorze).
  • Nazwa agenta jest normalizowana do prawidłowego identyfikatora agenta; main jest zarezerwowane.

Powiązana dokumentacja

Was this useful?