yycode × OpenClaw 快速開始指南

適用場景

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

如果你還沒安裝 Node.js，請先參考 Node.js 環境安裝指南。

1. 準備事項

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

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

支援的模型

OpenAI 相容模型

Anthropic 相容模型

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

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

第一步：安裝 OpenClaw

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

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

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

openclaw --help

第二步：啟動接入向導

openclaw onboard

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

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

基礎地址填寫說明：

• 選擇 Anthropic-compatible 時，填寫：https://yycode.net
• 選擇 OpenAI-compatible 時，需要在末尾加上 /v1，填寫：https://yycode.net/v1

第四步：完成向導並驗證

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

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

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

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

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

3. 腳本化接入

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

第一步：導出 API Key

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

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

# 非交互式接入：將 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 檢查實際引用的變數名；如果你的版本寫入的是別的變數名，再按實際設定補環境變數即可，例如：

export OPENAI_API_KEY="YOUR_yycode_API_KEY"

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

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

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

{
  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 文件。

7. 下一步

• 還沒建立 Key：回到 yycode 控制台 先建立 API Key
• 想先設定其他開發工具：繼續檢視 Claude Code快速開始指南 和 Codex快速開始指南
• 需要安裝執行環境：檢視 Node.js 環境安裝指南
• 遇到常見接入問題：檢視 常見問題