1. OpenClaw 本地部署到底解決什么問題OpenClaw 是一個(gè)可以跑在自己電腦上的 AI 智能體框架前身叫 Clawdbot。它和網(wǎng)頁(yè)版聊天工具最大的區(qū)別在于它能真正操作你的文件系統(tǒng)、執(zhí)行命令、調(diào)用插件并且把對(duì)話記憶存在本地。你可以把它理解成一個(gè)「住在你電腦里的助理」你說「幫我把下載文件夾里上周的截圖按日期歸檔」它會(huì)真的去移動(dòng)文件而不是只給你一段操作說明。適合誰(shuí)用三類人最合適。第一類是經(jīng)常處理重復(fù)文件操作的開發(fā)者比如批量重命名、日志清理、項(xiàng)目腳手架生成。第二類是想把大模型能力接進(jìn)自己工作流的人比如讓 AI 讀本地代碼庫(kù)然后回答問題。第三類是注重?cái)?shù)據(jù)隱私、不希望對(duì)話內(nèi)容上傳到第三方平臺(tái)的用戶因?yàn)?OpenClaw 的記憶和配置默認(rèn)落在本地目錄。但本地部署有個(gè)繞不開的坎模型從哪來(lái)。OpenClaw 本身不帶模型它需要對(duì)接一個(gè)兼容 OpenAI 協(xié)議的大模型接口。你可以選擇千問大模型 Coding Plan通過 TaoToken 統(tǒng)一通道接入這樣一套 Key 就能同時(shí)驅(qū)動(dòng) OpenClaw 的對(duì)話、代碼補(bǔ)全和 Skills 調(diào)用。官網(wǎng)地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 入口是 https://taotoken.net/api。這篇內(nèi)容我會(huì)按「環(huán)境準(zhǔn)備 → 安裝 OpenClaw → 配置 TaoToken 通道 → 對(duì)接千問 Coding Plan → 驗(yàn)證請(qǐng)求 → 排錯(cuò)」的順序走一遍。全程命令可以直接復(fù)制Windows、macOS、Linux 都覆蓋。實(shí)測(cè)下來(lái)網(wǎng)絡(luò)正常的情況下 4 分鐘能跑通基礎(chǔ)對(duì)話。先說清楚一個(gè)概念OpenClaw 的配置文件叫config.json模型相關(guān)的字段都在model節(jié)點(diǎn)下。很多人卡住不是因?yàn)槊钋缅e(cuò)而是配置文件里base_url和model_name寫得不匹配。后面我會(huì)給出完整可復(fù)制的 JSON 片段。另外提醒一點(diǎn)OpenClaw 默認(rèn)的 Web 控制臺(tái)端口是 18789本地訪問用http://127.0.0.1:18789。如果你在服務(wù)器上部署需要放行這個(gè)端口并且把gateway.host設(shè)成0.0.0.0才能從外部訪問。這些細(xì)節(jié)在第三節(jié)會(huì)展開。2. TaoToken 前置準(zhǔn)備與千問 Coding Plan 開通在裝 OpenClaw 之前先把模型通道準(zhǔn)備好這樣安裝完直接填配置就能用不用來(lái)回切換窗口。TaoToken 在這里扮演的角色是「統(tǒng)一 API 通道」你不需要為每個(gè)模型單獨(dú)記一套地址和 Key它把千問、Claude、GPT 等模型的調(diào)用入口統(tǒng)一到https://taotoken.net/api下面OpenClaw 只需要認(rèn)這一個(gè)base_url。第一步打開 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注冊(cè)賬號(hào)。注冊(cè)流程很常規(guī)郵箱加密碼收一封驗(yàn)證郵件點(diǎn)確認(rèn)就行。這里不展開注冊(cè)細(xì)節(jié)重點(diǎn)說后面怎么拿 Key 和選模型。第二步進(jìn)入控制臺(tái)的 API Keys 頁(yè)面。地址是 https://taotoken.net/api-keys 登錄后點(diǎn)「創(chuàng)建密鑰」系統(tǒng)會(huì)生成一串以sk-開頭的字符串。這串東西只顯示一次復(fù)制下來(lái)存到安全的地方。如果你用的是密碼管理器直接存進(jìn)去如果沒有至少別貼在公開的聊天記錄里。第三步確認(rèn)你要用的模型 ID。千問大模型 Coding Plan 對(duì)應(yīng)的模型標(biāo)識(shí)通常是qwen-coder系列具體名稱以控制臺(tái)「模型列表」頁(yè)面顯示的為準(zhǔn)。地址是 https://taotoken.net/doc 里面有當(dāng)前支持的模型清單和對(duì)應(yīng)的調(diào)用名稱。這一步很關(guān)鍵因?yàn)?OpenClaw 配置里的model_name必須和通道支持的名稱完全一致寫錯(cuò)了會(huì)報(bào)model not found。第四步如果你打算長(zhǎng)期做編碼任務(wù)或者跑 Agent 流程可以看一下 Coding Plan 的訂閱說明。地址是 https://taotoken.net/coding-plan 。它的計(jì)費(fèi)方式和按 token 計(jì)費(fèi)不同更適合高頻調(diào)用場(chǎng)景。我自己的用法是日常問答走按量連續(xù)幾小時(shí)的代碼重構(gòu)任務(wù)走 Coding Plan這樣成本更可控。這里插一句關(guān)于 Key 的安全提醒。TaoToken 的 Key 等同于你的調(diào)用憑證泄露了別人可以消耗你的額度。所以配置文件不要提交到 Git 倉(cāng)庫(kù)建議在.gitignore里加上config.json或者~/.openclaw/整個(gè)目錄。如果你在多臺(tái)機(jī)器上用每臺(tái)機(jī)器單獨(dú)生成一個(gè) Key方便出問題時(shí)單獨(dú)吊銷。準(zhǔn)備好這三樣?xùn)|西API Key、Base URLhttps://taotoken.net/api、模型 ID千問 Coding Plan 對(duì)應(yīng)的名稱就可以進(jìn)入下一節(jié)裝 OpenClaw 了。3. OpenClaw 安裝與 TaoToken 通道可復(fù)制配置這一節(jié)是全文的核心操作部分。我會(huì)先給安裝命令再給配置文件片段最后說啟動(dòng)和驗(yàn)證。你按順序執(zhí)行即可。3.1 Node.js 環(huán)境檢查與安裝OpenClaw 依賴 Node.js 22.x 及以上版本。先檢查node -v npm -v如果輸出版本號(hào)且 node 大于等于 22跳過安裝。如果提示command not found按系統(tǒng)選擇下面的命令。macOS 用 Homebrewbrew install nodeUbuntu/Debiansudo apt update sudo apt install -y curl git curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejsWindows 11 用 winget管理員 PowerShellwinget install OpenJS.NodeJS --version 22.0.0裝完重新開一個(gè)終端再跑一次node -v確認(rèn)。3.2 安裝 OpenClaw 與初始化配置 npm 鏡像可以加快下載npm config set registry https://registry.npmmirror.com然后全局安裝npm install -g openclaw安裝完成后初始化openclaw onboard初始化過程會(huì)問幾個(gè)問題同意協(xié)議選 yes啟動(dòng)模式選快速啟動(dòng)模型配置這一步先跳過我們手動(dòng)寫配置文件通道啟用選全部。走完之后會(huì)在用戶目錄下生成配置文件夾。配置文件路徑macOS/Linux~/.openclaw/config.jsonWindowsC:\Users\你的用戶名\.openclaw\config.json3.3 寫入 TaoToken 通道配置用文本編輯器打開config.json找到model節(jié)點(diǎn)替換成下面這段。注意把sk-你的Key換成第 2 節(jié)拿到的真實(shí) Keymodel_name換成控制臺(tái)里千問 Coding Plan 對(duì)應(yīng)的名稱。{ model: { type: openai, api_key: sk-你的Key, base_url: https://taotoken.net/api, model_name: qwen-coder, max_tokens: 4096, temperature: 0.3, timeout: 60, reasoning: false }, gateway: { host: 127.0.0.1, port: 18789 } }幾個(gè)參數(shù)說明。type寫openai是因?yàn)?TaoToken 的接口兼容 OpenAI 協(xié)議OpenClaw 用這個(gè)類型就能識(shí)別。base_url結(jié)尾不要加/v1通道本身已經(jīng)處理了路徑。temperature設(shè) 0.3 是因?yàn)榫幋a任務(wù)需要穩(wěn)定輸出太高會(huì)亂編。timeout給 60 秒千問在長(zhǎng)上下文時(shí)響應(yīng)會(huì)慢一些。reasoning設(shè) false 可以避免部分模型返回空內(nèi)容的問題。如果你在服務(wù)器上部署需要外部訪問 Web 控制臺(tái)把gateway.host改成0.0.0.0同時(shí)安全組放行 18789 端口。3.4 啟動(dòng)服務(wù)openclaw gateway start看到gateway started之類的提示就說明起來(lái)了。瀏覽器打開http://127.0.0.1:18789應(yīng)該能看到對(duì)話界面。如果你想讓服務(wù)開機(jī)自啟Linux 下可以寫進(jìn) rc.localecho /usr/bin/openclaw gateway start | sudo tee -a /etc/rc.local sudo chmod x /etc/rc.local到這里配置就完成了。下一節(jié)驗(yàn)證請(qǐng)求是否真的通到了千問。4. 驗(yàn)證請(qǐng)求與成功結(jié)果確認(rèn)配置寫完不代表通道就通了必須發(fā)一次真實(shí)請(qǐng)求確認(rèn)。有兩種驗(yàn)證方式建議都做一遍。4.1 命令行直接測(cè)通道先用 curl 測(cè) TaoToken 通道本身是否可用這一步能排除 OpenClaw 的干擾curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: qwen-coder, messages: [{role: user, content: 用一句話說明什么是遞歸}], max_tokens: 100 }如果返回 JSON 里choices[0].message.content有內(nèi)容說明 Key、Base URL、模型名三者都對(duì)。如果返回 401是 Key 問題返回 404 或 model not found是模型名寫錯(cuò)返回超時(shí)檢查網(wǎng)絡(luò)到taotoken.net的連通性。4.2 在 OpenClaw 里發(fā)消息驗(yàn)證打開 Web 控制臺(tái)輸入一句測(cè)試指令比如「列出當(dāng)前目錄下的文件」。如果 OpenClaw 調(diào)用了模型并返回結(jié)果說明整條鏈路通了。更直接的驗(yàn)證是看日志openclaw logs --follow發(fā)消息的時(shí)候觀察日志輸出。成功的請(qǐng)求會(huì)顯示類似model request completed的記錄帶上 token 消耗數(shù)。如果看到connection refused或者401 unauthorized對(duì)照第 5 節(jié)排查。4.3 驗(yàn)證 Skills 是否加載Skills 是 OpenClaw 的擴(kuò)展能力。裝一個(gè)搜索技能測(cè)試npm install -g clawhub clawhub install tavily-search openclaw gateway restart openclaw skill listskill list里能看到tavily-search且狀態(tài)是 enabled就說明技能加載正常。然后在對(duì)話里讓它「搜索今天的天氣」如果返回了搜索結(jié)果說明 Skills 和模型通道協(xié)同工作正常。成功的結(jié)果長(zhǎng)這樣控制臺(tái)能對(duì)話、日志有請(qǐng)求記錄、技能列表非空、curl 返回內(nèi)容。四個(gè)都滿足環(huán)境就算徹底跑通了。5. 常見報(bào)錯(cuò)排查清單這一節(jié)按真實(shí)報(bào)錯(cuò)信息來(lái)對(duì)照你遇到哪條查哪條。401 Unauthorized / invalid api key最常見。原因有三個(gè)Key 復(fù)制時(shí)帶了空格、Key 被吊銷、配置文件里api_key字段名寫錯(cuò)。檢查方法把 Key 重新復(fù)制一遍確認(rèn)config.json里是api_key而不是apikey或key。改完openclaw gateway restart。local proxy failed / connection refusedOpenClaw 連不上base_url。先確認(rèn)base_url是https://taotoken.net/api沒有多余斜杠。然后測(cè)網(wǎng)絡(luò)curl -I https://taotoken.net/api如果 curl 也連不上是網(wǎng)絡(luò)層問題檢查 DNS 和防火墻。如果 curl 通但 OpenClaw 不通檢查配置文件里有沒有殘留的舊base_url。reading choices: unexpected end of JSON input模型返回了空響應(yīng)。兩個(gè)原因reasoning沒設(shè) false或者max_tokens太小導(dǎo)致輸出被截?cái)?。在model節(jié)點(diǎn)加上reasoning: false把max_tokens提到 4096重啟服務(wù)。OAuth / token expired如果你之前配過其他通道的 OAuth 認(rèn)證殘留的 token 會(huì)干擾。清理方式刪掉~/.openclaw/下的auth相關(guān)文件重新跑openclaw onboard --reset然后重新寫 TaoToken 配置。model not foundmodel_name和通道支持的名稱不一致。打開 https://taotoken.net/doc 對(duì)照模型列表確認(rèn)千問 Coding Plan 對(duì)應(yīng)的準(zhǔn)確名稱。注意大小寫和連字符。端口 18789 被占用# Linux/macOS lsof -i:18789 kill -9 進(jìn)程ID # Windows netstat -ano | findstr 18789 taskkill /F /PID 進(jìn)程ID或者改配置文件里的gateway.port換一個(gè)端口。clawhub 命令不可用npm install -g clawhub如果還不行檢查 npm 全局 bin 目錄是否在 PATH 里。技能裝了不生效技能安裝后必須重啟網(wǎng)關(guān)openclaw gateway restart。然后用openclaw skill status 技能名看狀態(tài)。如果狀態(tài)是 disabled用openclaw skill start 技能名手動(dòng)啟動(dòng)。Windows 執(zhí)行策略禁止腳本管理員 PowerShell 執(zhí)行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser權(quán)限不足無(wú)法全局安裝Linux/macOS 下加 sudo或者配置 npm 的全局目錄到用戶空間npm config set prefix ~/.npm-global export PATH~/.npm-global/bin:$PATH排查的核心思路是分層先測(cè)通道curl再測(cè) OpenClaw 到通道日志最后測(cè)技能skill list。哪一層斷了就修哪一層不要一上來(lái)就重裝。6. 長(zhǎng)期使用建議與接入入口跑通之后有幾個(gè)習(xí)慣能讓這套環(huán)境更穩(wěn)。第一配置文件做備份。config.json里存著 Key 和模型參數(shù)換機(jī)器或者重裝時(shí)直接復(fù)制過去就能用。但備份文件別放公開網(wǎng)盤。第二日志定期清理。openclaw logs會(huì)累積長(zhǎng)期跑建議加個(gè)定時(shí)任務(wù)清理舊日志避免占滿磁盤。第三模型參數(shù)按任務(wù)調(diào)。編碼任務(wù)用temperature: 0.3創(chuàng)意類任務(wù)可以調(diào)到 0.7。max_tokens根據(jù)任務(wù)復(fù)雜度設(shè)簡(jiǎn)單問答 1024 夠用長(zhǎng)代碼生成給 4096。第四多機(jī)器用不同 Key。這樣某臺(tái)機(jī)器出問題可以單獨(dú)吊銷不影響其他機(jī)器。如果你還沒拿到 Key或者想先看看模型對(duì)話效果再?zèng)Q定可以從模型對(duì)話入口進(jìn)去試https://taotoken.net/model-chat 。想直接開始配置的去 API Keys 頁(yè)面創(chuàng)建密鑰https://taotoken.net/api-keys 。接入文檔在 https://taotoken.net/doc 里面有完整的參數(shù)說明和模型清單。長(zhǎng)期做編碼任務(wù)的話Coding Plan 的說明在 https://taotoken.net/coding-plan 。整套流程走下來(lái)最花時(shí)間的其實(shí)是 Node.js 環(huán)境準(zhǔn)備和第一次下載依賴。配置本身只要把 JSON 片段填對(duì)重啟一次就生效。我踩過的坑主要集中在model_name寫錯(cuò)和reasoning沒關(guān)這兩個(gè)點(diǎn)上你按第 5 節(jié)對(duì)照基本能秒解。