1. 為什么 Windows 解壓安裝 OpenClaw 小龍蝦總在第一步翻車OpenClaw 小龍蝦是一款可以在本機(jī)運(yùn)行的桌面 AI 智能體能聽懂自然語言指令自動(dòng)完成文件整理、表格生成、網(wǎng)頁信息抓取、消息發(fā)送這類操作。它適合不想寫代碼、又想體驗(yàn)本地自動(dòng)化辦公的 Windows 用戶。但很多人卡在第一步下載完安裝包解壓、雙擊、安裝然后報(bào)錯(cuò)。不是路徑不對(duì)就是文件被安全軟件刪了或者 Gateway 一直離線。我實(shí)測(cè)下來Windows 環(huán)境下 OpenClaw 小龍蝦解壓安裝的失敗原因高度集中基本跑不出這幾類解壓工具不兼容導(dǎo)致文件損壞、安裝路徑含中文或空格、安全軟件攔截核心進(jìn)程、首次啟動(dòng) Gateway 初始化超時(shí)。這篇就按真實(shí)操作順序把每一步的可復(fù)制配置和排雷動(dòng)作寫清楚讓你一次裝完。先明確一個(gè)前提OpenClaw 小龍蝦是本地運(yùn)行的智能體它需要調(diào)用鍵鼠模擬、文件讀寫、系統(tǒng)權(quán)限這些能力所以安全軟件誤報(bào)是常態(tài)不是程序有問題。你要做的是在安裝階段臨時(shí)放行裝完再按需恢復(fù)防護(hù)。安裝包方面Windows 整合包當(dāng)前版本是 v2.7.9文件約 45.8MB解壓后目錄名為Openclaw-win。整個(gè)流程分四段下載校驗(yàn)、解壓、啟動(dòng)安裝、驗(yàn)證 Gateway 在線。下面逐段拆。2. TaoToken 前置準(zhǔn)備給小龍蝦接上模型能力OpenClaw 小龍蝦本身是執(zhí)行框架它要真正“聽懂”指令并拆解任務(wù)背后需要一個(gè)大模型來提供推理能力。你可以把它理解成小龍蝦是手和腳模型是大腦。默認(rèn)整合包里可能內(nèi)置了基礎(chǔ)額度但如果你想長期用、或者想換成更穩(wěn)定的模型通道就需要配置一個(gè)兼容 OpenAI 接口的模型服務(wù)。這里我用 TaoToken 來做模型接入原因是它的接口格式和 OpenAI 兼容配置項(xiàng)少適合新手。你需要提前拿到三樣?xùn)|西Base URL、API Key、Model ID。這三件套是后面所有配置的核心缺一個(gè)都跑不起來。先注冊(cè)并登錄 TaoToken 控制臺(tái)地址是 https://taotoken.net/api 進(jìn)去后在 API Keys 頁面創(chuàng)建一個(gè)新 Key。創(chuàng)建時(shí)建議命名成openclaw-win方便以后區(qū)分。Key 只在創(chuàng)建時(shí)完整顯示一次復(fù)制后先存到記事本。模型 ID 根據(jù)你的需求選。如果只是做文件整理、表格生成這類輕量任務(wù)選一個(gè)響應(yīng)快的通用模型即可如果要處理長文檔匯總、復(fù)雜任務(wù)拆解選上下文窗口更大的模型。具體可選列表在控制臺(tái)的模型頁面能看到這里不編造具體型號(hào)你以控制臺(tái)實(shí)際展示為準(zhǔn)。Base URL 填https://taotoken.net/api注意結(jié)尾不要多加/v1具體以文檔說明為準(zhǔn)。接入文檔在 https://taotoken.net/api 的文檔入口可以找到里面有完整的參數(shù)說明和示例請(qǐng)求。如果你打算長期跑編碼類或 Agent 類任務(wù)可以了解下 Coding Plan它在 https://taotoken.net/api 的套餐頁面有說明。新手先不用急著買用按量計(jì)費(fèi)的 Key 跑通流程再說。拿到三件套后先別急著填進(jìn) OpenClaw。建議先用模型對(duì)話頁面驗(yàn)證一下 Key 是否可用地址是 https://taotoken.net/api 里的模型對(duì)話入口。發(fā)一句“你好回復(fù) ok”就行能正常返回說明 Key 和網(wǎng)絡(luò)都沒問題。這一步能幫你排除掉后面一半的報(bào)錯(cuò)。3. 可復(fù)制配置解壓目錄結(jié)構(gòu)與環(huán)境變量片段這一節(jié)是全文最核心的部分直接給你能復(fù)制粘貼的配置。先講解壓再講環(huán)境變量最后講 OpenClaw 里的模型配置片段。解壓這一步很多人用 Windows 自帶解壓工具結(jié)果解壓出來的文件缺斤少兩。原因是自帶工具對(duì)某些壓縮算法支持不完整尤其是整合包里帶二進(jìn)制組件的場景。推薦用 7-Zip 或 WinRAR。操作右鍵Openclaw-Windows-2.7.9.zip選擇“解壓到 Openclaw-Windows-2.7.9\”等待 1 到 2 分鐘。解壓完成后目錄結(jié)構(gòu)應(yīng)該是這樣的Openclaw-win/ ├── Openclaw Windows 一鍵啟動(dòng).exe ├── config/ │ ├── default.json │ └── model.example.json ├── runtime/ │ ├── node/ │ └── gateway/ ├── plugins/ │ └── browser-extension/ └── logs/ └── install.log如果你解壓后看不到runtime或plugins目錄說明解壓不完整刪掉重新解壓。校驗(yàn)方法右鍵解壓后的文件夾看屬性里的文件數(shù)量和大小正常應(yīng)該在 200MB 以上解壓后體積遠(yuǎn)大于壓縮包。接下來是環(huán)境變量。OpenClaw 啟動(dòng)時(shí)會(huì)讀取系統(tǒng)環(huán)境變量里的模型配置你也可以在它的配置界面里填但提前設(shè)好環(huán)境變量能避免一些讀取順序問題。在 Windows 搜索欄輸入“環(huán)境變量”打開“編輯系統(tǒng)環(huán)境變量”點(diǎn)“環(huán)境變量”在“用戶變量”里新建三條變量名變量值示例說明OPENCLAW_BASE_URLhttps://taotoken.net/api模型服務(wù)地址OPENCLAW_API_KEYsk-你的Key從控制臺(tái)復(fù)制OPENCLAW_MODEL_ID控制臺(tái)顯示的模型ID按需選擇注意變量值里不要帶引號(hào)不要有多余空格。設(shè)完后重啟一次命令行窗口讓變量生效。然后是 OpenClaw 自己的配置文件。進(jìn)入config/目錄把model.example.json復(fù)制一份改名為model.json用記事本打開填入{ provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的Key, model_id: 控制臺(tái)顯示的模型ID, timeout: 60, max_retries: 2 }保存時(shí)注意編碼選 UTF-8不要選 UTF-8 with BOM否則解析會(huì)報(bào)錯(cuò)。這個(gè)文件是 OpenClaw 啟動(dòng)時(shí)優(yōu)先讀取的環(huán)境變量作為兜底。如果你用的是 Claude Code 這類工具做輔助調(diào)試配置邏輯類似Base URL 和 Key 的填法一致Model ID 換成對(duì)應(yīng)模型即可。Claude Code 的接入文檔在 https://taotoken.net/api 的文檔區(qū)有專門章節(jié)。配置完成后先別啟動(dòng)主程序。打開命令行進(jìn)入Openclaw-win目錄執(zhí)行一次配置校驗(yàn)cd /d D:\OpenClaw\Openclaw-win runtime\node\node.exe -e const crequire(./config/model.json);console.log(base_url:,c.base_url);console.log(model_id:,c.model_id);console.log(key_len:,c.api_key.length)如果輸出里 base_url 和 model_id 正確key_len 大于 20說明配置讀取沒問題。這一步能提前發(fā)現(xiàn) JSON 格式錯(cuò)誤和路徑問題。4. 驗(yàn)證請(qǐng)求與成功結(jié)果Gateway 在線才算裝完配置校驗(yàn)通過后雙擊Openclaw Windows 一鍵啟動(dòng).exe。如果彈出 SmartScreen 提示點(diǎn)“更多信息”再點(diǎn)“仍要運(yùn)行”。這是 Windows 對(duì)未簽名程序的常規(guī)攔截不是病毒。進(jìn)入歡迎界面后點(diǎn)“開始使用”設(shè)置安裝路徑。路徑必須是純英文不能有中文、空格、特殊符號(hào)。推薦D:\OpenClaw不要裝 C 盤。確認(rèn)后勾選協(xié)議點(diǎn)“開始安裝”。全自動(dòng)部署大概 3 到 5 分鐘期間不要關(guān)窗口。安裝完成后程序自動(dòng)啟動(dòng)主界面。第一次啟動(dòng)時(shí) Gateway 服務(wù)要初始化頁面會(huì)顯示加載狀態(tài)等 1 到 3 分鐘。判斷裝成功的唯一標(biāo)準(zhǔn)主界面右上角顯示“Gateway 在線”。Gateway 在線后做一次真實(shí)請(qǐng)求驗(yàn)證。在底部輸入框輸入列出我桌面上的所有文件按類型分組告訴我正常情況小龍蝦會(huì)調(diào)用文件系統(tǒng)接口返回桌面文件列表并分組。如果它回復(fù)“無法連接模型”或“請(qǐng)求超時(shí)”說明模型配置沒生效回到第 3 節(jié)檢查model.json和環(huán)境變量。再驗(yàn)證一次模型通道是否真的走通了。打開命令行直接用 curl 測(cè) TaoToken 接口curl -X POST https://taotoken.net/api/v1/chat/completions ^ -H Content-Type: application/json ^ -H Authorization: Bearer sk-你的Key ^ -d {\model\:\控制臺(tái)顯示的模型ID\,\messages\:[{\role\:\user\,\content\:\回復(fù)ok\}]}如果返回 JSON 里有choices字段和正常內(nèi)容說明 Key、Base URL、Model ID 三件套完全正確。如果返回 401是 Key 問題返回 404是 Base URL 或 Model ID 問題返回超時(shí)是網(wǎng)絡(luò)問題。實(shí)測(cè)下來Gateway 在線加上 curl 返回正常這兩個(gè)都過了OpenClaw 小龍蝦就算真正部署完成。后續(xù)再啟動(dòng)加載速度會(huì)明顯變快因?yàn)槌跏蓟彺嬉呀?jīng)建好了。5. 本篇常見錯(cuò)排查401、local proxy failed、reading choices、OAuth這一節(jié)按真實(shí)報(bào)錯(cuò)對(duì)照排查。你遇到問題先在這里找對(duì)應(yīng)條目。報(bào)錯(cuò)一401 Unauthorized現(xiàn)象小龍蝦回復(fù)“模型認(rèn)證失敗”或 curl 返回{error:{message:Invalid API key}}。原因API Key 填錯(cuò)、過期、或者復(fù)制時(shí)帶了空格。也有可能是環(huán)境變量和model.json里的 Key 不一致程序讀了舊的那個(gè)。修復(fù)打開config/model.json確認(rèn)api_key字段是完整的sk-開頭字符串前后無空格。再檢查系統(tǒng)環(huán)境變量OPENCLAW_API_KEY是否一致。改完后重啟 OpenClaw。如果還報(bào) 401去 TaoToken 控制臺(tái)重新生成一個(gè) Key舊的可能被刪了。報(bào)錯(cuò)二local proxy failed / 本地代理失敗現(xiàn)象啟動(dòng)時(shí)彈窗提示local proxy failed to start或 Gateway 一直離線。原因端口被占用或者安全軟件攔截了本地回環(huán)通信。OpenClaw 的 Gateway 默認(rèn)監(jiān)聽本地某個(gè)端口如果這個(gè)端口被其他程序占了就起不來。修復(fù)先完全退出安全軟件包括后臺(tái)進(jìn)程。然后打開命令行執(zhí)行netstat -ano | findstr :端口號(hào)看端口是否被占用。如果被占用在config/default.json里改一個(gè)不沖突的端口比如把gateway_port從默認(rèn)值改成18888。改完重啟。如果還不行檢查 Windows 防火墻有沒有攔截Openclaw Windows 一鍵啟動(dòng).exe在防火墻里給它放行。報(bào)錯(cuò)三reading choices 相關(guān)報(bào)錯(cuò)現(xiàn)象小龍蝦執(zhí)行任務(wù)時(shí)提示cannot read property choices of undefined或類似讀取 choices 失敗。原因模型接口返回格式不符合預(yù)期。常見于 Base URL 填錯(cuò)比如多加了/v1導(dǎo)致路徑變成/v1/v1/chat/completions或者 Model ID 填了一個(gè)不存在的模型接口返回錯(cuò)誤結(jié)構(gòu)。修復(fù)確認(rèn)base_url是https://taotoken.net/api不要自己加/v1。確認(rèn)model_id和控制臺(tái)展示的完全一致大小寫敏感。用第 4 節(jié)的 curl 命令直接測(cè)看返回結(jié)構(gòu)里有沒有choices。如果 curl 正常但 OpenClaw 報(bào)錯(cuò)檢查model.json的編碼是不是 UTF-8 無 BOM。報(bào)錯(cuò)四OAuth 相關(guān)提示現(xiàn)象啟動(dòng)時(shí)提示需要 OAuth 授權(quán)或跳轉(zhuǎn)登錄頁面。原因某些模型服務(wù)需要 OAuth 流程但 OpenClaw 默認(rèn)走的是 API Key 模式。如果你在配置里誤選了 OAuth 類型的 provider就會(huì)觸發(fā)這個(gè)。修復(fù)打開config/model.json確認(rèn)provider字段是openai-compatible不是oauth或其他。如果你確實(shí)需要用 OAuth 類服務(wù)參考 TaoToken 文檔里的對(duì)應(yīng)接入方式但新手建議先用 API Key 模式跑通。報(bào)錯(cuò)五文件被安全軟件刪除現(xiàn)象解壓后runtime目錄里的文件消失或啟動(dòng)時(shí)提示缺少node.exe。原因安全軟件把二進(jìn)制組件當(dāng)風(fēng)險(xiǎn)文件隔離了。修復(fù)打開安全軟件的隔離區(qū)把相關(guān)文件恢復(fù)并加入信任列表。然后重新解壓安裝包再啟動(dòng)。建議安裝階段直接退出安全軟件裝完再把 OpenClaw 目錄加入白名單。報(bào)錯(cuò)六路徑異常無法安裝現(xiàn)象點(diǎn)“開始安裝”后提示路徑非法。原因路徑含中文、空格、特殊符號(hào)。修復(fù)改成純英文路徑比如D:\OpenClaw。不要用D:\工具\(yùn)OpenClaw或D:\My Tools\OpenClaw。改完重新安裝。6. 語義一致 CTA裝完之后怎么繼續(xù)用裝完只是開始。OpenClaw 小龍蝦的價(jià)值在于你給它下什么指令。新手可以從這幾類任務(wù)練手整理下載目錄的圖片按日期歸檔、把桌面 Word 文檔匯總成統(tǒng)計(jì)表、打開瀏覽器抓取指定信息生成 Excel。指令越具體執(zhí)行越準(zhǔn)。如果你在配置模型通道時(shí)遇到問題優(yōu)先看接入文檔地址是 https://taotoken.net/api 的文檔入口里面有 Base URL、Key、Model ID 的完整說明和示例。想先驗(yàn)證模型能不能用去模型對(duì)話頁面發(fā)一句話測(cè)試地址在 https://taotoken.net/api 的對(duì)話入口。長期跑編碼或 Agent 任務(wù)的話Coding Plan 在 https://taotoken.net/api 的套餐頁有詳細(xì)說明。最后提醒一個(gè)實(shí)操細(xì)節(jié)OpenClaw 的 Gateway 服務(wù)在首次啟動(dòng)后會(huì)有緩存如果你改了model.json或環(huán)境變量一定要完全退出程序再重啟不要只關(guān)窗口。后臺(tái)進(jìn)程還在的話讀的還是舊配置。這個(gè)坑我踩過排查了半天才發(fā)現(xiàn)是進(jìn)程沒退干凈。任務(wù)管理器里結(jié)束所有Openclaw相關(guān)進(jìn)程再啟動(dòng)配置才會(huì)生效。 新手部署指南：OpenClaw 小龍蝦 Windows 解壓安裝排雷技巧（含安裝包）
1. 為什么 Windows 解壓安裝 OpenClaw 小龍蝦總在第一步翻車OpenClaw 小龍蝦是一款可以在本機(jī)運(yùn)行的桌面 AI 智能體能聽懂自然語言指令自動(dòng)完成文件整理、表格生成、網(wǎng)頁信息抓取、消息發(fā)送這類操作。它適合不想寫代碼、又想體驗(yàn)本地自動(dòng)化辦公的 Windows 用戶。但很多人卡在第一步下載完安裝包解壓、雙擊、安裝然后報(bào)錯(cuò)。不是路徑不對(duì)就是文件被安全軟件刪了或者 Gateway 一直離線。我實(shí)測(cè)下來Windows 環(huán)境下 OpenClaw 小龍蝦解壓安裝的失敗原因高度集中基本跑不出這幾類解壓工具不兼容導(dǎo)致文件損壞、安裝路徑含中文或空格、安全軟件攔截核心進(jìn)程、首次啟動(dòng) Gateway 初始化超時(shí)。這篇就按真實(shí)操作順序把每一步的可復(fù)制配置和排雷動(dòng)作寫清楚讓你一次裝完。先明確一個(gè)前提OpenClaw 小龍蝦是本地運(yùn)行的智能體它需要調(diào)用鍵鼠模擬、文件讀寫、系統(tǒng)權(quán)限這些能力所以安全軟件誤報(bào)是常態(tài)不是程序有問題。你要做的是在安裝階段臨時(shí)放行裝完再按需恢復(fù)防護(hù)。安裝包方面Windows 整合包當(dāng)前版本是 v2.7.9文件約 45.8MB解壓后目錄名為Openclaw-win。整個(gè)流程分四段下載校驗(yàn)、解壓、啟動(dòng)安裝、驗(yàn)證 Gateway 在線。下面逐段拆。2. TaoToken 前置準(zhǔn)備給小龍蝦接上模型能力OpenClaw 小龍蝦本身是執(zhí)行框架它要真正“聽懂”指令并拆解任務(wù)背后需要一個(gè)大模型來提供推理能力。你可以把它理解成小龍蝦是手和腳模型是大腦。默認(rèn)整合包里可能內(nèi)置了基礎(chǔ)額度但如果你想長期用、或者想換成更穩(wěn)定的模型通道就需要配置一個(gè)兼容 OpenAI 接口的模型服務(wù)。這里我用 TaoToken 來做模型接入原因是它的接口格式和 OpenAI 兼容配置項(xiàng)少適合新手。你需要提前拿到三樣?xùn)|西Base URL、API Key、Model ID。這三件套是后面所有配置的核心缺一個(gè)都跑不起來。先注冊(cè)并登錄 TaoToken 控制臺(tái)地址是 https://taotoken.net/api 進(jìn)去后在 API Keys 頁面創(chuàng)建一個(gè)新 Key。創(chuàng)建時(shí)建議命名成openclaw-win方便以后區(qū)分。Key 只在創(chuàng)建時(shí)完整顯示一次復(fù)制后先存到記事本。模型 ID 根據(jù)你的需求選。如果只是做文件整理、表格生成這類輕量任務(wù)選一個(gè)響應(yīng)快的通用模型即可如果要處理長文檔匯總、復(fù)雜任務(wù)拆解選上下文窗口更大的模型。具體可選列表在控制臺(tái)的模型頁面能看到這里不編造具體型號(hào)你以控制臺(tái)實(shí)際展示為準(zhǔn)。Base URL 填https://taotoken.net/api注意結(jié)尾不要多加/v1具體以文檔說明為準(zhǔn)。接入文檔在 https://taotoken.net/api 的文檔入口可以找到里面有完整的參數(shù)說明和示例請(qǐng)求。如果你打算長期跑編碼類或 Agent 類任務(wù)可以了解下 Coding Plan它在 https://taotoken.net/api 的套餐頁面有說明。新手先不用急著買用按量計(jì)費(fèi)的 Key 跑通流程再說。拿到三件套后先別急著填進(jìn) OpenClaw。建議先用模型對(duì)話頁面驗(yàn)證一下 Key 是否可用地址是 https://taotoken.net/api 里的模型對(duì)話入口。發(fā)一句“你好回復(fù) ok”就行能正常返回說明 Key 和網(wǎng)絡(luò)都沒問題。這一步能幫你排除掉后面一半的報(bào)錯(cuò)。3. 可復(fù)制配置解壓目錄結(jié)構(gòu)與環(huán)境變量片段這一節(jié)是全文最核心的部分直接給你能復(fù)制粘貼的配置。先講解壓再講環(huán)境變量最后講 OpenClaw 里的模型配置片段。解壓這一步很多人用 Windows 自帶解壓工具結(jié)果解壓出來的文件缺斤少兩。原因是自帶工具對(duì)某些壓縮算法支持不完整尤其是整合包里帶二進(jìn)制組件的場景。推薦用 7-Zip 或 WinRAR。操作右鍵Openclaw-Windows-2.7.9.zip選擇“解壓到 Openclaw-Windows-2.7.9\”等待 1 到 2 分鐘。解壓完成后目錄結(jié)構(gòu)應(yīng)該是這樣的Openclaw-win/ ├── Openclaw Windows 一鍵啟動(dòng).exe ├── config/ │ ├── default.json │ └── model.example.json ├── runtime/ │ ├── node/ │ └── gateway/ ├── plugins/ │ └── browser-extension/ └── logs/ └── install.log如果你解壓后看不到runtime或plugins目錄說明解壓不完整刪掉重新解壓。校驗(yàn)方法右鍵解壓后的文件夾看屬性里的文件數(shù)量和大小正常應(yīng)該在 200MB 以上解壓后體積遠(yuǎn)大于壓縮包。接下來是環(huán)境變量。OpenClaw 啟動(dòng)時(shí)會(huì)讀取系統(tǒng)環(huán)境變量里的模型配置你也可以在它的配置界面里填但提前設(shè)好環(huán)境變量能避免一些讀取順序問題。在 Windows 搜索欄輸入“環(huán)境變量”打開“編輯系統(tǒng)環(huán)境變量”點(diǎn)“環(huán)境變量”在“用戶變量”里新建三條變量名變量值示例說明OPENCLAW_BASE_URLhttps://taotoken.net/api模型服務(wù)地址OPENCLAW_API_KEYsk-你的Key從控制臺(tái)復(fù)制OPENCLAW_MODEL_ID控制臺(tái)顯示的模型ID按需選擇注意變量值里不要帶引號(hào)不要有多余空格。設(shè)完后重啟一次命令行窗口讓變量生效。然后是 OpenClaw 自己的配置文件。進(jìn)入config/目錄把model.example.json復(fù)制一份改名為model.json用記事本打開填入{ provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的Key, model_id: 控制臺(tái)顯示的模型ID, timeout: 60, max_retries: 2 }保存時(shí)注意編碼選 UTF-8不要選 UTF-8 with BOM否則解析會(huì)報(bào)錯(cuò)。這個(gè)文件是 OpenClaw 啟動(dòng)時(shí)優(yōu)先讀取的環(huán)境變量作為兜底。如果你用的是 Claude Code 這類工具做輔助調(diào)試配置邏輯類似Base URL 和 Key 的填法一致Model ID 換成對(duì)應(yīng)模型即可。Claude Code 的接入文檔在 https://taotoken.net/api 的文檔區(qū)有專門章節(jié)。配置完成后先別啟動(dòng)主程序。打開命令行進(jìn)入Openclaw-win目錄執(zhí)行一次配置校驗(yàn)cd /d D:\OpenClaw\Openclaw-win runtime\node\node.exe -e const crequire(./config/model.json);console.log(base_url:,c.base_url);console.log(model_id:,c.model_id);console.log(key_len:,c.api_key.length)如果輸出里 base_url 和 model_id 正確key_len 大于 20說明配置讀取沒問題。這一步能提前發(fā)現(xiàn) JSON 格式錯(cuò)誤和路徑問題。4. 驗(yàn)證請(qǐng)求與成功結(jié)果Gateway 在線才算裝完配置校驗(yàn)通過后雙擊Openclaw Windows 一鍵啟動(dòng).exe。如果彈出 SmartScreen 提示點(diǎn)“更多信息”再點(diǎn)“仍要運(yùn)行”。這是 Windows 對(duì)未簽名程序的常規(guī)攔截不是病毒。進(jìn)入歡迎界面后點(diǎn)“開始使用”設(shè)置安裝路徑。路徑必須是純英文不能有中文、空格、特殊符號(hào)。推薦D:\OpenClaw不要裝 C 盤。確認(rèn)后勾選協(xié)議點(diǎn)“開始安裝”。全自動(dòng)部署大概 3 到 5 分鐘期間不要關(guān)窗口。安裝完成后程序自動(dòng)啟動(dòng)主界面。第一次啟動(dòng)時(shí) Gateway 服務(wù)要初始化頁面會(huì)顯示加載狀態(tài)等 1 到 3 分鐘。判斷裝成功的唯一標(biāo)準(zhǔn)主界面右上角顯示“Gateway 在線”。Gateway 在線后做一次真實(shí)請(qǐng)求驗(yàn)證。在底部輸入框輸入列出我桌面上的所有文件按類型分組告訴我正常情況小龍蝦會(huì)調(diào)用文件系統(tǒng)接口返回桌面文件列表并分組。如果它回復(fù)“無法連接模型”或“請(qǐng)求超時(shí)”說明模型配置沒生效回到第 3 節(jié)檢查model.json和環(huán)境變量。再驗(yàn)證一次模型通道是否真的走通了。打開命令行直接用 curl 測(cè) TaoToken 接口curl -X POST https://taotoken.net/api/v1/chat/completions ^ -H Content-Type: application/json ^ -H Authorization: Bearer sk-你的Key ^ -d {\model\:\控制臺(tái)顯示的模型ID\,\messages\:[{\role\:\user\,\content\:\回復(fù)ok\}]}如果返回 JSON 里有choices字段和正常內(nèi)容說明 Key、Base URL、Model ID 三件套完全正確。如果返回 401是 Key 問題返回 404是 Base URL 或 Model ID 問題返回超時(shí)是網(wǎng)絡(luò)問題。實(shí)測(cè)下來Gateway 在線加上 curl 返回正常這兩個(gè)都過了OpenClaw 小龍蝦就算真正部署完成。后續(xù)再啟動(dòng)加載速度會(huì)明顯變快因?yàn)槌跏蓟彺嬉呀?jīng)建好了。5. 本篇常見錯(cuò)排查401、local proxy failed、reading choices、OAuth這一節(jié)按真實(shí)報(bào)錯(cuò)對(duì)照排查。你遇到問題先在這里找對(duì)應(yīng)條目。報(bào)錯(cuò)一401 Unauthorized現(xiàn)象小龍蝦回復(fù)“模型認(rèn)證失敗”或 curl 返回{error:{message:Invalid API key}}。原因API Key 填錯(cuò)、過期、或者復(fù)制時(shí)帶了空格。也有可能是環(huán)境變量和model.json里的 Key 不一致程序讀了舊的那個(gè)。修復(fù)打開config/model.json確認(rèn)api_key字段是完整的sk-開頭字符串前后無空格。再檢查系統(tǒng)環(huán)境變量OPENCLAW_API_KEY是否一致。改完后重啟 OpenClaw。如果還報(bào) 401去 TaoToken 控制臺(tái)重新生成一個(gè) Key舊的可能被刪了。報(bào)錯(cuò)二local proxy failed / 本地代理失敗現(xiàn)象啟動(dòng)時(shí)彈窗提示local proxy failed to start或 Gateway 一直離線。原因端口被占用或者安全軟件攔截了本地回環(huán)通信。OpenClaw 的 Gateway 默認(rèn)監(jiān)聽本地某個(gè)端口如果這個(gè)端口被其他程序占了就起不來。修復(fù)先完全退出安全軟件包括后臺(tái)進(jìn)程。然后打開命令行執(zhí)行netstat -ano | findstr :端口號(hào)看端口是否被占用。如果被占用在config/default.json里改一個(gè)不沖突的端口比如把gateway_port從默認(rèn)值改成18888。改完重啟。如果還不行檢查 Windows 防火墻有沒有攔截Openclaw Windows 一鍵啟動(dòng).exe在防火墻里給它放行。報(bào)錯(cuò)三reading choices 相關(guān)報(bào)錯(cuò)現(xiàn)象小龍蝦執(zhí)行任務(wù)時(shí)提示cannot read property choices of undefined或類似讀取 choices 失敗。原因模型接口返回格式不符合預(yù)期。常見于 Base URL 填錯(cuò)比如多加了/v1導(dǎo)致路徑變成/v1/v1/chat/completions或者 Model ID 填了一個(gè)不存在的模型接口返回錯(cuò)誤結(jié)構(gòu)。修復(fù)確認(rèn)base_url是https://taotoken.net/api不要自己加/v1。確認(rèn)model_id和控制臺(tái)展示的完全一致大小寫敏感。用第 4 節(jié)的 curl 命令直接測(cè)看返回結(jié)構(gòu)里有沒有choices。如果 curl 正常但 OpenClaw 報(bào)錯(cuò)檢查model.json的編碼是不是 UTF-8 無 BOM。報(bào)錯(cuò)四OAuth 相關(guān)提示現(xiàn)象啟動(dòng)時(shí)提示需要 OAuth 授權(quán)或跳轉(zhuǎn)登錄頁面。原因某些模型服務(wù)需要 OAuth 流程但 OpenClaw 默認(rèn)走的是 API Key 模式。如果你在配置里誤選了 OAuth 類型的 provider就會(huì)觸發(fā)這個(gè)。修復(fù)打開config/model.json確認(rèn)provider字段是openai-compatible不是oauth或其他。如果你確實(shí)需要用 OAuth 類服務(wù)參考 TaoToken 文檔里的對(duì)應(yīng)接入方式但新手建議先用 API Key 模式跑通。報(bào)錯(cuò)五文件被安全軟件刪除現(xiàn)象解壓后runtime目錄里的文件消失或啟動(dòng)時(shí)提示缺少node.exe。原因安全軟件把二進(jìn)制組件當(dāng)風(fēng)險(xiǎn)文件隔離了。修復(fù)打開安全軟件的隔離區(qū)把相關(guān)文件恢復(fù)并加入信任列表。然后重新解壓安裝包再啟動(dòng)。建議安裝階段直接退出安全軟件裝完再把 OpenClaw 目錄加入白名單。報(bào)錯(cuò)六路徑異常無法安裝現(xiàn)象點(diǎn)“開始安裝”后提示路徑非法。原因路徑含中文、空格、特殊符號(hào)。修復(fù)改成純英文路徑比如D:\OpenClaw。不要用D:\工具\(yùn)OpenClaw或D:\My Tools\OpenClaw。改完重新安裝。6. 語義一致 CTA裝完之后怎么繼續(xù)用裝完只是開始。OpenClaw 小龍蝦的價(jià)值在于你給它下什么指令。新手可以從這幾類任務(wù)練手整理下載目錄的圖片按日期歸檔、把桌面 Word 文檔匯總成統(tǒng)計(jì)表、打開瀏覽器抓取指定信息生成 Excel。指令越具體執(zhí)行越準(zhǔn)。如果你在配置模型通道時(shí)遇到問題優(yōu)先看接入文檔地址是 https://taotoken.net/api 的文檔入口里面有 Base URL、Key、Model ID 的完整說明和示例。想先驗(yàn)證模型能不能用去模型對(duì)話頁面發(fā)一句話測(cè)試地址在 https://taotoken.net/api 的對(duì)話入口。長期跑編碼或 Agent 任務(wù)的話Coding Plan 在 https://taotoken.net/api 的套餐頁有詳細(xì)說明。最后提醒一個(gè)實(shí)操細(xì)節(jié)OpenClaw 的 Gateway 服務(wù)在首次啟動(dòng)后會(huì)有緩存如果你改了model.json或環(huán)境變量一定要完全退出程序再重啟不要只關(guān)窗口。后臺(tái)進(jìn)程還在的話讀的還是舊配置。這個(gè)坑我踩過排查了半天才發(fā)現(xiàn)是進(jìn)程沒退干凈。任務(wù)管理器里結(jié)束所有Openclaw相關(guān)進(jìn)程再啟動(dòng)配置才會(huì)生效。