Начальная настройка (CLI)

CLI-онбординг — рекомендуемый путь настройки OpenClaw из терминала на macOS, Linux или Windows. Пользователи рабочего стола Windows также могут начать с Windows Hub. Он настраивает локальный Gateway или подключение к удаленному Gateway, а также каналы, Skills и значения рабочей области по умолчанию в одном пошаговом сценарии.

openclaw onboard

QuickStart обычно занимает всего несколько минут, но полный онбординг может занять больше времени, если вход к провайдеру, сопряжение канала, установка демона, сетевые загрузки, Skills или необязательные plugins требуют дополнительной настройки. Мастер заранее показывает этот график, а необязательные шаги можно пропустить и вернуться к ним позже с помощью openclaw configure.

Локаль

Мастер CLI локализует фиксированный текст онбординга. Он определяет локаль из OPENCLAW_LOCALE, затем LC_ALL, затем LC_MESSAGES, затем LANG, и возвращается к английскому. Поддерживаемые локали мастера: en, zh-CN и zh-TW.

OPENCLAW_LOCALE=zh-CN openclaw onboard

Имена и стабильные идентификаторы остаются буквальными: OpenClaw, Gateway, Tailscale, команды, ключи конфигурации, URL, идентификаторы провайдеров, идентификаторы моделей и метки plugin/каналов не переводятся.

Чтобы перенастроить позже:

openclaw configureopenclaw agents add <name>

QuickStart и расширенный режим

Онбординг начинается с выбора QuickStart (значения по умолчанию) или расширенного режима (полный контроль).

Что настраивает онбординг

Локальный режим (по умолчанию) проводит вас через следующие шаги:

1. Модель/аутентификация — выберите любой поддерживаемый провайдер/сценарий аутентификации (ключ API, OAuth или ручная аутентификация, специфичная для провайдера), включая Custom Provider (совместимый с OpenAI, совместимый с Anthropic или Unknown с автоопределением). Выберите модель по умолчанию. Примечание по безопасности: если этот агент будет запускать инструменты или обрабатывать содержимое webhook/hooks, предпочитайте самую сильную доступную модель последнего поколения и держите политику инструментов строгой. Более слабые/старые уровни легче подвергаются prompt injection. Для неинтерактивных запусков --secret-input-mode ref сохраняет ссылки на значения из env в профилях аутентификации вместо открытых значений ключей API. В неинтерактивном режиме ref переменная окружения провайдера должна быть задана; передача флагов с ключом inline без этой переменной окружения быстро завершается ошибкой. В интерактивных запусках выбор режима ссылки на секрет позволяет указать либо переменную окружения, либо настроенную ссылку провайдера (file или exec) с быстрой предварительной проверкой перед сохранением. Для Anthropic интерактивный онбординг/настройка предлагает Anthropic Claude CLI как предпочтительный локальный путь и ключ Anthropic API как рекомендуемый путь для production. Anthropic setup-token также остается доступным как поддерживаемый путь аутентификации по токену.
2. Рабочая область — расположение файлов агента (по умолчанию ~/.openclaw/workspace). Создает начальные bootstrap-файлы.
3. Gateway — порт, адрес привязки, режим аутентификации, доступ через Tailscale. В интерактивном режиме токена выберите хранение токена открытым текстом по умолчанию или включите SecretRef. Неинтерактивный путь SecretRef для токена: --gateway-token-ref-env <ENV_VAR>.
4. Каналы — встроенные и официальные plugin-каналы чата, такие как iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp и другие.
5. Демон — устанавливает LaunchAgent (macOS), пользовательский systemd unit (Linux/WSL2) или нативную Windows Scheduled Task с резервным вариантом через папку Startup для пользователя. Если аутентификация по токену требует токен и gateway.auth.token управляется SecretRef, установка демона проверяет его, но не сохраняет разрешенный токен в метаданных окружения сервиса supervisor. Если аутентификация по токену требует токен и настроенный SecretRef токена не разрешается, установка демона блокируется с практическими рекомендациями. Если настроены и gateway.auth.token, и gateway.auth.password, а gateway.auth.mode не задан, установка демона блокируется до явной настройки режима.
6. Проверка работоспособности — запускает Gateway и проверяет, что он работает.
7. Skills — устанавливает рекомендуемые Skills и необязательные зависимости.

Удаленный режим только настраивает локальный клиент для подключения к Gateway в другом месте. Он не устанавливает и не изменяет ничего на удаленном хосте.

Добавить другого агента

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

Что он задает:

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

Примечания:

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

Полный справочник

Подробные пошаговые разборы и выходные данные конфигурации см. в справочнике по настройке CLI. Неинтерактивные примеры см. в автоматизации CLI. Более глубокий технический справочник, включая сведения RPC, см. в справочнике по онбордингу.

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

• Справочник команд CLI: openclaw onboard
• Обзор онбординга: обзор онбординга
• Онбординг приложения macOS: онбординг
• Ритуал первого запуска агента: начальная настройка агента