Настройка AutoClaw с QCode

Как подключить AutoClaw от Zhipu к QCode.cc как пользовательскую модель с протоколом OpenAI: где нажать, Base URL, примеры ID моделей и проверка соединения.

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

Последняя проверка: 2026-11-10 · 📄 По официальной документации (сайт AutoClaw для Китая, версия v2.3.0, выпуск 2026-10-29)

Можно ли в AutoClaw использовать свой API-ключ? Да, по протоколу OpenAI. По состоянию на 2026-11-10, согласно официальной документации и официальному блогу: Настройки → Models & API → добавьте пользовательскую модель, в поле провайдера выберите Custom, а протокол API — OpenAI, в Base URL укажите адрес OpenAI от QCode, затем запустите проверку соединения и назначьте модель по умолчанию.

Кратко¶

Центр официальной документации описывает AutoClaw как десктопный ИИ-агент от Zhipu, первое приложение с установкой в один клик для локального OpenClaw. Есть китайский сайт (autoclaw.zhipuai.cn) и международный (autoclaw.z.ai), на английской странице которого это универсальный агент, разработанный Z.ai. Версии на 2026-11-10: в журнале изменений китайского сайта последняя — v2.3.0 (2026-10-29); в международном журнале на ту же дату последняя — v1.17.8 (2026-08-27).

Экран описан только на китайском сайте и только на китайском языке, поэтому английские названия ниже — наш перевод китайского интерфейса. На международном сайте соответствующей страницы нет, ориентируйтесь на надписи в установленной сборке.

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

В примере пользовательской модели в официальном блоге API-протокол задан как OpenAI, а в блоге сказано, что AutoClaw работает с любым сервисом моделей, совместимым с протоколом OpenAI Chat Completions. В QCode этот протокол обслуживает GPT и китайские модели (DeepSeek / GLM / Kimi / Qwen), а Base URL — https://api.qcode.cc/openai/v1.

Модели Claude работают на эндпоинте Anthropic, который экран пользовательских моделей AutoClaw не использует. Если нужен Claude, посмотрите инструменты, которые принимают эндпоинт Anthropic: LobsterAI, Qoder, OpenClaw или Claude Code в терминале (руководство по установке). Полная таблица соответствия моделей и протоколов — в разделе Точки доступа и форматы API.

Установка¶

Скачайте установщик для macOS или Windows с китайского сайта (в официальном блоге сказано, что поддерживаются macOS и Windows) и следуйте руководству при первом запуске, чтобы задать рабочую папку. Также понадобится ключ QCode вида cr_ из панели управления. Аккаунт у разработчика модели не нужен.

Настройка¶

Порядок по официальному блогу (2026-10-26): откройте AutoClaw, нажмите значок настроек внизу слева и в левой навигации выберите Models & API. На странице две области: встроенные модели и пользовательские модели. Справа нажмите Add custom model и в диалоге выберите провайдера Custom. На официальной странице Model settings есть другой путь: нажмите текущую модель в окне чата, нажмите «+», чтобы добавить пользовательскую модель, и приложение перейдёт в Настройки → Models & API.

В диалоге заполните поля так:

Примеры ID моделей: gpt-6.1-sol, gpt-6.1-terra, glm-5.3, deepseek-v4.1-flash, kimi-k3, qwen3.8-max. Цены по моделям — на https://qcode.cc/models.

Нужен ли /v1 в Base URL?¶

Да, заканчивайте на /v1. Основание — пример из официального блога: для Ollama Base URL — http://localhost:11434/v1. Блог называет это адресом OpenAI-совместимого эндпоинта Ollama и объясняет, что путь /v1 отдаёт OpenAI-совместимый API. Для QCode получается https://api.qcode.cc/openai/v1; не добавляйте /chat/completions. В официальной документации не сказано, какой сегмент пути AutoClaw добавляет к Base URL, поэтому это должна показать проверка соединения на следующем шаге. Если сеть в Азии работает нестабильно, замените хост на asia.qcode.cc; путь остаётся прежним.

Проверка соединения и назначение по умолчанию¶

1. Заполнив поля, нажмите проверку соединения. По словам официального блога, приложение отправляет настоящий запрос; статус успешного теста означает, что настройка верна.
2. Нажмите Add, чтобы зарегистрировать модель.
3. В списке моделей найдите новую модель и нажмите Set as default; задачи AutoClaw будут выполняться на ней. В блоге также сказано, что можно хранить несколько пользовательских моделей и переключаться между ними вручную.

Проверка¶

После успешного теста выберите модель в окне чата и отправьте ping. Чтобы сначала проверить сеть и ключ из терминала (ответ 400 на пустое тело означает, что путь и ключ в порядке):

KEY="cr_your_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. Введите свой ключ, чтобы увидеть модель и код статуса каждого вызова.

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

• Модель должна поддерживать вызов инструментов: официальный блог сообщает, что основные возможности AutoClaw опираются на вызов инструментов, поэтому выбранная модель должна поддерживать вызов функций. Иначе она сможет общаться, но не будет работать со Skills, и цепочка задач прервётся.
• Сторонние модели работают независимо: на официальной странице Model settings напоминается следить за состоянием и оплатой стороннего сервиса, так как вызовы могут продолжаться во время работы. Использование QCode видно в панели управления и на probe.qcode.cc.

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

• Точки доступа и форматы API — протоколы и заполнение Base URL
• Обзор совместимости инструментов — поддержка протоколов во всех инструментах
• Интеграция LobsterAI — тоже основан на OpenClaw; его пользовательские модели принимают Anthropic Compatible
• Интеграция OpenClaw — настройка самого фреймворка OpenClaw
• Китайские модели — актуальные ID GLM / Kimi / DeepSeek / Qwen, доступные в QCode
• Руководство по устранению неисправностей

Enterprise →