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

Guides

Автоматизація CLI

Використовуйте openclaw onboard --non-interactive для автоматизації налаштування за допомогою скриптів. Для цієї команди потрібен прапорець --accept-risk: неінтерактивне налаштування може записувати облікові дані та конфігурацію демона без запиту на підтвердження, тому цей прапорець є явним підтвердженням прийняття ризику.

Базовий приклад неінтерактивного налаштування

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

Додайте --json, щоб отримати зведення у форматі, придатному для машинного читання.

  • Типове значення --gateway-port — 18789; передавайте цей прапорець лише для перевизначення.
  • --skip-bootstrap пропускає створення типових файлів робочого простору для автоматизації, яка попередньо заповнює власний робочий простір.
  • --secret-input-mode ref зберігає в профілі автентифікації посилання на змінну середовища ({ source: "env", provider: "default", id: "<ENV_VAR>" }) замість ключа у вигляді відкритого тексту. У неінтерактивному режимі ref змінну середовища постачальника вже має бути задано в середовищі процесу: передавання прапорця з ключем без відповідної змінної середовища негайно завершується помилкою.
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref

Приклади для окремих постачальників

Приклад із ключем API Anthropic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --gateway-bind loopback
Приклад із 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
Приклад із Gemini
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY" \  --gateway-bind loopback
Приклад із Mistral
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY" \  --gateway-bind loopback
Приклад із Moonshot
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice moonshot-api-key \  --moonshot-api-key "$MOONSHOT_API_KEY" \  --gateway-bind loopback
Приклад із Ollama
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ollama \  --custom-model-id "qwen3.5:27b" \  --gateway-bind loopback
Приклад із OpenCode
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice opencode-zen \  --opencode-zen-api-key "$OPENCODE_API_KEY" \  --gateway-bind loopback

Для каталогу Go замініть на --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY".

Приклад із Synthetic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice synthetic-api-key \  --synthetic-api-key "$SYNTHETIC_API_KEY" \  --gateway-bind loopback
Приклад із 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
Приклад із 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
Приклад із власним постачальником
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 є необов’язковим: деякі кінцеві точки не потребують автентифікації. Якщо його не вказано, під час початкового налаштування перевіряється наявність CUSTOM_API_KEY у середовищі. --custom-provider-id є необов’язковим і, якщо його не вказано, автоматично визначається з базової URL-адреси. Типове значення --custom-compatibility — openai (інші значення: openai-responses, anthropic).

OpenClaw визначає підтримку зображень як вхідних даних за відомими шаблонами ідентифікаторів моделей із підтримкою зору (gpt-4o, claude-3/4, gemini, суфікси -vl/vision тощо). Додайте --custom-image-input, щоб примусово ввімкнути її для нерозпізнаної моделі з підтримкою зору, або --custom-text-input, щоб примусово дозволити лише текст.

Варіант режиму ref, який зберігає apiKey як { 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

Автентифікація за допомогою токена налаштування Anthropic залишається підтримуваною, але OpenClaw надає перевагу повторному використанню Claude CLI, коли доступний локальний вхід у Claude CLI. Для робочого середовища віддавайте перевагу ключу API Anthropic.

Додавання іншого агента

openclaw agents add <name> створює окремого агента з власним робочим простором, сеансами та профілями автентифікації. Запуск без --workspace (та без інших прапорців) відкриває інтерактивний майстер; передавання будь-якого з прапорців --workspace, --model, --agent-dir, --bind або --non-interactive запускає команду неінтерактивно, після чого --workspace стає обов’язковим.

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

Ключі конфігурації, які записує команда (запис agents.list[] для ідентифікатора нового агента):

  • name
  • workspace
  • agentDir
  • model (лише коли передано --model)

Примітки:

  • Типовий робочий простір (якщо в інтерактивному майстрі не вказано --workspace): ~/.openclaw/workspace-<agentId>.
  • --bind <channel[:accountId]> можна передавати кілька разів; додайте прив’язки, щоб спрямовувати вхідні повідомлення новому агенту (це також можна зробити інтерактивно в майстрі).
  • Ім’я агента нормалізується до коректного ідентифікатора агента; main зарезервовано.

Пов’язана документація

Was this useful?
On this page

On this page