OpenClaw - Самостоятельно размещенная платформа AI-помощника

OpenClaw полностью открыт. Вы можете просматривать исходный код, отправлять Issues или участвовать в разработке в репозитории OpenClaw на GitHub. Этот учебник охватывает установку, настройку и полные шаги по интеграции OpenClaw с New API.

🌟 Основные возможности

Многоканальная интеграция

• Многоканальная интеграция: Поддержка Telegram, Discord, WhatsApp, iMessage и других каналов, а также расширение через плагины.
• Единый шлюз: Управление всеми каналами через один процесс Gateway.
• Голосовая поддержка: Поддержка голосового взаимодействия на macOS/iOS/Android.
• Интерфейс Canvas: Возможность рендеринга интерактивных интерфейсов Canvas.

Самостоятельное размещение и безопасность данных

• Полное самостоятельное размещение: Работает на вашем собственном компьютере или сервере.
• Открытый и прозрачный код: Лицензия MIT, код полностью прозрачен.
• Локализация данных: Контекст и навыки хранятся на вашем локальном компьютере, а не в облаке.

Возможности интеллектуальных агентов

• Непрерывная работа: Поддержка фоновой работы с постоянной памятью.
• Планировщик задач: Поддержка cron-задач.
• Изоляция сессий: Изоляция сессий по агенту/рабочей области/отправителю.
• Маршрутизация мультиагентов: Поддержка совместной работы нескольких агентов.
• Вызов инструментов: Встроенная поддержка вызова инструментов и выполнения кода.

📦 Подготовка к интеграции

Перед началом интеграции с New API рекомендуется сначала запустить Gateway и Control UI по текущей рекомендуемой процедуре OpenClaw. Это облегчит диагностику проблем: будет проще определить, не запущен ли сам OpenClaw или неправильно настроен провайдер модели.

1. Установка OpenClaw (macOS/Linux)

curl -fsSL https://openclaw.ai/install.sh | bash

Другие способы установки см. в официальной документации OpenClaw: Getting Started.

2. Запуск мастера настройки

openclaw onboard --install-daemon

Этот мастер выполнит базовую аутентификацию, настройку Gateway и опциональную инициализацию каналов. Цель здесь — сначала запустить OpenClaw, а затем переключить модель по умолчанию на New API.

3. Проверка Gateway и Control UI

openclaw gateway status

openclaw dashboard

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

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

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

🚀 Использование New API в качестве провайдера моделей

OpenClaw поддерживает подключение пользовательских или совместимых с OpenAI интерфейсов шлюзов моделей через models.providers. Для New API наиболее распространенный способ — добавить его в конфигурацию как пользовательского провайдера и указать модель по умолчанию как newapi/ID_модели.

Подход к интеграции

1. Объявите провайдера newapi в разделе models.providers
2. Укажите baseUrl на адрес вашего New API, убедитесь, что он содержит /v1
3. Установите api в openai-completions
4. Перечислите в models ID моделей, которые вы хотите использовать в OpenClaw
5. В agents.defaults.model.primary переключите модель по умолчанию на newapi/...

Рекомендуемый способ: хранение ключа в переменной окружения

Сначала укажите ваш API-ключ New API в текущем shell, окружении службы или в файле .env, который может прочитать OpenClaw:

export NEWAPI_API_KEY="sk-your-newapi-key"

Затем добавьте или измените следующий фрагмент в openclaw.json:

{
  models: {
    mode: "merge",
    providers: {
      newapi: {
        baseUrl: "https://<your-newapi-domain>/v1",
        apiKey: "${NEWAPI_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "kimi-k2.5", name: "Kimi K2.5" },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: "newapi/gemini-2.5-flash",
        fallbacks: ["newapi/kimi-k2.5"],
      },
      models: {
        "newapi/gemini-2.5-flash": { alias: "flash" },
        "newapi/kimi-k2.5": { alias: "kimi" },
      },
    },
  },
}

Это не полная конфигурация, которую нужно копировать дословно, а самая важная часть для интеграции с New API. Если провайдер, ID модели и ссылка на модель по умолчанию указаны правильно, OpenClaw сможет вызывать ваши выставленные ресурсы модели через New API.

Пояснение ключевых настроек

Проверка успешности интеграции

После завершения настройки вернитесь в Control UI или откройте его заново:

openclaw dashboard

Если вы можете нормально начать диалог в OpenClaw и модель по умолчанию изменилась на newapi/..., значит интеграция прошла успешно. Вы также можете использовать:

openclaw models list

чтобы убедиться, что модели с префиксом newapi/ появились в списке доступных.

Часто задаваемые вопросы

• Отсутствие /v1 в baseUrl: это одна из самых распространенных ошибок при интеграции.
• Неправильный ID модели: primary и fallbacks должны соответствовать id в models.providers.newapi.models.
• Ключ активен только в текущем терминале: если Gateway работает как фоновая служба, убедитесь, что процесс службы также может читать NEWAPI_API_KEY.
• Диагностика на переднем плане: можно использовать официальный способ запуска на переднем плане: openclaw gateway --port 18789, чтобы наблюдать логи и ошибки.