1. 先搞清楚 OpenClaw 到底在跑什么OpenClaw 是一個(gè)把自然語言指令轉(zhuǎn)成實(shí)際動(dòng)作的智能體框架它自己不帶推理能力必須外接一個(gè)大模型 API 才能理解你說的話、拆解任務(wù)、調(diào)用技能。你可以把它理解成一個(gè)「遙控器」——遙控器本身不會(huì)播節(jié)目得配上電視大模型才有畫面。2026 年這個(gè)版本對(duì) Node.js 版本、端口策略、配置結(jié)構(gòu)都做了調(diào)整很多老教程直接照抄會(huì)踩坑。它適合誰三類人一是想在自己服務(wù)器上掛一個(gè) 7×24 小時(shí)在線的助手隨時(shí)通過 Web 面板或接口調(diào)用二是對(duì)數(shù)據(jù)隱私敏感、希望所有對(duì)話和技能數(shù)據(jù)都留在本地的開發(fā)者三是想拿它對(duì)接千問或 Coding Plan 這類模型服務(wù)做自動(dòng)化任務(wù)編排的團(tuán)隊(duì)。不管哪類核心鏈路都一樣裝運(yùn)行時(shí) → 初始化 → 配模型 API → 驗(yàn)證請(qǐng)求通不通。我實(shí)測(cè)下來最容易卡住的不是安裝本身而是「模型配好了但請(qǐng)求發(fā)不出去」——報(bào)錯(cuò)五花八門401、local proxy failed、reading choices 輪番上陣。這篇就按「阿里云 本地三系統(tǒng)」兩條線把每一步命令、每一段配置、每一個(gè)驗(yàn)證動(dòng)作都攤開寫你照著敲就能復(fù)現(xiàn)。先說清楚整體結(jié)構(gòu)阿里云適合長(zhǎng)期掛機(jī)、要公網(wǎng)訪問的場(chǎng)景本地適合零成本、重隱私的場(chǎng)景。兩條線共用同一套模型配置邏輯區(qū)別只在安裝和端口放通。下面從環(huán)境準(zhǔn)備開始一步步來。環(huán)境要求先對(duì)齊阿里云推薦 2vCPU 2GiB 內(nèi)存起步帶寬 ≥3Mbps系統(tǒng)盤 ≥40GB ESSD本地 CPU ≥2 核內(nèi)存 ≥2GB推薦 4GBNode.js 必須 22.x 以上。系統(tǒng)層面 Windows 1164 位 22H2、macOS 12、Ubuntu 20.04/Debian 11 都能跑。Node 版本不對(duì)是最常見的啟動(dòng)失敗原因先node -v確認(rèn)別跳過。2. TaoToken 前置把模型入口和 Key 準(zhǔn)備好在配 OpenClaw 之前得先有一個(gè)能用的模型 API 入口。這里我用 TaoToken 作為統(tǒng)一接入層它把千問、Coding Plan 等模型服務(wù)收斂成一套兼容 OpenAI 格式的接口OpenClaw 側(cè)只需要填 Base URL Key Model ID 三件套就能通。官網(wǎng)入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 。為什么建議先過一層統(tǒng)一入口因?yàn)?OpenClaw 的 provider 配置是按「provider 名 baseurl apikey model」組織的如果你直接對(duì)接多個(gè)原生平臺(tái)每個(gè)平臺(tái)的鑒權(quán)頭、路徑、模型命名都不一樣切換和排障都麻煩。統(tǒng)一入口之后你換模型只改 Model IDBase URL 和 Key 不動(dòng)驗(yàn)證邏輯也一致。拿 Key 的路徑進(jìn)控制臺(tái) https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 頁(yè)面創(chuàng)建復(fù)制出來形如sk-開頭的字符串。這個(gè) Key 就是后面配置里providers.xxx.apikey的值。注意別把它貼到公開倉(cāng)庫(kù)本地配置文件權(quán)限設(shè)成 600。模型側(cè)有兩個(gè)方向一是走模型對(duì)話驗(yàn)證連通性入口 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 二是長(zhǎng)期編碼 / Agent 場(chǎng)景用 Coding Plan入口 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。Coding Plan 適合高頻調(diào)用、需要穩(wěn)定額度的場(chǎng)景普通對(duì)話驗(yàn)證用模型對(duì)話頁(yè)就夠。接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面列了各模型的 Model ID 命名規(guī)則配 OpenClaw 時(shí)直接對(duì)照填。如果你用 Claude Code 類工具Anthropic 兼容入口是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 對(duì)應(yīng)的 Key 管理頁(yè)ClaudeCodeAnthropic 的 deep link 是 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 。前置準(zhǔn)備清單一個(gè)可用的 API Key、確認(rèn)好的 Base URLhttps://taotoken.net/api 、一個(gè) Model ID比如千問系列或 Coding Plan 對(duì)應(yīng)模型。這三樣齊了后面 OpenClaw 的 provider 配置就是填空題。3. 可復(fù)制配置阿里云與本地三系統(tǒng)落地這一節(jié)是全文最核心的部分所有片段都能直接復(fù)制。先講阿里云再講本地三系統(tǒng)最后給統(tǒng)一的模型配置片段。阿里云側(cè)買實(shí)例時(shí)選「應(yīng)用鏡像」里的 OpenClaw 鏡像預(yù)裝了 Node.js 22省去手動(dòng)裝運(yùn)行時(shí)。地域優(yōu)先選免備案區(qū)域國(guó)內(nèi)業(yè)務(wù)選華東 1杭州。實(shí)例規(guī)格 2vCPU 2GiB 40GiB ESSD 起步。連上服務(wù)器后先更新依賴并拿到隨機(jī)端口# 更新系統(tǒng)依賴 yum update -y --disablerepo* --enablerepoaliyunos,epel # 獲取 OpenClaw 隨機(jī)端口2026 版本默認(rèn)隨機(jī)不是固定 18789 openclaw config get gateway.port # 放行隨機(jī)端口把 PORT 換成上一步拿到的數(shù)字 firewall-cmd --add-portPORT/tcp --permanent firewall-cmd --add-port80/tcp --permanent firewall-cmd --add-port443/tcp --permanent firewall-cmd --reload # 驗(yàn)證放行結(jié)果 firewall-cmd --list-ports端口這步是阿里云部署最大的坑2026 版本端口是隨機(jī)的老教程寫死 18789 會(huì)導(dǎo)致 Web 面板打不開。一定要先config get gateway.port拿到真實(shí)端口再放行。接著初始化并啟動(dòng)cd /opt/openclaw npm config set registry https://registry.npmmirror.com/ openclaw onboard --non-interactive --accept-risk --enable-skill-market openclaw gateway start --daemon openclaw token generate --admin --allow-ip 0.0.0.0/0 openclaw dashboard url最后一行會(huì)輸出 WebUI 訪問地址復(fù)制到瀏覽器打開用生成的 admin Token 登錄。本地三系統(tǒng)。macOS/Linux 用官方國(guó)內(nèi)鏡像腳本curl -fsSL https://open-claw.org.cn/install-cn.sh | bash openclaw --version openclaw onboard --non-interactive --accept-risk --enable-skill-market openclaw gateway start --daemon openclaw token generate --admin openclaw dashboard urlWindows 11 用管理員 PowerShellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser choco install git -y iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex裝完繼續(xù)執(zhí)行和 macOS 相同的 onboard / start / token / dashboard 四條命令。模型配置片段這是 §3 必須給的可復(fù)制 JSON。OpenClaw 的配置文件在~/.openclaw/openclaw.json你可以直接編輯也可以用openclaw config set逐項(xiàng)寫。下面是走 TaoToken 統(tǒng)一入口的完整 JSON 結(jié)構(gòu){ agents: { defaults: { model: { primary: taotoken/qwen3.5-plus } } }, providers: { taotoken: { baseurl: https://taotoken.net/api, apikey: sk-你的TaoToken-Key, temperature: 0.7, maxTokens: 2048 } } }如果你要分別對(duì)接千問原生和 Coding Plan用命令行寫# 千問方向 openclaw config set agents.defaults.model.primary dashscope-api/qwen3.5-plus openclaw config set providers.dashscope-api.apikey sk-你的千問Key openclaw config set providers.dashscope-api.baseurl https://dashscope.aliyuncs.com/compatible-mode/v1 openclaw config set providers.dashscope-api.temperature 0.7 openclaw config set providers.dashscope-api.maxTokens 2048 # Coding Plan 方向 openclaw config set agents.defaults.model.primary coding-plan/qwen3.5-plus openclaw config set providers.coding-plan.apikey sk-sp-你的CodingPlanKey openclaw config set providers.coding-plan.baseurl https://coding.dashscope.aliyuncs.com/v1 openclaw config set providers.coding-plan.temperature 0.7 openclaw config set providers.coding-plan.maxTokens 1024 openclaw gateway restart三件套對(duì)照表配任何 provider 都按這個(gè)填配置項(xiàng)含義示例值baseurl接口根地址https://taotoken.net/apiapikey鑒權(quán)密鑰sk-xxxxxxxxmodel.primary主模型 IDtaotoken/qwen3.5-plus改完配置必須openclaw gateway restart否則不生效。這一步漏掉的人特別多表現(xiàn)為「配置明明改了但請(qǐng)求還是走舊模型」。4. 驗(yàn)證請(qǐng)求從連通性到真實(shí)對(duì)話配完不驗(yàn)證等于沒配。這一節(jié)給逐項(xiàng)驗(yàn)證動(dòng)作每一步都有預(yù)期結(jié)果對(duì)不上就往下看排障。第一步確認(rèn)服務(wù)在跑openclaw gateway status預(yù)期輸出里有running和當(dāng)前端口號(hào)。如果是stopped先openclaw gateway start --daemon。第二步驗(yàn)證 provider 配置讀到了openclaw config get providers.taotoken.baseurl openclaw config get agents.defaults.model.primary兩條命令分別回顯你填的 Base URL 和 Model ID。如果回顯為空說明配置沒寫進(jìn)去檢查 JSON 文件路徑和語法。第三步發(fā)一條真實(shí)請(qǐng)求。OpenClaw 提供 CLI 直連測(cè)試openclaw chat --message 用一句話說明你現(xiàn)在用的是哪個(gè)模型預(yù)期返回一段自然語言且內(nèi)容里能看出模型身份。如果這里報(bào)錯(cuò)基本就是 Key 或 Base URL 的問題。第四步走 HTTP 層驗(yàn)證排除 OpenClaw 封裝干擾curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: qwen3.5-plus, messages: [{role: user, content: ping}] }預(yù)期返回 JSONchoices[0].message.content里有內(nèi)容。這一步通了說明 Key、Base URL、模型 ID 三件套全對(duì)問題只可能在 OpenClaw 側(cè)。第五步WebUI 端到端。打開openclaw dashboard url給的地址登錄后在對(duì)話框發(fā)一條消息看是否正常返回。WebUI 通了整條鏈路就閉環(huán)了。驗(yàn)證順序建議嚴(yán)格按「服務(wù)狀態(tài) → 配置回顯 → CLI 請(qǐng)求 → HTTP 請(qǐng)求 → WebUI」走哪一步斷掉就鎖定哪一層別一上來就懷疑模型。我踩過的坑是HTTP 層通了但 WebUI 不通最后發(fā)現(xiàn)是瀏覽器緩存了舊的 Token清一下就好。5. 常見報(bào)錯(cuò)逐項(xiàng)排查這一節(jié)按真實(shí)報(bào)錯(cuò)對(duì)照每條都給定位方法和修復(fù)動(dòng)作。401 Unauthorized。最常見Key 錯(cuò)了或沒帶上。先確認(rèn)providers.xxx.apikey的值和 TaoToken 控制臺(tái)里的一致注意前后不能有空格。然后確認(rèn)請(qǐng)求頭是Authorization: Bearer sk-xxxBearer 后面有一個(gè)空格。如果 Key 是從網(wǎng)頁(yè)復(fù)制的檢查有沒有把換行符帶進(jìn)去。修復(fù)后openclaw gateway restart。local proxy failed。這個(gè)報(bào)錯(cuò)通常出現(xiàn)在本地部署且配了代理類中間層時(shí)。OpenClaw 2026 版本對(duì)本地回環(huán)地址的請(qǐng)求有校驗(yàn)如果你的 Base URL 指向了本機(jī)某個(gè)轉(zhuǎn)發(fā)端口會(huì)被攔。解決方法是把 Base URL 直接指向 https://taotoken.net/api 不要經(jīng)過本地轉(zhuǎn)發(fā)。同時(shí)檢查環(huán)境變量里有沒有殘留的HTTP_PROXY/HTTPS_PROXY有就 unset 掉再重啟服務(wù)。reading choices 報(bào)錯(cuò)。典型表現(xiàn)是Cannot read properties of undefined (reading choices)。這說明請(qǐng)求發(fā)出去了但返回體結(jié)構(gòu)不對(duì)——大概率是 Base URL 少了/v1或多了/v1。TaoToken 的根地址是 https://taotoken.net/api OpenClaw 內(nèi)部會(huì)拼/v1/chat/completions所以 baseurl 填到/api為止不要再加/v1。填錯(cuò)就會(huì)拿到非預(yù)期響應(yīng)解析 choices 時(shí)崩掉。OAuth 相關(guān)報(bào)錯(cuò)。如果你用的是 Claude Code 類工具對(duì)接報(bào) OAuth 失敗檢查是不是把 Anthropic 兼容入口和普通 API 入口混用了。Claude Code 場(chǎng)景走 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 對(duì)應(yīng)的配置方式Key 從 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 拿。普通 OpenClaw 對(duì)話不需要 OAuth用 Bearer Key 即可。服務(wù)啟動(dòng)失敗。先node -v確認(rèn)是 22.x。Linux 上如果版本低curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs再openclaw gateway start --daemon。Windows 上如果 PowerShell 報(bào)執(zhí)行策略錯(cuò)誤回到 §3 的Set-ExecutionPolicy那步。Web 控制臺(tái)打不開。三個(gè)檢查點(diǎn)地域是否免備案、隨機(jī)端口是否放行firewall-cmd --list-ports看有沒有你拿到的那個(gè)端口、服務(wù)是否 running。三條都過還打不開openclaw gateway restart再來一次。數(shù)據(jù)備份。配置和技能數(shù)據(jù)都在~/.openclaw/下定期備份cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw-backup.json cp -r ~/.openclaw/skills ~/.openclaw/skills-backup排障時(shí)如果涉及 Cline MCP 或 Codex auth.json 的配置記住三件套必須齊全Base URL、Key、Model ID缺一個(gè)都會(huì)報(bào)鑒權(quán)或模型找不到。CC Switch 切換 provider 后同樣要 restart。6. 長(zhǎng)期跑起來把配置固化下來部署通了只是開始長(zhǎng)期穩(wěn)定運(yùn)行還得做幾件事。第一把模型配置寫進(jìn)版本管理但 Key 用環(huán)境變量注入別硬編碼在 JSON 里。OpenClaw 支持讀環(huán)境變量你可以在啟動(dòng)腳本里export TAOTOKEN_KEYsk-xxx配置文件里寫apikey: ${TAOTOKEN_KEY}。第二阿里云實(shí)例設(shè)個(gè)快照策略每周自動(dòng)備份系統(tǒng)盤。本地的話~/.openclaw/目錄加進(jìn)你的同步盤或 git 私倉(cāng)。第三監(jiān)控端口和進(jìn)程。簡(jiǎn)單做法是加一條 cron*/5 * * * * openclaw gateway status | grep -q running || openclaw gateway start --daemon第四模型切換不用重裝。想從千問換到 Coding Plan只改agents.defaults.model.primary和對(duì)應(yīng) provider 的 apikeyrestart 即可。長(zhǎng)期編碼 / Agent 高頻場(chǎng)景建議直接上 Coding Plan入口 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 額度更穩(wěn)。最后給一個(gè)我常用的驗(yàn)證腳本每次改完配置跑一遍五秒確認(rèn)鏈路健康#!/bin/bash echo 服務(wù)狀態(tài) openclaw gateway status echo 當(dāng)前模型 openclaw config get agents.defaults.model.primary echo 連通性 curl -s -o /dev/null -w %{http_code} -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_KEY \ -H Content-Type: application/json \ -d {model:qwen3.5-plus,messages:[{role:user,content:ping}]} echo 返回 200 就說明整條鏈路是通的。把這套流程跑順之后OpenClaw 在阿里云和本地三系統(tǒng)上的部署差異其實(shí)就只剩安裝和端口兩步模型配置完全通用。