方法三：手動修改 JSON 配置

僅當(dāng)前兩種方法不生效時(shí)使用，需嚴(yán)格注意語法。

1. 備份配置文件：

   cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

2. 用編輯器打開配置文件：

   nano ~/.openclaw/openclaw.json

3. 按以下結(jié)構(gòu)修改/添加配置（僅展示核心修改部分，保留原有的 Kimi 等配置）：

   {
     "auth": {
       "profiles": {
         "aliyun:default": {
           "provider": "openai",
           "mode": "api_key"
         }
       }
     },
     "models": {
       "mode": "merge",
       "providers": {
         "aliyun": {
           "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
           "api": "openai-chat",
           "models": [
             {
               "id": "qwen2.5-7b-instruct",
               "name": "Qwen2.5-7B-Instruct",
               "reasoning": false,
               "input": ["text"],
               "cost": {
                 "input": 0,
                 "output": 0,
                 "cacheRead": 0,
                 "cacheWrite": 0
               },
               "contextWindow": 32768,
               "maxTokens": 8192
             }
           ]
         }
       }
     },
     "agents": {
       "defaults": {
         "model": {
           "primary": "aliyun/qwen2.5-7b-instruct"
         },
         "models": {
           "aliyun/qwen2.5-7b-instruct": {
             "alias": "Qwen"
           }
         }
       }
     }
   }

4. 保存并退出：按 Ctrl+O 保存，按 Ctrl+X 退出。
   如下圖所示：

   

5. 校驗(yàn) JSON 語法（必須做，避免 invalid config 報(bào)錯(cuò)）：

   jq . ~/.openclaw/openclaw.json

   輸出完整 JSON 內(nèi)容且無報(bào)錯(cuò)，代表語法正確。

6. 通過命令行配置 API Key（不要寫在 JSON 里，不安全）：

   openclaw config set auth.profiles.aliyun:default.apiKey "你的阿里云API-KEY"

7. 重啟 OpenClaw 生效：

   openclaw gateway restart

三、核心避坑指南（必須閱讀，避免重復(fù)踩坑）

1. 接口地址紅線：

   • 必須使用 OpenAI 兼容地址：https://dashscope.aliyuncs.com/compatible-mode/v1

   • 嚴(yán)禁使用靈積原生 API 域名，否則 OpenClaw 無法適配。

2. 上下文窗口紅線：

   • contextWindow 必須 ≥ 16000，推薦直接填 32768（Qwen2.5-7B 原生最大值），否則會報(bào) Model context window too small 錯(cuò)誤。

3. JSON 語法紅線：

   • 所有標(biāo)點(diǎn)必須是英文半角字符，嚴(yán)禁使用中文逗號 ，、中文引號 “”。

   • 手動修改后必須用 jq 或在線 JSON 校驗(yàn)工具檢查語法。

4. 權(quán)限問題：

   • 若之前用 sudo/root 運(yùn)行過 OpenClaw，必須按前置準(zhǔn)備中的步驟修復(fù)目錄權(quán)限，否則會出現(xiàn) EACCES: permission denied 報(bào)錯(cuò)。

5. API Key 安全：

   • 優(yōu)先通過 Web UI 或 openclaw config set 命令配置 API Key，不要直接寫在 JSON 文件里。

四、驗(yàn)證配置成功

1. 重啟 OpenClaw 服務(wù)：

   openclaw gateway restart

2. 切換模型并測試：

   • 打開 Web UI 對話界面，輸入 /model Qwen（或你設(shè)置的模型別名）切換到 Qwen 模型。

   • 發(fā)送測試消息，如“你好，請介紹一下自己”，確認(rèn)能正常收到回復(fù)。

   • （可選）發(fā)送一個(gè)長文本或網(wǎng)頁抓取任務(wù)，確認(rèn)不再出現(xiàn)上下文窗口報(bào)錯(cuò)。
     如下圖所示：

     

在千問中消耗的tokens如下圖所示：

神奇的是在kimi claw中居然還可以繼續(xù)使用，不過用的是Qwen模型了，如下圖所示：

五、常見問題快速排查

六、接入了模型后，一切就感覺不可控了

你可以直接在chat窗口告訴他你想要配置的模型信息，讓他自己配置，就行了，只要?jiǎng)觿幼炱ぷ?，它就可以自己搞定?br />如下圖所示：

也可以在kimi claw中搞一把，如下圖所示：

同時(shí)可以看到配置文件：

總結(jié)

到此這篇關(guān)于OpenClaw接入阿里云永久免費(fèi)模型解決方案的文章就介紹到這了,更多相關(guān)OpenClaw接入阿里云永久免費(fèi)模型內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！