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

Используйте --non-interactive для автоматизации openclaw onboard.

Примечание: Флаг --json не подразумевает неинтерактивный режим. Для скриптов используйте --non-interactive (и --workspace).

Базовый неинтерактивный пример

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-skills

Добавьте --json для машиночитаемого вывода.

Используйте --secret-input-mode ref для хранения ссылок на переменные окружения в профилях аутентификации вместо значений в открытом виде. В интерактивном режиме доступен выбор между ссылками на env-переменные и настроенными ссылками на провайдеров (file или exec).

В неинтерактивном режиме ref переменные окружения провайдеров должны быть установлены в среде процесса. Передача инлайн-ключей без соответствующей переменной окружения приводит к немедленной ошибке.

Пример:

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

Примеры для конкретных провайдеров

Gemini

```bash
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

```bash
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

```bash
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

```bash
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

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice moonshot-api-key \
  --moonshot-api-key "$MOONSHOT_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
```

Mistral

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice mistral-api-key \
  --mistral-api-key "$MISTRAL_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
```

Synthetic

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice synthetic-api-key \
  --synthetic-api-key "$SYNTHETIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
```

OpenCode

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice opencode-zen \
  --opencode-zen-api-key "$OPENCODE_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
```
Для каталога Go замените на `--auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY"`.

Ollama

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ollama \
  --custom-model-id "qwen3.5:27b" \
  --accept-risk \
  --gateway-port 18789 \
  --gateway-bind loopback
```

Пользовательский провайдер

```bash
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 \
  --gateway-port 18789 \
  --gateway-bind loopback
```

Флаг `--custom-api-key` необязателен. Если опущен, онбординг проверяет переменную `CUSTOM_API_KEY`.

Вариант с режимом ссылок:

```bash
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 \
  --gateway-port 18789 \
  --gateway-bind loopback
```

В этом режиме онбординг сохраняет `apiKey` как `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`.

Добавление нового агента

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

openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.2 \
  --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.

Связанные документы

Хаб онбординга: Мастер онбординга (CLI)
Полный справочник: Справочник CLI-онбординга
Справочник команды: openclaw onboard