OpenClaw API Key и модели
полный пошаговый гид по установке 2026
После установки OpenClaw без подключённой модели остаётся пустой оболочкой. Неверный API-ключ, незапущенный локальный сервис инференса или модель по умолчанию, не подходящая под задачу, создают впечатление, что «сломался сам OpenClaw». Это по-прежнему полный пошаговый гид по установке и настройке 2026 — с углублённым разбором цепочки модель, ключ и приёмка при первом запуске: когда выбирать облако или локальный инференс, как безопасно хранить ключи и как Dashboard подтверждает реальный вызов модели.
ключ → провайдер → id модели → сеть → логи
Dashboard и проверка доступности
облако / локально / гибрид
1Установка завершена ≠ модель вызывается
Работоспособность OpenClaw сильнее зависит от того, подключена ли цепочка модели, безопасно ли лежат ключи и подходит ли модель по умолчанию под задачу, чем от успеха npm install -g openclaw. Работающий gateway и успешная проверка на порту 18789 означают лишь, что оболочка поднята; для реальной работы нужны корректные provider/model и аутентификация. Ниже эта цепочка проходит внутри полного сценария установки.
openclaw models status или минимальный вызов Agent и убедитесь в исходящих HTTP-запросах и расходе токенов в логах.
2Перед установкой: подготовка модели и ключей
До старта: ① список провайдеров, поддерживаемых вашей версией OpenClaw (официальная документация); ② облачный API-ключ и имя переменной окружения; ③ при локальном инференсе — совместимый HTTP-эндпоинт, уже слушающий порт, и достаточно RAM; ④ сетевая доступность API провайдера или localhost. В гибридной схеме заранее зафиксируйте: на какой машине gateway, на какой — инференс.
3Официальная установка и onboarding
Установите Node 24 и CLI, затем openclaw onboard (при необходимости с --install-daemon) для модели по умолчанию и gateway. Проверьте node -v и наследование переменных окружения в launchd — иначе ключи пропадут после перезагрузки. Подробности по Node 24 и порту 18789 — в
руководстве по холодному старту.
4Облачные модели и API-ключ
Встроенным провайдерам обычно достаточно auth: openclaw onboard --auth-choice openai-api-key (точные флаги — в мастере), или export OPENAI_API_KEY="sk-your-placeholder", затем openclaw models set provider/model. Для своего прокси задайте models.providers и ссылайтесь на ключи через ${ENV} — не литералами. Проверка: openclaw models status.
5Подключение локальной модели
Локальный инференс удобен для приватности и контроля затрат; скорость зависит от железа. В models.providers укажите локальный baseUrl (например http://127.0.0.1:PORT/v1) и id модели. Сначала проверьте эндпоинт через curl, затем запускайте OpenClaw.
6Приёмка: облако, локально и гибрид
| Проверка | Облачная модель | Локальная модель | Гибрид |
|---|---|---|---|
| Аутентификация | models status показывает провайдера как аутентифицированного |
Локальный эндпоинт без ключа или только внутренний токен | Обе конфигурации видны в status |
| Связность | Исходящий доступ к API провайдера | curl на локальный baseUrl |
Каждый путь проверяйте отдельно — шаги не смешивайте |
| Dashboard | 18789 OK + сессия с upstream-запросами | В логах локальные HTTP-вызовы | Основная модель в облаке, чувствительные шаги локальночасто |
| Стоимость / приватность | Оплата за вызовы; данные уходят с машины | Электричество и железо; данные остаются на устройстве | Зафиксируйте, какие задачи идут по какому пути |
Dashboard по умолчанию на 127.0.0.1:18789 (статус gateway и логи). Страница открывается, но ответа нет — пройдите таблицу построчно.
7Дымовой тест при первом запуске
openclaw agent --local --session-id smoke-test --message "Ответь только: модель OK" --timeout 90 — если в JSON ожидаемые provider/model, а в логах исходящие запросы, цепочка модели в порядке.
8Ошибки модели vs ошибки установки
openclaw models list и написание provider/model; для кастомного провайдера — models.providers.*.models[].id.lsof -iTCP:18789, затем launchd — это не проблема API модели; ключи не ротируйте в первую очередь.9Регулярное обслуживание
Ротируйте ключи по расписанию, отслеживайте каталог через models list, следите за биллингом. После нового провайдера меняйте основную модель через openclaw models set.
- 1Перед установкой подготовьте ключи, сеть и (при необходимости) локальный эндпоинт
- 2Приёмка в четыре шага:
onboard→models status→ Dashboard → минимальный Agent - 3Диагностика: ключ → провайдер → id модели → сеть/локальный сервис → логи
- 4Секреты не в репозиторий; ошибки модели отделяйте от порта и прав доступа
На Mac mini цепочка модели проще
Gateway и локальный инференс на macOS идут одним понятным путём: Node 24, launchd и наследование окружения работают согласованно. Unified Memory Mac mini M4 подходит для средних локальных экспериментов; около 4 Вт в простое — для gateway 24/7; Gatekeeper / FileVault снижают риск утечки ключей. Если нужны стабильные onboard и приёмка в Dashboard, Mac mini M4 — сильная база для этого стека; сейчас удачный момент вложиться в такое железо.