OpenClaw — автономная платформа интеллектуальных помощников с искусственным интеллектом - apps / openclaw

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

Введение в проект

OpenClaw — это автономный персональный ИИ с открытым исходным кодом. Платформа Assistant, которая подключает приложения для обмена сообщениями к искусственному интеллекту, работающему на вашем собственном оборудовании. агент. Создан для разработчиков и опытных пользователей, чтобы иметь автономного помощника искусственного интеллекта, не передавая контроль над своими данными.

Официальная домашняя страница: https://openclaw.ai
Документ проекта: https://openclaw.ai — GitHub: https://openclaw.ai

Подготовить информацию

OpenClaw имеет полностью открытый исходный код. Вы можете просмотреть исходный код, сообщить о проблемах или внести свой вклад в [репозиторий OpenClaw GitHub] (https://github.com/openclaw/openclaw). В этом руководстве описаны установка, настройка и полные этапы подключения OpenClaw к 88API.

🌟 Основные функции

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

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

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

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

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

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

📦 Подготовка перед доступом

Node.js 22 или выше
Действительный адрес 88API (обычно заканчивающийся на https://github.com/openclaw/openclaw).
Действительный ключ API 88API.
Используйте 88API, развернутый самостоятельно, или подтвердите, что поставщик услуг имеет юридическую авторизацию и обязательства по соблюдению требований. Не подключайте адреса API или ключи из неизвестных источников к производственной среде.

Прежде чем начать доступ к 88API, рекомендуется запустить пользовательский интерфейс шлюза и управления в соответствии с текущим официальным процессом рекомендаций OpenClaw. Таким образом, при последующем устранении неполадок будет легче отличить, не запущен ли сам OpenClaw или неправильно настроен поставщик модели.

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

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

Чтобы узнать о других методах установки, обратитесь к официальной документации OpenClaw: Начало работы.

2. Запустите мастер загрузки

openclaw onboard --install-daemon

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

3. Проверьте шлюз и пользовательский интерфейс управления

openclaw gateway status

openclaw dashboard

Переменные среды, связанные с путем

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

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

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

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

-~/.openclaw/openclaw.json -~/.openclaw/openclaw.json -~/.openclaw/openclaw.json

Подробные инструкции см. в официальном документе о переменных среды: Переменные среды.

🚀 Используйте 88API в качестве поставщика модели.

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

Доступ к идеям

Объявите провайдера 88api/ID_модели в models.providers.
Укажите в models.providers свой адрес 88API и обязательно включите 88api/ID_модели.
Установите для models.providers значение 88api/ID_модели.
Перечислите идентификаторы моделей, которые OpenClaw должен использовать в models.providers.
Измените модель по умолчанию в models.providers на 88api/ID_модели.

Рекомендуемая практика: используйте переменные среды для сохранения ключа.

Сначала укажите свой ключ 88API в текущей оболочке, сервисной среде или models.providers, доступном для чтения OpenClaw:

export API88_API_KEY="sk-your-88api-key"

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

{
  models: {
    mode: "merge",
    providers: {
      88api: {
        baseUrl: "https://88api.ai/v1",
        apiKey: "${API88_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: "88api/gemini-2.5-flash",
        fallbacks: ["88api/kimi-k2.5"],
      },
      models: {
        "88api/gemini-2.5-flash": { alias: "flash" },
        "88api/kimi-k2.5": { alias: "kimi" },
      },
    },
  },
}

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

Инструкции по настройке клавиш

Элементы конфигурации	Описание
`provider`	Рекомендуется установить `merge` и добавить `88api`, сохранив при этом встроенный поставщик OpenClaw
`provider`	Ваш адрес 88API, обычно вам нужно указать `merge`
`provider`	Ключ 88API, рекомендуется для внедрения через `merge`
`provider`	Для шлюзов, совместимых с OpenAI, таких как 88API, используйте `merge`
`provider`	Указанный здесь идентификатор модели должен соответствовать названию модели, фактически предоставленному вашим 88API
`provider`	Основная модель по умолчанию, формат должен быть `merge`
`provider`	Список альтернативных моделей, автоматически переключается при выходе из строя основной модели
`provider`	Необязательно, используется для присвоения модели псевдонима для удобства использования в пользовательском интерфейсе или сеансе

Проверьте, успешен ли доступ

После завершения настройки вернитесь в интерфейс управления или откройте его заново:

openclaw dashboard

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

openclaw models list

Убедитесь, что модель с префиксом 88api/ появилась в списке выбора.

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

88api/ без /v1: это одна из наиболее распространенных ошибок доступа.
Неправильный идентификатор модели: 88api/ и /v1 должны соответствовать id в models.providers.88api.models.
Ключ действителен только в текущем терминале: если шлюз работает как фоновая служба, убедитесь, что процесс службы также может читать 88api/.
Если вы хотите устранить неполадки на стойке регистрации: вы можете использовать официальный режим работы стойки регистрации 88api/ для просмотра журналов и отчетов об ошибках.

OpenClaw — автономная платформа интеллектуальных помощников с искусственным интеллектом

Содержание