Справочник по настройке CLI

​

Что делает мастер

• Настройка модели и аутентификации (Anthropic, OAuth подписки OpenAI Code, xAI, OpenCode, пользовательские конечные точки и другие принадлежащие провайдерам процессы аутентификации)
• Расположение рабочего пространства и файлы начальной загрузки
• Настройки Gateway (порт, привязка, аутентификация, Tailscale)
• Каналы и провайдеры (Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp и другие встроенные каналы или каналы плагинов)
• Провайдер веб-поиска (необязательно)
• Установка фоновой службы (LaunchAgent, пользовательская служба systemd или встроенная запланированная задача Windows с резервным вариантом через папку автозагрузки)
• Проверка работоспособности
• Настройка Skills

​

Сведения о локальном процессе

​

Сведения об удалённом режиме

• URL удалённого Gateway (ws://... или wss://...)
• Токен, пароль или отсутствие аутентификации в соответствии с конфигурацией удалённого Gateway

​

Варианты аутентификации и модели

• Выберите модель по умолчанию из обнаруженных вариантов или укажите поставщика и модель вручную.
• Если первоначальная настройка начинается с выбора аутентификации поставщика, средство выбора модели автоматически отдаёт предпочтение этому поставщику. Для Volcengine и BytePlus это предпочтение также распространяется на их варианты тарифных планов для программирования (volcengine-plan/*, byteplus-plan/*).
• Если фильтр предпочитаемого поставщика не даёт результатов, средство выбора возвращается к полному каталогу, а не показывает пустой список моделей.
• Мастер проверяет модель и предупреждает, если настроенная модель неизвестна или для неё отсутствует аутентификация.

• Профили аутентификации (ключи API + OAuth): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• Импорт устаревших данных OAuth: ~/.openclaw/credentials/oauth.json

• По умолчанию первоначальная настройка сохраняет ключи API в профилях аутентификации в виде открытого текста.
• --secret-input-mode ref включает режим ссылок вместо хранения ключей в виде открытого текста. При интерактивной настройке можно выбрать:
  • ссылку на переменную окружения (например, keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" })
  • ссылку на настроенного поставщика (file или exec) с псевдонимом и идентификатором поставщика
• В интерактивном режиме ссылок перед сохранением выполняется быстрая предварительная проверка.
  • Ссылки на переменные окружения: проверяются имя переменной и наличие непустого значения в текущем окружении первоначальной настройки.
  • Ссылки на поставщиков: проверяется конфигурация поставщика и разрешается запрошенный идентификатор.
  • Если предварительная проверка завершается ошибкой, первоначальная настройка показывает её и позволяет повторить попытку.
• В неинтерактивном режиме --secret-input-mode ref поддерживает только переменные окружения.
  • Задайте переменную окружения поставщика в окружении процесса первоначальной настройки.
  • Флаги со встроенным ключом (например, --openai-api-key) требуют, чтобы эта переменная окружения была задана; иначе первоначальная настройка немедленно завершается ошибкой.
  • Для пользовательских поставщиков неинтерактивный режим ref сохраняет models.providers.<id>.apiKey как { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.
  • В случае такого пользовательского поставщика --custom-api-key требует, чтобы была задана CUSTOM_API_KEY; иначе первоначальная настройка немедленно завершается ошибкой.
• При интерактивной настройке учётные данные аутентификации Gateway можно сохранить в виде открытого текста или SecretRef:
  • Режим токена: Создать и сохранить токен в виде открытого текста (по умолчанию) или Использовать SecretRef.
  • Режим пароля: открытый текст или SecretRef.
• Путь SecretRef для токена в неинтерактивном режиме: --gateway-token-ref-env <ENV_VAR>.
• Существующие настройки с открытым текстом продолжают работать без изменений.

​

Результаты и внутреннее устройство

• agents.defaults.workspace
• agents.defaults.skipBootstrap, если передан --skip-bootstrap
• agents.defaults.model / models.providers (если выбран Minimax)
• tools.profile (если значение не задано, при локальной первоначальной настройке по умолчанию используется "coding"; существующие явно заданные значения сохраняются)
• gateway.* (режим, привязка, аутентификация, Tailscale)
• session.dmScope (если значение не задано, при локальной первоначальной настройке по умолчанию используется per-channel-peer; существующие явно заданные значения сохраняются)
• channels.telegram.botToken, channels.discord.token, channels.matrix.*, channels.signal.*, channels.imessage.*
• Списки разрешённых каналов (Discord, iMessage, Signal, Slack, Telegram, WhatsApp), если вы соглашаетесь на их настройку в запросах; для Discord и Slack введённые имена также преобразуются в идентификаторы
• skills.install.nodeManager
  • Флаг setup --node-manager принимает npm, pnpm или bun.
  • Позднее при ручной настройке по-прежнему можно задать skills.install.nodeManager: "yarn".
• wizard.lastRunAt
• wizard.lastRunVersion
• wizard.lastRunCommit
• wizard.lastRunCommand
• wizard.lastRunMode
• wizard.securityAcknowledgedAt

​

Неинтерактивная настройка

openclaw onboard --non-interactive --accept-risk \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY"

​

RPC мастера Gateway

• wizard.start
• wizard.next
• wizard.cancel
• wizard.status

​

Поведение настройки Signal

• Загружает подходящий ресурс выпуска из официальных выпусков signal-cli на GitHub (нативная сборка, только Linux x86-64)
• На других платформах (macOS и Linux не на x64) вместо этого устанавливает через Homebrew
• Сохраняет установленный ресурс выпуска в ~/.openclaw/tools/signal-cli/<version>/
• Записывает channels.signal.cliPath в конфигурацию
• Нативная Windows пока не поддерживается; запустите первоначальную настройку внутри WSL2, чтобы получить путь установки для Linux

​

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

• Центр первоначальной настройки: Первоначальная настройка (CLI)
• Автоматизация и скрипты: Автоматизация CLI
• Справочник команд: openclaw onboard