English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Guides

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

Використовуйте --non-interactive, щоб автоматизувати openclaw onboard.

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

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --secret-input-mode plaintext \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-bootstrap \
  --skip-skills

Додайте --json для машинно-зчитуваного підсумку.

Використовуйте --skip-bootstrap, коли ваша автоматизація заздалегідь створює файли робочого простору й не хоче, щоб початкове налаштування створювало стандартні bootstrap-файли.

Використовуйте --secret-input-mode ref, щоб зберігати посилання на основі env у профілях автентифікації замість plaintext-значень. Інтерактивний вибір між посиланнями env і налаштованими посиланнями постачальника (file або exec) доступний у процесі початкового налаштування.

У неінтерактивному режимі ref змінні середовища постачальника мають бути встановлені в середовищі процесу. Передавання inline-прапорців ключа без відповідної змінної середовища тепер швидко завершується помилкою.

Приклад:

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice openai-api-key \
  --secret-input-mode ref \
  --accept-risk

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

Anthropic API key example 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
Gemini example 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice gemini-api-key \
  --gemini-api-key "$GEMINI_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
Z.AI example 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice zai-api-key \
  --zai-api-key "$ZAI_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
Vercel AI Gateway example 
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 example 
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
Moonshot example 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice moonshot-api-key \
  --moonshot-api-key "$MOONSHOT_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
Mistral example 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice mistral-api-key \
  --mistral-api-key "$MISTRAL_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
Synthetic example 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice synthetic-api-key \
  --synthetic-api-key "$SYNTHETIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
OpenCode example 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice opencode-zen \
  --opencode-zen-api-key "$OPENCODE_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Перейдіть на --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" для каталогу Go.

Ollama example 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ollama \
  --custom-model-id "qwen3.5:27b" \
  --accept-risk \
  --gateway-port 18789 \
  --gateway-bind loopback
Custom provider example 
openclaw onboard --non-interactive \
  --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-port 18789 \
  --gateway-bind loopback

--custom-api-key є необов’язковим. Якщо його пропущено, початкове налаштування перевіряє CUSTOM_API_KEY. OpenClaw автоматично позначає поширені ідентифікатори моделей із підтримкою зору як здатні обробляти зображення. Додайте --custom-image-input для невідомих користувацьких ідентифікаторів моделей із підтримкою зору або --custom-text-input, щоб примусово встановити метадані лише для тексту.

Варіант режиму посилань:

export CUSTOM_API_KEY="your-key"
openclaw onboard --non-interactive \
  --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-port 18789 \
  --gateway-bind loopback

У цьому режимі початкове налаштування зберігає apiKey як { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.

setup-token Anthropic залишається доступним як підтримуваний шлях токена початкового налаштування, але OpenClaw тепер віддає перевагу повторному використанню Claude CLI, коли воно доступне. Для production використовуйте ключ API Anthropic.

Додайте іншого агента

Використовуйте openclaw agents add <name>, щоб створити окремого агента з власним робочим простором, сесіями та профілями автентифікації. Запуск без --workspace відкриває майстер.

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

Що він задає:

  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir

Примітки:

  • Стандартні робочі простори відповідають ~/.openclaw/workspace-<agentId>.
  • Додайте bindings, щоб спрямовувати вхідні повідомлення (майстер може це зробити).
  • Неінтерактивні прапорці: --model, --agent-dir, --bind, --non-interactive.

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