# راه‌اندازی AutoClaw با QCode (مدل سفارشی)

> **آخرین بازبینی**: 2026-11-10 · 📄 طبق مستندات رسمی (سایت چین AutoClaw نسخه v2.3.0، منتشرشده در 2026-10-29)

آیا AutoClaw می‌تواند از کلید API خودتان استفاده کند؟ بله، از طریق پروتکل OpenAI. تا تاریخ 2026-11-10، طبق مستندات رسمی و وبلاگ رسمی: تنظیمات → مدل‌ها و API → افزودن مدل سفارشی، ارائه‌دهنده را روی Custom و پروتکل API را روی OpenAI قرار دهید، آدرس OpenAI مربوط به QCode را به‌عنوان Base URL وارد کنید، سپس تست اتصال را اجرا کنید و مدل را به‌عنوان پیش‌فرض تنظیم کنید.

## در یک نگاه

| مورد | جزئیات |
|---|---|
| مدل‌های قابل استفاده | GPT ✅ · مدل‌های چینی ✅ (DeepSeek / GLM / Kimi / Qwen) · Claude ❌ (پروتکل سفارشی مستندشده OpenAI است) · Gemini ❌ (QCode فعلاً آن را ارائه نمی‌دهد) |
| پروتکل و Base URL | OpenAI: `https://api.qcode.cc/openai/v1` |
| محل پیکربندی | درون‌برنامه: تنظیمات → مدل‌ها و API → افزودن مدل سفارشی |
| مستندات رسمی | [تنظیمات مدل](https://autoclaw.zhipuai.cn/docs/advanced/models/) · [راهنمای راه‌اندازی مدل محلی](https://autoclaw.zhipuai.cn/blog/news/autoclaw-local-model-setup-guide/) · [تغییرات](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 پشتیبانی می‌شوند) و راهنمای اولین اجرا را برای تعیین پوشه کاری دنبال کنید. همچنین به یک کلید `cr_` از QCode از [داشبورد](https://qcode.cc/dashboard) نیاز دارید؛ نیازی به حساب کاربری نزد هیچ ارائه‌دهنده مدل نیست.

## پیکربندی

مسیر در وبلاگ رسمی (2026-10-26): AutoClaw را باز کنید، روی آیکون تنظیمات در پایین سمت چپ کلیک کنید و در پیمایش سمت چپ، مدل‌ها و API را انتخاب کنید. صفحه دو بخش دارد: مدل‌های داخلی و مدل‌های سفارشی. در سمت راست روی افزودن مدل سفارشی کلیک کنید و در کادر گفت‌وگو، ارائه‌دهنده را روی Custom بگذارید. صفحه رسمی تنظیمات مدل یک ورودی دیگر هم دارد: روی مدل فعلی در کادر چت کلیک کنید، روی "+" برای افزودن مدل سفارشی کلیک کنید و برنامه به تنظیمات → مدل‌ها و API می‌رود.

پنجره گفت‌وگو را به‌صورت زیر پر کنید:

| فیلد | مقدار |
|---|---|
| ارائه‌دهنده | `Custom` |
| شناسه مدل | دقیقاً یک مدل موجود در [qcode.cc/models](https://qcode.cc/models)، برای مثال `gpt-6.1-sol` |
| پروتکل API | `OpenAI` |
| Base URL | `https://api.qcode.cc/openai/v1` |
| کلید API | `cr_xxx` شما |

نمونه‌های شناسه مدل: `gpt-6.1-sol`، `gpt-6.1-terra`، `glm-5.3`، `deepseek-v4.1-flash`، `kimi-k3`، `qwen3.8-max`. نرخ هر مدل در https://qcode.cc/models است.

### آیا Base URL به `/v1` نیاز دارد؟

بله، و در `/v1` متوقف شوید. مبنا، مثال وبلاگ رسمی است: برای Ollama مقدار Base URL برابر `http://localhost:11434/v1` است که وبلاگ آن را نشانی نقطه پایانی سازگار با OpenAI در Ollama می‌نامد و توضیح می‌دهد که مسیر `/v1` در Ollama، API سازگار با OpenAI را ارائه می‌کند. برای QCode این مقدار به `https://api.qcode.cc/openai/v1` تبدیل می‌شود؛ `/chat/completions` را اضافه نکنید. مستندات رسمی نمی‌گویند AutoClaw کدام بخش مسیر را به Base URL اضافه می‌کند، بنابراین بگذارید آزمون اتصال در مرحله بعد تعیین کند. در شبکه ناپایدار در آسیا می‌توانید میزبان را با `asia.qcode.cc` جایگزین کنید؛ مسیر ثابت می‌ماند.

### آزمون اتصال و تنظیم به‌عنوان پیش‌فرض

1. پس از پر کردن فیلدها، روی آزمون اتصال کلیک کنید. وبلاگ رسمی می‌گوید برنامه یک درخواست واقعی ارسال می‌کند، و وضعیتی که موفقیت آزمون را نشان دهد یعنی پیکربندی درست است.
2. برای ثبت مدل روی افزودن کلیک کنید.
3. به فهرست مدل‌ها برگردید، مدل جدید را پیدا کنید و روی تنظیم به‌عنوان پیش‌فرض کلیک کنید؛ سپس وظایف 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 را هدایت کند و زنجیره وظیفه می‌شکند.
- **مدل‌های شخص ثالث مستقل اجرا می‌شوند**: صفحه رسمی تنظیمات مدل یادآوری می‌کند که وضعیت سرویس و صورت‌حساب طرف ثالث را زیر نظر داشته باشید، چون ممکن است در حین استفاده، فراخوانی‌ها همچنان ادامه یابند. مصرف 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) — شناسه‌های فعلی GLM / Kimi / DeepSeek / Qwen که عرضه شده‌اند
- [راهنمای عیب‌یابی](/docs/reference/troubleshooting)