Подключение LobsterAI к QCode

Как добавить QCode в LobsterAI как пользовательскую модель: Settings → Custom Model, выбор API Format и Base URL для Claude, GPT и китайских моделей.

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Последняя проверка: 2026-11-10 · 📄 По официальной документации (LobsterAI 2026.11.6, выпуск 2026-11-06: README, руководство пользователя, исходный код репозитория)

Можно ли в LobsterAI использовать свой API-ключ? Да. По состоянию на 2026-11-10, согласно официальному README, исходному коду репозитория и ответу сопровождающего: откройте Settings → Custom Model, нажмите + Add Custom внизу списка провайдеров, в поле API Format выберите Anthropic Compatible (Messages) или OpenAI Compatible (Chat Completions), введите Base URL QCode и свой ключ cr_, добавьте ID модели и нажмите Test Connection.

Кратко¶

Официальный FAQ описывает LobsterAI (китайское название — Youdao Lobster) как открытый десктопный ИИ-агент от NetEase Youdao, задуманный как офисный помощник для любых задач. Он построен на открытом агентном фреймворке OpenClaw, работает на macOS (Apple Silicon и Intel) и Windows и опубликован на GitHub (netease-youdao/LobsterAI) под лицензией MIT. Это отдельный продукт, не OpenClaw: OpenClaw — фреймворк среды выполнения, а LobsterAI — десктопный клиент со своим интерфейсом.

Версия: на 2026-11-10 релиз с меткой Latest на GitHub — LobsterAI 2026.11.6 (опубликован 2026-11-06); на главной странице официального сайта в тот же день указана версия 2026.10.30. Названия элементов интерфейса ниже сверены с исходным кодом 2026.11.6.

Какой протокол выбрать¶

У пользовательского провайдера несколько форматов API; для повседневной работы с QCode нужны два:

• Anthropic Compatible (Messages) + https://api.qcode.cc/api: модели Claude, а также GLM / Kimi / DeepSeek / Qwen.
• OpenAI Compatible (Chat Completions) + https://api.qcode.cc/openai/v1: модели GPT, а также GLM / Kimi / DeepSeek / Qwen.

Один ключ cr_ подходит для обоих. Модели Claude доступны только через эндпоинт Anthropic, модели GPT — только через эндпоинты OpenAI; полная таблица — в разделе Точки доступа и форматы API. Формат OpenAI Compatible (Responses) описан ниже в необязательном разделе.

Установка¶

Официальный README ведёт на страницу загрузки (macOS Apple Silicon, macOS Intel, Windows x64) или к последним установщикам в GitHub Releases. Аккаунт у разработчика моделей не нужен: создайте ключ cr_ в панели управления и держите его под рукой.

Настройка¶

Официальные источники описывают путь в меню немного по-разному:

• README: свой API-ключ добавляется в Settings → Custom Model.
• Ответ сопровождающего репозитория в issue #362 (2026-10-06): «add a custom provider under Settings → Custom Models … choose OpenAI-compatible with base URL … and the … key, add a model ID … and run Test Connection». В том же ответе сказано, что после успешной проверки провайдер включается автоматически и его можно выбрать в селекторе моделей поля ввода; второй вариант — Anthropic-совместимый формат.
• В руководстве пользователя и руководстве по настройке моделей встроенные провайдеры (DeepSeek, Moonshot, Zhipu, MiniMax, Qwen и другие) настраиваются в Settings → Models. QCode добавляется в Custom Model.

Шаг 1: добавьте пользовательского провайдера¶

1. Откройте Settings и перейдите в Custom Model.
2. Нажмите + Add Custom внизу списка провайдеров.
3. Заполните поля (названия — как в английских строках интерфейса в исходном коде 2026.11.6).

Чтобы пользоваться обоими форматами, добавьте двух пользовательских провайдеров. По официальному журналу изменений одновременно можно подключить несколько пользовательских провайдеров, не более 30.

Шаг 2: нужен ли /v1 в Base URL?¶

Ответ дают три официальных источника:

1. Подсказка под полем API Format: «Must match the protocol behind your Base URL; OpenAI-compatible URLs usually end with /v1».
2. Примеры под полем Base URL («Examples (SiliconFlow, click to fill)») связывают OpenAI Compatible с https://api.siliconflow.cn/v1, а Anthropic Compatible — с https://api.siliconflow.cn, без /v1 (исходный код репозитория).
3. Test Connection сам собирает путь запроса (исходный код репозитория, 2026.11.6). Формат Anthropic отправляет запрос на Base URL + /v1/messages, а если Base URL уже заканчивается на /v1, добавляет только /messages. Формат OpenAI Chat Completions добавляет /chat/completions, когда Base URL заканчивается версией вроде /v1, а иначе сначала дописывает /v1. Формат Responses отправляет на Base URL + /responses и тоже сначала дописывает /v1, если его нет.

