CLI Automation — автоматизация настройки через CLI в OpenClaw

В этом разделе описано, как автоматизировать настройку OpenClaw с помощью CLI, избегая интерактивного мастера и используя скрипты для развертывания и управления агентами.

Автоматизация onboarding через CLI

Для автоматизации процесса первоначальной настройки используйте флаг --non-interactive вместе с командой openclaw onboard. Это позволяет запускать конфигурацию без взаимодействия с пользователем.

openclaw onboard --non-interactive \
 --mode local \
 --auth-choice apiKey \
 --anthropic-api-key "$ANTHROPIC_API_KEY" \
 --gateway-port 18789 \
 --gateway-bind loopback

Важно учитывать:

• Флаг --json не делает команду неинтерактивной.
• Для полной автоматизации всегда используйте --non-interactive.
• Часто требуется также указать --workspace.

Работа с переменными окружения

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

Пример:

--anthropic-api-key "$ANTHROPIC_API_KEY"

Если используется режим ref, значения будут храниться как ссылки на переменные окружения, а не в открытом виде.

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

OpenClaw поддерживает различные провайдеры. Ниже приведены примеры настройки.

Gemini

openclaw onboard --non-interactive \
 --mode local \
 --auth-choice gemini-api-key \
 --gemini-api-key "$GEMINI_API_KEY" \
 --gateway-port 18789 \
 --gateway-bind loopback

Cloudflare AI Gateway

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

Другие провайдеры

Аналогичным образом можно настроить:

• Mistral
• Moonshot
• Z.AI
• Synthetic
• OpenCode

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

Вы можете создавать отдельных агентов с собственными рабочими пространствами, сессиями и профилями авторизации.

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

Эта команда задаёт:

• Имя агента
• Рабочее пространство
• Каталог агента

Если не указать параметр --workspace, будет запущен интерактивный мастер.

Распространённые ошибки

Разработчики часто сталкиваются с ситуацией, когда CLI всё равно ожидает ввод, даже при использовании --json.

Причина в том, что:

• --json отвечает только за формат вывода
• для отключения интерактивности требуется --non-interactive

Рекомендации

• Всегда используйте --non-interactive для скриптов
• Задавайте переменные окружения заранее
• Указывайте --workspace для полного контроля
• Используйте --json для машинной обработки результата

Что дальше

После автоматизации onboarding вы можете:

• Использовать CLI Onboarding Reference
• Настраивать привязки агентов
• Добавлять каналы и навыки
• Использовать AI Setup Assistant для сложных конфигураций