Довідник із налаштування 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

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

​

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

• Центр початкового налаштування: Початкове налаштування (CLI)
• Автоматизація та сценарії: Автоматизація CLI
• Довідник команд: openclaw onboard