Поэтому для Anthropic Compatible укажите https://api.qcode.cc/api (проверка обратится к /api/v1/messages), а для OpenAI Compatible — https://api.qcode.cc/openai/v1 (проверка обратится к /openai/v1/chat/completions). Не дописывайте в поле /v1/messages или /chat/completions вручную. На установленном LobsterAI мы эту настройку не проверяли, поэтому окончательный ответ даёт результат Test Connection. При нестабильной сети можно заменить хост на asia.qcode.cc (Азия) или us.qcode.cc (Северная Америка); путь не меняется.

Шаг 3: добавьте модель и проверьте соединение¶

1. В новом провайдере нажмите Add Model и заполните Model Name (название в списке) и Model ID.
2. Model ID должен символ в символ совпадать с моделью в продаже на qcode.cc/models, например:

1. Нажмите Test Connection. Согласно ответу сопровождающего в issue #362, после успешной проверки провайдер включается автоматически, и его можно выбрать в селекторе моделей поля ввода. Цены по моделям — на https://qcode.cc/models.

Необязательно: OpenAI Compatible (Responses)¶

В официальных примечаниях к выпуску 2026.10.23 сказано: «Custom providers now support OpenAI Responses and Gemini native APIs.» Вариант называется OpenAI Compatible (Responses), подсказка к нему: «Requires the provider to support the OpenAI Responses API. Requests go to Base URL + /responses.» В QCode Responses обслуживает модели GPT; с Base URL https://api.qcode.cc/openai/v1 запрос уходит на /openai/v1/responses, а страница эндпоинтов указывает, что этот путь равнозначен /openai/responses. Для повседневной работы достаточно OpenAI Compatible (Chat Completions). Модели Gemini QCode пока не предоставляет, поэтому вариант Gemini (generateContent) не нужен.

Проверка¶

1. Нажмите Test Connection; сообщение «Connection successful» значит, что путь и ключ в порядке.
2. Вернитесь в поле ввода, выберите новую модель в селекторе и отправьте ping.
3. Чтобы сначала проверить сеть и ключ из терминала (ответ 400 на пустое тело означает, что путь и ключ в порядке):

KEY="cr_your_key"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/api/v1/messages -H "x-api-key: $KEY"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# 400 = path and key fine; 401 = bad key; 404 = wrong path prefix

Каждый запрос отображается на probe.qcode.cc: введите свой ключ, чтобы увидеть модель и код ответа каждого вызова.

Известные ограничения и частые ошибки¶

По официальному руководству, журналу изменений, исходному коду и issue репозитория:

• Responses у пользовательских провайдеров (issue #185): в issue #185 (открыт 2026-02-28) просили поддержать новый формат API OpenAI у пользовательских провайдеров; тогда сопровождающий советовал переключить язык приложения на английский и использовать встроенного провайдера OpenAI. Сейчас: начиная с 2026.10.23 пользовательские провайдеры поддерживают OpenAI Responses (см. необязательный раздел выше).
• Язык интерфейса меняет список встроенных провайдеров: в issue #87 и #185 сопровождающий объясняет, что в английском интерфейсе появляются дополнительные встроенные провайдеры, например OpenAI и Gemini. Сейчас: в исходном коде 2026.11.6 встроенный список по-прежнему зависит от языка интерфейса, а пользовательские провайдеры показываются на обоих языках, так что настройка QCode одинакова в китайском и английском интерфейсе.
• ID Claude добавлен в формате OpenAI: QCode отвечает model_not_available_on_endpoint. Переключите API Format этого провайдера на Anthropic Compatible (Messages) и укажите https://api.qcode.cc/api; это несовпадение протокола, а не проблема ключа.
• Неизвестный ID модели: в issue #87 другой сервис ответил invalid param model:claude-haiku-4-5-20251001 (400), потому что не знал такой ID. С QCode используйте только ID, которые продаются на qcode.cc/models.
• Таблица ошибок в официальном руководстве по настройке моделей содержит четыре сообщения: «API Key Invalid», «Insufficient Balance», «Network Error» и «Service Unavailable». Для QCode: заново скопируйте ключ cr_ целиком, проверьте баланс QCode, проверьте сеть, затем — состояние сервиса.
• Хранение ключа: в официальном руководстве сказано, что API-ключ хранится только на вашем устройстве и не загружается ни на какой сервер.

Связанные документы¶

• Точки доступа и форматы API — протоколы и заполнение Base URL
• Обзор совместимости инструментов — поддержка протоколов во всех инструментах
• Подключение OpenClaw — фреймворк OpenClaw, на котором построен LobsterAI
• AutoClaw — локальное приложение OpenClaw от Zhipu (пользовательские модели работают по протоколу OpenAI)
• Qoder — ещё один десктопный агент, в пользовательских моделях которого можно указать эндпоинты Anthropic и OpenAI
• Китайские модели — актуальные ID GLM / Kimi / DeepSeek / Qwen в продаже
• Руководство по устранению неисправностей

Enterprise →