88API88API
Руководство пользователяAI-приложенияAPIПомощь и поддержка

OpenClaw — платформа ИИ-ассистента с самостоятельным размещением

Руководство по OpenClaw — установите OpenClaw, подключите 88API и быстро разверните собственного ИИ-ассистента. Проект с открытым исходным кодом поддерживает интеграцию с Telegram, Discord, WhatsApp и другими каналами.

О проекте

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 | bash

Windows (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 status
openclaw dashboard

Если Control UI открывается в браузере, базовая работа OpenClaw в порядке. На этом этапе не нужно настраивать Telegram, Discord, Feishu и другие каналы.

4. Найдите файл конфигурации

Файл конфигурации OpenClaw обычно находится в ~/.openclaw/openclaw.json. Его можно дополнять на основе того, что создал мастер настройки.

Переменные окружения для путей

Если OpenClaw работает под отдельной служебной учётной записью или вы хотите изменить каталоги конфигурации и состояния, используйте:

  • OPENCLAW_HOME
  • OPENCLAW_STATE_DIR
  • OPENCLAW_CONFIG_PATH

Подробнее см. в официальной документации по переменным окружения: Environment Variables.

🚀 88API как провайдер моделей

OpenClaw позволяет подключать через models.providers собственные или OpenAI-совместимые шлюзы моделей. Для 88API чаще всего добавляют его в конфигурацию как пользовательский provider, а затем указывают модель по умолчанию в виде api88/ID_модели.

Порядок подключения

  1. Объявите provider api88 в models.providers.
  2. Задайте для baseUrl значение https://api.88api.ai/v1 (/v1 обязателен).
  3. Установите для api значение openai-completions.
  4. Перечислите в models идентификаторы моделей, которые должен использовать OpenClaw.
  5. Переключите модель по умолчанию в 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 restart

Windows (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 и смотрите журналы и ошибки.