# 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 に QCode の OpenAI 用アドレスを入力し、接続テストを実行してから、そのモデルを既定に設定します。

## 概要

| 項目 | 内容 |
|---|---|
| 利用できるモデル | 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 が提供するデスクトップ型 AI エージェント製品で、ワンクリックでインストールできる最初のローカル 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) にあります。

## インストール

[中国版サイト](https://autoclaw.zhipuai.cn/) から macOS または Windows 用のインストーラーをダウンロードし、初回起動ガイドに従って作業フォルダーを設定してください（公式ブログでは macOS と Windows がサポートされています）。また、[ダッシュボード](https://qcode.cc/dashboard) から QCode の `cr_` キーを取得しておく必要があります。どのモデル開発元のアカウントも不要です。

## 設定

公式ブログの手順（2026-10-26）：AutoClaw を開き、左下の設定アイコンをクリックして、左側のナビゲーションで Models & API を選びます。このページには内蔵モデルとカスタムモデルの 2 つの領域があります。右側の Add custom model をクリックし、ダイアログでプロバイダーを Custom に設定します。公式の Model settings ページには別の入口もあります。チャット欄の現在のモデルをクリックし、「+」でカスタムモデルを追加すると、アプリが 設定 → Models & API に切り替わります。

ダイアログには次のように入力します。

| フィールド | 値 |
|---|---|
| Provider | `Custom` |
| Model 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 でご確認ください。

### Base URL に `/v1` は必要ですか？

はい、`/v1` までにしてください。根拠は公式ブログの例です。Ollama の場合の Base URL は `http://localhost:11434/v1` で、ブログはこれを Ollama の 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)：販売中の GLM / Kimi / DeepSeek / Qwen の現在のモデル ID
- [トラブルシューティングガイド](/docs/reference/troubleshooting)