OpenClaw — платформа ИИ-ассистента с самостоятельным размещением
Руководство по OpenClaw — установите OpenClaw, подключите 88API и быстро разверните собственного ИИ-ассистента. Проект с открытым исходным кодом поддерживает интеграцию с Telegram, Discord, WhatsApp и другими каналами.
О проекте
OpenClaw — это платформа персонального ИИ-ассистента с открытым исходным кодом и самостоятельным размещением. Она подключает мессенджеры к ИИ-агенту, работающему на вашем собственном оборудовании. Платформа создана для разработчиков и опытных пользователей, которым нужен автономный ИИ-ассистент без передачи контроля над данными.
- Официальный сайт: https://openclaw.ai
- Документация проекта: https://docs.openclaw.ai
- GitHub: https://github.com/openclaw/openclaw
OpenClaw имеет полностью открытый исходный код: в репозитории OpenClaw на GitHub можно просматривать код, создавать Issue и участвовать в разработке. В этом руководстве описаны установка, настройка и полное подключение OpenClaw к 88API.
🌟 Основные возможности
Многоканальная интеграция
- Многоканальная интеграция: поддержка Telegram, Discord, WhatsApp, iMessage и других мессенджеров; другие платформы можно подключить через плагины
- Единый шлюз: все каналы управляются одним процессом Gateway
- Голосовое управление: голосовое взаимодействие на macOS/iOS/Android
- Интерфейс Canvas: отображение интерактивного интерфейса Canvas
Самостоятельное размещение и безопасность данных
- Полностью на вашей стороне: работает на вашем компьютере или сервере
- Открытый код: лицензия MIT, код полностью открыт
- Локальное хранение данных: контекст и навыки хранятся на вашем компьютере, а не в облаке
Возможности агента
- Постоянная работа: может работать в фоне и имеет долговременную память
- Задачи по расписанию: поддержка заданий cron
- Изоляция сеансов: сеансы разделяются по агенту, рабочему пространству и отправителю
- Маршрутизация между агентами: поддержка совместной работы нескольких агентов
- Вызов инструментов: встроенная поддержка вызова инструментов и выполнения кода
📦 Подготовка к подключению
Что нужно подготовить
- Node.js 24.16+ или 26.1+ (официально рекомендуется Node 26; Node 22, 23 и 25 не поддерживаются. Официальный скрипт установки сам подготовит Node)
- Адрес API 88API:
https://api.88api.ai/v1 - API-ключ, созданный в консоли 88API
- Храните API-ключ в надёжном месте и не вставляйте его в приложения или страницы из неизвестных источников.
Перед подключением 88API рекомендуется запустить Gateway и Control UI по актуальной официальной инструкции OpenClaw. Так при дальнейшей диагностике будет проще понять, не запущен ли сам OpenClaw или неверно настроен провайдер моделей.
1. Установите OpenClaw
macOS/Linux:
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iexДругие способы установки описаны в официальной документации OpenClaw: Getting Started.
2. Запустите мастер настройки
openclaw onboard --install-daemonМастер выполнит базовую аутентификацию, настройку Gateway и, при желании, начальную настройку каналов. Цель этого шага — сначала запустить OpenClaw, а затем переключить модель по умолчанию на 88API.
Официальный скрипт установки по завершении сам запускает этот мастер; если вы уже прошли его во время установки, этот шаг можно пропустить. Чтобы завершить мастер, нужно подключить хотя бы одну рабочую модель. Если у вас есть только ключ 88API, выберите в списке провайдеров моделей More… → Custom Provider: в Base URL укажите https://api.88api.ai/v1 (/v1 обязателен), Compatibility оставьте по умолчанию openai, в Model ID укажите gpt-6.1-sol и вставьте ключ 88API. Мастер отправит реальный запрос и сохранит настройки только при успешной проверке. Созданный им provider будет называться примерно custom-api-88api-ai и может работать вместе с api88, который добавляется вручную ниже.
Не выбирайте Skip for now: мастер просто завершится, не запустив Gateway, и проверка на следующем шаге не пройдёт.
3. Проверьте Gateway и Control UI
openclaw gateway statusopenclaw dashboardЕсли Control UI открывается в браузере, базовая работа OpenClaw в порядке. На этом этапе не нужно настраивать Telegram, Discord, Feishu и другие каналы.
4. Найдите файл конфигурации
Файл конфигурации OpenClaw обычно находится в ~/.openclaw/openclaw.json. Его можно дополнять на основе того, что создал мастер настройки.
Переменные окружения для путей
Если OpenClaw работает под отдельной служебной учётной записью или вы хотите изменить каталоги конфигурации и состояния, используйте:
OPENCLAW_HOMEOPENCLAW_STATE_DIROPENCLAW_CONFIG_PATH
Подробнее см. в официальной документации по переменным окружения: Environment Variables.
🚀 88API как провайдер моделей
OpenClaw позволяет подключать через models.providers собственные или OpenAI-совместимые шлюзы моделей. Для 88API чаще всего добавляют его в конфигурацию как пользовательский provider, а затем указывают модель по умолчанию в виде api88/ID_модели.
Порядок подключения
- Объявите provider
api88вmodels.providers. - Задайте для
baseUrlзначениеhttps://api.88api.ai/v1(/v1обязателен). - Установите для
apiзначениеopenai-completions. - Перечислите в
modelsидентификаторы моделей, которые должен использовать OpenClaw. - Переключите модель по умолчанию в
agents.defaults.model.primaryнаapi88/....
Рекомендуется: храните ключ в переменной окружения
Когда Gateway работает как фоновая служба (--install-daemon на шаге 2), он не видит переменные, заданные через export в терминале. Запишите ключ в глобальный файл окружения, официально рекомендуемый OpenClaw, — ~/.openclaw/.env (если задан OPENCLAW_STATE_DIR, то в .env в этом каталоге), а затем перезапустите Gateway:
macOS/Linux:
echo 'API88_API_KEY=sk-your-88api-key' >> ~/.openclaw/.env
openclaw gateway restartWindows (PowerShell):
Add-Content -Path "$HOME\.openclaw\.env" -Value 'API88_API_KEY=sk-your-88api-key' -Encoding ascii
openclaw gateway restartЗатем добавьте или измените в openclaw.json следующий фрагмент:
{
models: {
mode: "merge",
providers: {
api88: {
baseUrl: "https://api.88api.ai/v1",
apiKey: "${API88_API_KEY}",
api: "openai-completions",
models: [
{ id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
{ id: "kimi-k3", name: "Kimi K3" },
],
},
},
},
agents: {
defaults: {
model: {
primary: "api88/gemini-3.5-flash",
fallbacks: ["api88/kimi-k3"],
},
models: {
"api88/gemini-3.5-flash": { alias: "flash" },
"api88/kimi-k3": { alias: "kimi" },
},
},
},
}Это не полная конфигурация для дословного копирования, а ключевая часть для подключения 88API. Если provider, идентификаторы моделей и ссылки на модель по умолчанию согласованы, OpenClaw сможет вызывать соответствующие модели через 88API.
Основные параметры
| Параметр | Описание |
|---|---|
models.mode | Рекомендуется merge: встроенные провайдеры OpenClaw сохраняются, а api88 добавляется |
models.providers.api88.baseUrl | Адрес API 88API https://api.88api.ai/v1; /v1 обязателен |
models.providers.api88.apiKey | Ключ 88API; рекомендуется передавать через ${API88_API_KEY} |
models.providers.api88.api | Для OpenAI-совместимых шлюзов, таких как 88API, используйте openai-completions |
models.providers.api88.models | Перечисленные здесь идентификаторы моделей должны совпадать с названиями моделей, которые фактически предоставляет 88API |
agents.defaults.model.primary | Основная модель по умолчанию в формате provider/model-id |
agents.defaults.model.fallbacks | Резервные модели, на которые OpenClaw переключается при сбое основной |
agents.defaults.models | Необязательно: псевдонимы моделей для удобного обращения в интерфейсе или сеансе |
Проверка подключения
После настройки вернитесь в Control UI или откройте его снова:
openclaw dashboardЕсли в OpenClaw удаётся начать диалог, а модель по умолчанию стала api88/..., подключение выполнено. Также можно выполнить:
openclaw models listи убедиться, что модели с префиксом api88/ появились в списке.
Частые проблемы
- В
baseUrlнет/v1: это одна из самых частых ошибок подключения. - Неверный идентификатор модели:
primaryиfallbacksдолжны совпадать сidвmodels.providers.api88.models. - Ключ действует только в текущем терминале: фоновая служба не наследует переменные, экспортированные в терминале. Запишите ключ в
~/.openclaw/.envи выполнитеopenclaw gateway restart. - Для диагностики в интерактивном режиме запустите Gateway официальной командой
openclaw gateway --port 18789и смотрите журналы и ошибки.
CC Switch — единый менеджер AI CLI
Руководство по CC Switch — кроссплатформенному инструменту для единого управления конфигурациями провайдеров, MCP-серверами и системными промптами Claude Code, Codex, Gemini CLI, OpenCode и других ИИ-инструментов для программирования. Подключение 88API в одно нажатие.
Cherry Studio — настольный ИИ-клиент
Следующая страница