1APP · Документация

Appearance

Подключение OpenClaw ​

Сложность ⌨️ Продвинутый　|　Формат интерфейса Совместимый с OpenAI　|　base_url https://1app.ru/v1

OpenClaw (🦞) — это персональный ИИ-ассистент с открытым исходным кодом, который поддерживает настраиваемых поставщиков моделей. Просто укажите ему на 1APP — и всё готово, одинаково для Windows / macOS / Linux.

Перед началом

Сначала перейдите в Консоль → Токены и создайте токен (см. Выбор группы).

Способ 1: мастер настройки (самый простой) ​

После установки запустите встроенный мастер и по подсказкам выберите поставщика «Свой / Совместимый с OpenAI»:

bash
openclaw onboard

Заполните по порядку:

  • Адрес интерфейса / baseUrl: https://1app.ru/v1
  • API key: ваш sk-xxxx
  • Модель: укажите имя модели из 1APP (например, gpt-5.5, claude-opus-5)

Способ 2: ручное редактирование конфигурационного файла ​

В конфигурационном файле OpenClaw (~/.openclaw/openclaw.json, формат JSON5) в разделе models.providers добавьте своего поставщика:

json5
{
  agents: {
    defaults: { model: { primary: "1APP/gpt-5.5" } },   // 默认用哪个模型
  },
  models: {
    mode: "merge",                   // 合并内置服务商，而非覆盖
    providers: {
      1APP: {
        baseUrl: "https://1app.ru/v1",
        apiKey: "${1APP_API_KEY}",      // 建议用环境变量，避免明文
        api: "openai-completions",       // OpenAI 兼容
        models: [
          { id: "gpt-5.5", name: "1APP GPT-5.5" },
          { id: "claude-opus-5", name: "1APP Claude Opus 4.8" },
        ],
      },
    },
  },
}

Несколько важных моментов

  • baseUrl указывается с /v1 (совместимость с OpenAI).
  • Для apiKey рекомендуется использовать переменную окружения ${1APP_API_KEY} (храните настоящий ключ в переменной окружения), не коммитьте его в git открытым текстом: export 1APP_API_KEY="sk-xxxx".
  • Если Gateway работает как фоновый сервис / демон, убедитесь, что эта переменная есть и в окружении самого процесса сервиса (export только в текущем терминале он не увидит — получите ошибку 401); если вы работаете только локально и конфигурация не попадает в git, ключ можно вписать в неё и открытым текстом.
  • Значения id в разделе models должны совпадать с именами моделей в Консоли.
  • Точный путь к конфигурационному файлу определяется тем, что сгенерировал мастер openclaw onboard (в некоторых версиях он находится в ~/.config/openclaw/).

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

bash
openclaw models list     # убедитесь, что модели с префиксом 1APP/ появились в списке доступных

Можно также выполнить openclaw dashboard, открыть UI и отправить тестовое сообщение.

Застряли? ​

Если ошибка непонятна, сначала запустите шлюз на переднем плане командой openclaw gateway --port 18789 и наблюдайте за логами и сообщениями об ошибках напрямую.