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

> **Последняя проверка**: 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, затем запустите проверку соединения и назначьте модель по умолчанию.

## Кратко

| Параметр | Подробности |
|---|---|
| Доступные модели | GPT ✅ · китайские модели ✅ (DeepSeek / GLM / Kimi / Qwen) · Claude ❌ (задокументированный пользовательский протокол — OpenAI) · Gemini ❌ (QCode пока не предоставляет его) |
| Протокол и Base URL | OpenAI: `https://api.qcode.cc/openai/v1` |
| Где настроить | В приложении: Настройки → Models & API → добавить пользовательскую модель |
| Официальная документация | [Model settings](https://autoclaw.zhipuai.cn/docs/advanced/models/) · [Local model setup guide](https://autoclaw.zhipuai.cn/blog/news/autoclaw-local-model-setup-guide/) · [Changelog](https://autoclaw.zhipuai.cn/changelog/) |

Центр официальной документации описывает 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](/docs/ide/lobsterai), [Qoder](/docs/ide/qoder), [OpenClaw](/docs/ide/openclaw) или Claude Code в терминале ([руководство по установке](/docs/getting-started/installation)). Полная таблица соответствия моделей и протоколов — в разделе [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths).

## Установка

Скачайте установщик для macOS или Windows с [китайского сайта](https://autoclaw.zhipuai.cn/) (в официальном блоге сказано, что поддерживаются macOS и Windows) и следуйте руководству при первом запуске, чтобы задать рабочую папку. Также понадобится ключ QCode вида `cr_` из [панели управления](https://qcode.cc/dashboard). Аккаунт у разработчика модели не нужен.

## Настройка

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

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

| Поле | Значение |
|---|---|
| Provider | `Custom` |
| Model ID | ID модели в точности как на [qcode.cc/models](https://qcode.cc/models), например `gpt-6.1-sol` |
| API protocol | `OpenAI` |
| Base URL | `https://api.qcode.cc/openai/v1` |
| API Key | ваш `cr_xxx` |

Примеры 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 на пустое тело означает, что путь и ключ в порядке):

```bash
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](https://probe.qcode.cc). Введите свой ключ, чтобы увидеть модель и код статуса каждого вызова.

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

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

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

- [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths) — протоколы и заполнение Base URL
- [Обзор совместимости инструментов](/docs/ide/tool-compatibility) — поддержка протоколов во всех инструментах
- [Интеграция LobsterAI](/docs/ide/lobsterai) — тоже основан на OpenClaw; его пользовательские модели принимают Anthropic Compatible
- [Интеграция OpenClaw](/docs/ide/openclaw) — настройка самого фреймворка OpenClaw
- [Китайские модели](/docs/usage/cn-models) — актуальные ID GLM / Kimi / DeepSeek / Qwen, доступные в QCode
- [Руководство по устранению неисправностей](/docs/reference/troubleshooting)