canonical_url: https://yycode.net/docs/zh-TW/openclaw-quickstart
lang: zh-TW
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/zh-TW/openclaw-quickstart

# yycode × OpenClaw 快速開始指南

## 適用場景

這篇指南只解決一件事：把 OpenClaw 的模型服務接到 yycode，並完成一次可用性驗證。

如果你還沒安裝 Node.js，請先參考 [Node.js 環境安裝指南](nodejs-setup)。

---

## 1. 準備事項

開始前請先確認以下幾點：

- 你已經在 [yycode 控制台](https://yycode.net/console/token) 建立好一枚 API Key
- 你知道要調用的實際模型名，例如 `gpt-5.4`（完整支援清單見下方[支援的模型](#支持的模型)）
- 你的執行環境滿足 OpenClaw 官方要求：推薦 `Node 24`，相容 `Node 22.16+`
- Windows 使用者建議優先使用 `WSL2 + Ubuntu` 安裝和執行 OpenClaw

---

## 支援的模型

### OpenAI 相容模型

| 模型名 |
|---|
| `gpt-5.4` |
| `gpt-5.2` |
| `gpt-5.3-codex` |
| `gpt-5.2-codex` |
| `gpt-5.1-codex-max` |
| `gpt-5.1-codex-mini` |

### Anthropic 相容模型

| 模型名 |
|---|
| `claude-opus-4-6` |
| `claude-sonnet-4-6` |
| `claude-haiku-4-5-20251001` |

---

## 2. 推薦路徑：使用 OpenClaw 向導接入

如果你只是想先打通 OpenClaw 和 yycode，最省事的方式是先跑 OpenClaw 自帶向導，等瀏覽器控制台能正常回覆後，再繼續設定頻道或後台常駐。

### 第一步：安裝 OpenClaw

macOS / Linux / WSL2 可以直接執行官方安裝腳本：

```bash
# 安裝 openclaw 指令列工具，--no-onboard 表示安裝後先不自動進入向導
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
```

安裝完成後，可先驗證指令是否可用：

```bash
openclaw --help
```

### 第二步：啟動接入向導

```bash
openclaw onboard
```

### 第三步：在向導中選擇自定義服務商

當向導進入模型和鑒權步驟時，選擇 `Custom provider`，然後按下面的值填寫：

| 欄位 | 填寫值 |
|---|---|
| 相容類型 | `Anthropic-compatible`或者 `OpenAI-compatible` |
| 基礎地址 | 見下方說明 |
| 模型名 | `claude-sonnet-4-6` 或者 `gpt-5.4`（完整清單見[支援的模型](#支持的模型)）|
| Provider ID | `yycode` |
| API Key | 你建立的 yycode API Key |

> **基礎地址填寫說明：**
> - 選擇 `Anthropic-compatible` 時，填寫：`https://yycode.net`
> - 選擇 `OpenAI-compatible` 時，需要在末尾加上 `/v1`，填寫：`https://yycode.net/v1`

### 第四步：完成向導並驗證

首次接入時，網關端口、綁定方式和後台常駐服務都可以先保留預設值。完成向導後，依次執行：

```bash
# 檢查設定格式是否正確
openclaw doctor

# 檢視目前狀態和載入到的模型
openclaw status

# 打開本機控制台，發一條訊息驗證是否能正常回覆
openclaw dashboard
```

如果控制台裡發訊息能收到模型回覆，說明接入已經成功。

---

## 3. 腳本化接入

如果你要把 OpenClaw 初始化寫進腳本、伺服器部署流程或企業鏡像，推薦使用非交互模式。

### 第一步：導出 API Key

```bash
# 先把 yycode API Key 寫入環境變數
export CUSTOM_API_KEY="YOUR_yycode_API_KEY"
```

### 第二步：執行非交互接入指令

```bash
# 非交互式接入：將 yycode 設定為自定義服務商
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://yycode.net" \
  --custom-model-id "gpt-5.4" \
  --custom-provider-id "yycode" \
  --custom-compatibility openai \
  --secret-input-mode ref \
  --gateway-port 18789 \
  --gateway-bind loopback
```

### 第三步：確認環境變數名稱

如果你使用了 `--secret-input-mode ref`，OpenClaw 目前版本通常會把 API Key 以環境變數引用方式儲存。推薦直接使用上面的 `CUSTOM_API_KEY`，這樣和官方自動化文件保持一致。

如果你已經生成了設定，也可以打開 `~/.openclaw/openclaw.json` 檢查實際引用的變數名；如果你的版本寫入的是別的變數名，再按實際設定補環境變數即可，例如：

```bash
export OPENAI_API_KEY="YOUR_yycode_API_KEY"
```

---

## 4. 手動檢查或手動寫入設定

如果你不想跑向導，也可以直接檢查或編輯 `~/.openclaw/openclaw.json`。

下面是一份可直接參考的設定範例，請把模型名和 API Key 變數替換成你自己的實際值：

```json5
{
  agents: {
    defaults: {
      // 預設模型必須寫成“服務商 ID/模型名”格式，不能只寫模型名
      model: { primary: "yycode/gpt-5.4" },
    },
  },
  models: {
    providers: {
      dragoncode: {
        baseUrl: "https://yycode.net",
        // 推薦引用環境變數，避免把金鑰明文寫進設定檔案
        apiKey: "${CUSTOM_API_KEY}",
        api: "openai-completions",
        models: [
          {
            // 這裡替換成 yycode 控制台裡實際可用的模型名
            id: "gpt-5.4",
            name: "gpt-5.4",
          },
        ],
      },
    },
  },
}
```

> **最容易寫錯的地方**：預設模型必須寫成 `yycode/模型名`，例如 `yycode/gpt-5.4`，不能只寫 `gpt-5.4`。

---

## 5. 成功標準

滿足下面幾項，基本就說明接入已經打通：

- 基礎地址填寫的是 `https://yycode.net`
- API Key 仍然有效，未過期、未停用、未耗盡額度
- 預設模型寫成了 `yycode/你的模型名`
- `openclaw doctor` 和 `openclaw status` 沒有報設定錯誤
- 瀏覽器控制台能正常發訊息並收到回覆

---

## 6. 常見問題

### 明明填了地址，還是連不上

優先檢查基礎地址是不是 `https://yycode.net`。不要帶 /

### OpenClaw 能啟動，但發訊息時報模型不存在

通常先查這兩項：

- 你填寫的模型名是否就是 yycode 目前實際開放的調用名
- 預設模型是否寫成了 `yycode/模型名`，而不是只寫模型名

### 使用腳本化指令時提示 API Key 缺失

這通常是環境變數沒有真正導出成功，或者變數名和 OpenClaw 設定裡引用的不一致。

可以直接打開 `~/.openclaw/openclaw.json`，確認 `apiKey` 欄位引用的是哪個環境變數，然後在目前 shell 中補上對應變數。按照本文推薦路徑，優先檢查 `CUSTOM_API_KEY`。

### 我已經配好 OpenClaw，為什麼還不能在 WhatsApp 或 Telegram 裡用

這通常不是模型接入問題，而是頻道還沒有設定完成。本頁只負責把 OpenClaw 和 Dragon Code 之間的模型調用打通；頻道設定請繼續參考 [OpenClaw 官方 Channels 文件](https://docs.openclaw.ai/channels)。

---

## 7. 下一步

- 還沒建立 Key：回到 [yycode 控制台](https://yycode.net/console/token) 先建立 API Key
- 想先設定其他開發工具：繼續檢視 [Claude Code快速開始指南](claude-code-quickstart) 和 [Codex快速開始指南](codex-quickstart)
- 需要安裝執行環境：檢視 [Node.js 環境安裝指南](nodejs-setup)
- 遇到常見接入問題：檢視 [常見問題](faq)