用實(shí)戰(zhàn)：從 Node.js 到 ClawHub 每一步都有截圖加詳細(xì)說(shuō)明，TaoToken 統(tǒng)一 Key 讓打工人也有下屬)
1. 為什么打工人需要一個(gè)本地 AI 助手OpenClaw 能幫你做什么如果你每天的工作里有一半時(shí)間在重復(fù)「下載文件夾又亂了」「周報(bào)數(shù)據(jù)要從三個(gè) Excel 里拼」「會(huì)議紀(jì)要要手動(dòng)整理」這類(lèi)事那 OpenClaw 值得你花十分鐘裝一次。它是一個(gè)開(kāi)源的本地智能體框架跑在你自己電腦上能調(diào)用大模型理解你的自然語(yǔ)言指令然后真的去操作文件、執(zhí)行腳本、拉取數(shù)據(jù)。和網(wǎng)頁(yè)版聊天機(jī)器人最大的區(qū)別是它不只是「說(shuō)」而是「做」。我第一次接觸 OpenClaw 是因?yàn)橐粋€(gè)很具體的痛點(diǎn)——每周要從十幾個(gè) CSV 里匯總銷(xiāo)售數(shù)據(jù)手動(dòng)復(fù)制粘貼要花四十分鐘。裝好 OpenClaw 之后一句「把 D 盤(pán)報(bào)表文件夾里本周的 CSV 合并成一張表按日期排序」就能搞定。它背后靠的是技能Skill機(jī)制類(lèi)似手機(jī)裝 App裝什么技能就能干什么活。這篇文章面向 Windows 用戶(hù)從零開(kāi)始走完整條鏈路裝 Node.js、配 PowerShell、拉 OpenClaw、裝 ClawHub 技能、接入模型、跑通第一個(gè)任務(wù)。每一步都有可復(fù)制的命令和驗(yàn)證動(dòng)作。模型接入這塊我用 TaoToken 的統(tǒng)一 Key 來(lái)做一個(gè) Key 走通多個(gè)模型省得在好幾個(gè)平臺(tái)之間來(lái)回切換配置。適合誰(shuí)看會(huì)用 PowerShell 復(fù)制粘貼命令、但沒(méi)寫(xiě)過(guò)復(fù)雜腳本的辦公族想給團(tuán)隊(duì)搭一個(gè)本地自動(dòng)化助手的運(yùn)維同學(xué)以及被各種 AI 工具注冊(cè)流程折騰煩了、想找個(gè)統(tǒng)一入口的開(kāi)發(fā)者。不需要你會(huì)寫(xiě)代碼但需要你愿意跟著敲命令。裝之前先確認(rèn)三件事系統(tǒng)是 Windows 10 21H2 以上或 Windows 1164 位內(nèi)存至少 8GB跑本地模型建議 16GB磁盤(pán)留 5GB 以上空間。另外安裝路徑和你的 Windows 用戶(hù)名都不要用中文這是后面技能加載失敗最常見(jiàn)的原因我踩過(guò)這個(gè)坑排查了半小時(shí)才發(fā)現(xiàn)是用戶(hù)名帶中文導(dǎo)致的。2. 前置準(zhǔn)備N(xiāo)ode.js、npm 與 PowerShell 環(huán)境一次配好OpenClaw 的核心依賴(lài)是 Node.js而且版本要求比較嚴(yán)必須 22.0.0 以上的 LTS 版本。低于這個(gè)版本會(huì)在啟動(dòng)時(shí)報(bào)語(yǔ)法錯(cuò)誤很多人卡在這一步以為是安裝腳本壞了其實(shí)是 Node 版本太舊。所以這一章我們先把地基打好。2.1 用 winget 裝 Node.js 22 LTSWindows 10/11 自帶 winget 包管理器這是最省事的方式。打開(kāi)管理員 PowerShell按 Win X選「終端(管理員)」執(zhí)行winget install OpenJS.NodeJS.LTS --version 22.12.0如果你不確定 winget 里有哪些版本可以先搜一下winget search OpenJS.NodeJS裝完之后必須重開(kāi)一個(gè) PowerShell 窗口因?yàn)榄h(huán)境變量需要重新加載。然后驗(yàn)證node --version npm --version正常輸出應(yīng)該是v22.12.0和類(lèi)似10.9.0的 npm 版本號(hào)。如果node命令提示「不是內(nèi)部或外部命令」說(shuō)明 PATH 沒(méi)生效重開(kāi)終端或者重啟電腦即可。2.2 切換 npm 國(guó)內(nèi)鏡像默認(rèn) npm 源在國(guó)內(nèi)下載會(huì)很慢甚至超時(shí)。切換成 npmmirror 鏡像npm config set registry https://registry.npmmirror.com npm config get registry第二條命令應(yīng)該返回https://registry.npmmirror.com/確認(rèn)切換成功。這一步能讓你后面裝 ClawHub 和技能包的速度從「等到懷疑人生」變成「幾秒鐘搞定」。2.3 配置 PowerShell 執(zhí)行策略O(shè)penClaw 的安裝腳本是遠(yuǎn)程腳本PowerShell 默認(rèn)會(huì)攔截。需要把當(dāng)前用戶(hù)的執(zhí)行策略設(shè)為 RemoteSignedSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser按 Y 確認(rèn)。這個(gè)設(shè)置只影響當(dāng)前用戶(hù)不會(huì)降低系統(tǒng)整體安全性是運(yùn)行本地腳本的標(biāo)準(zhǔn)操作。2.4 環(huán)境自檢清單在正式裝 OpenClaw 之前跑一遍這個(gè)自檢把問(wèn)題提前暴露Write-Host Node 版本: (node --version) Write-Host npm 版本: (npm --version) Write-Host npm 源: (npm config get registry) Write-Host 執(zhí)行策略: (Get-ExecutionPolicy -Scope CurrentUser) Write-Host 當(dāng)前用戶(hù): $env:USERNAME重點(diǎn)看兩處執(zhí)行策略必須是RemoteSigned或Unrestricted當(dāng)前用戶(hù)名不能含中文。如果用戶(hù)名是中文建議新建一個(gè)英文名的本地賬戶(hù)來(lái)跑 OpenClaw或者把工作目錄放到C:\openclaw-workspace這類(lèi)純英文路徑下。注意不要用系統(tǒng)自帶的 Node.js 舊版本直接升級(jí)容易殘留舊文件導(dǎo)致版本沖突。如果之前裝過(guò) Node先用winget uninstall OpenJS.NodeJS卸干凈再裝。3. 安裝 OpenClaw 并接入 TaoToken 統(tǒng)一 Key環(huán)境就緒后進(jìn)入正題。這一章分兩部分先把 OpenClaw 本體裝上再配置模型通道。模型這塊用 TaoToken 的統(tǒng)一 Key一個(gè) Key 就能調(diào)用多個(gè)模型配置一次到處能用。3.1 一鍵安裝 OpenClaw在管理員 PowerShell 里執(zhí)行官方安裝腳本iwr -useb https://openclaw.ai/install.ps1 | iex腳本會(huì)自動(dòng)檢測(cè) Node.js、下載 OpenClaw 核心程序、配置環(huán)境變量全程 3 到 8 分鐘取決于網(wǎng)速。中途不要關(guān)終端?？吹絆penClaw installed successfully就成功了。驗(yàn)證openclaw --version輸出類(lèi)似openclaw v2026.3.8即安裝成功。如果你已經(jīng)有 Node.js 22 環(huán)境也可以走 npm 手動(dòng)安裝更可控npm install -g openclawlatest openclaw --version3.2 獲取 TaoToken API Key打開(kāi) TaoToken 控制臺(tái)創(chuàng)建 API Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_install登錄后在「API Keys」頁(yè)面點(diǎn)創(chuàng)建復(fù)制生成的 Key形如sk-xxxxxxxx。這個(gè) Key 就是你的統(tǒng)一憑證后面所有模型調(diào)用都用它。建議先存到記事本下一步要粘貼。3.3 配置 OpenClaw 的模型通道OpenClaw 的配置文件在~/.openclaw目錄下Windows 上對(duì)應(yīng)C:\Users\你的用戶(hù)名\.openclaw。我們通過(guò)初始化向?qū)?lái)配置比手改文件更穩(wěn)。執(zhí)行openclaw onboard向?qū)?huì)依次問(wèn)你幾個(gè)問(wèn)題。走到模型配置這一步時(shí)選擇自定義 OpenAI 兼容通道Custom / OpenAI-Compatible然后填入以下三件套配置項(xiàng)填寫(xiě)內(nèi)容Base URLhttps://taotoken.net/apiAPI Key你剛才復(fù)制的sk-xxxxxxxxModel ID例如claude-sonnet-4-5或gpt-4o按需選Base URL 這里注意不要帶末尾斜杠也不要加 UTM 參數(shù)就是干凈的https://taotoken.net/api。Model ID 填你在 TaoToken 控制臺(tái)里能看到的具體模型名。如果你更習(xí)慣直接改配置文件OpenClaw 的模型配置存在~/.openclaw/config.json對(duì)應(yīng)的片段長(zhǎng)這樣{ models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: claude-sonnet-4-5 } }, gateway: { port: 18789, bind: 127.0.0.1 } }改完保存重啟網(wǎng)關(guān)生效。用 JSON 配置的好處是以后換模型只改model字段不用重跑向?qū)А?.4 啟動(dòng)網(wǎng)關(guān)服務(wù)配置完成后啟動(dòng) OpenClaw 網(wǎng)關(guān)openclaw gateway start看到Gateway started successfully后瀏覽器訪問(wèn)http://localhost:18789能打開(kāi)中文控制面板就說(shuō)明整條鏈路通了。面板里能看到 AI 對(duì)話、技能管理、定時(shí)任務(wù)幾個(gè)模塊。提示如果 18789 端口被占用執(zhí)行openclaw config set gateway.port 18790換端口然后重啟網(wǎng)關(guān)。4. 用 ClawHub 拉取技能并跑通第一個(gè)自動(dòng)化任務(wù)OpenClaw 本體只是個(gè)框架真正干活的是技能。ClawHub 是官方的技能管理工具類(lèi)似 npm 之于 Node.js。這一章我們裝 ClawHub、拉幾個(gè)高頻技能然后跑一個(gè)真實(shí)任務(wù)驗(yàn)證。4.1 安裝 ClawHub CLInpm install -g clawhublatest --registry https://registry.npmmirror.com clawhub --version能輸出版本號(hào)就裝好了。4.2 安裝高頻技能先裝一個(gè)安全守門(mén)人它會(huì)掃描其他技能的隱私風(fēng)險(xiǎn)必裝clawhub install skill-vetter然后按需裝幾個(gè)覆蓋日常場(chǎng)景的clawhub install office-automation clawhub install file-organizer clawhub install tavily-search clawhub install remind-meoffice-automation處理 Excel/Word/PPT 批量操作file-organizer自動(dòng)整理文件夾tavily-search做實(shí)時(shí)聯(lián)網(wǎng)搜索remind-me管會(huì)議和打卡提醒。裝完用clawhub list確認(rèn)clawhub list應(yīng)該能看到已安裝技能列表。裝完技能后重啟網(wǎng)關(guān)讓它們生效openclaw gateway restart4.3 跑通第一個(gè)任務(wù)整理下載文件夾打開(kāi)http://localhost:18789進(jìn)入對(duì)話界面輸入幫我整理 C:\Users\你的用戶(hù)名\Downloads 文件夾按文件類(lèi)型文檔、圖片、視頻、安裝包分類(lèi)歸檔刪除重復(fù)文件保留最新版本OpenClaw 會(huì)先展示一個(gè)執(zhí)行計(jì)劃列出它打算怎么分類(lèi)、移動(dòng)哪些文件。你確認(rèn)后它調(diào)用file-organizer技能執(zhí)行。執(zhí)行完打開(kāi)下載文件夾能看到文件已經(jīng)按類(lèi)型分好重復(fù)文件被清理。這一步的關(guān)鍵是先看計(jì)劃再確認(rèn)。OpenClaw 默認(rèn)不會(huì)直接動(dòng)手會(huì)等你點(diǎn)頭這是它的安全設(shè)計(jì)。如果你發(fā)現(xiàn)計(jì)劃里有不想動(dòng)的文件可以在確認(rèn)前補(bǔ)充指令比如「不要?jiǎng)?.zip 文件」。4.4 驗(yàn)證模型通道是否真的走通想確認(rèn)請(qǐng)求確實(shí)走了 TaoToken 通道可以在對(duì)話里問(wèn)一個(gè)需要模型推理的問(wèn)題比如「把下面這段會(huì)議記錄總結(jié)成三條待辦」。如果模型正常返回結(jié)構(gòu)化結(jié)果說(shuō)明 Base URL、Key、Model ID 三件套都配對(duì)了。如果返回報(bào)錯(cuò)看下一章的排查。5. 常見(jiàn)報(bào)錯(cuò)排查401、端口占用與技能加載失敗裝的過(guò)程中大概率會(huì)碰到幾個(gè)典型報(bào)錯(cuò)這一章按真實(shí)錯(cuò)誤信息來(lái)對(duì)照排查。5.1 401 Unauthorized現(xiàn)象對(duì)話時(shí)提示401 Unauthorized或invalid api key。原因基本是 Key 沒(méi)配對(duì)。檢查三處Key 是否復(fù)制完整有沒(méi)有漏掉sk-前綴后面的字符Base URL 是否寫(xiě)成了https://taotoken.net/api不要帶/v1后綴也不要帶 UTM 參數(shù)配置文件里apiKey字段有沒(méi)有多余空格。改完重啟網(wǎng)關(guān)。5.2 local proxy failed / connection refused現(xiàn)象啟動(dòng)時(shí)報(bào)local proxy failed或面板打不開(kāi)提示connection refused。這是網(wǎng)關(guān)沒(méi)起來(lái)或綁定地址不對(duì)。先確認(rèn)進(jìn)程在跑openclaw gateway status如果沒(méi)跑執(zhí)行openclaw gateway start。如果跑了但面板打不開(kāi)檢查配置里gateway.bind是不是127.0.0.1端口是不是被別的程序占了。換端口openclaw config set gateway.port 18790 openclaw gateway restart5.3 reading choices 報(bào)錯(cuò)現(xiàn)象模型返回時(shí)提示error reading choices或返回結(jié)構(gòu)解析失敗。這通常是 Model ID 填錯(cuò)了或者該模型不支持當(dāng)前調(diào)用格式?；氐?TaoToken 控制臺(tái)確認(rèn)模型名拼寫(xiě)換成claude-sonnet-4-5或gpt-4o這類(lèi)標(biāo)準(zhǔn)名再試。如果換了還不行檢查 Base URL 末尾有沒(méi)有多余斜杠。5.4 技能加載失敗 / 中文路徑問(wèn)題現(xiàn)象clawhub install成功但技能不生效或啟動(dòng)時(shí)報(bào)路徑錯(cuò)誤。九成是中文路徑導(dǎo)致的。檢查你的 Windows 用戶(hù)名和 OpenClaw 工作目錄是否含中文。如果是把工作目錄改到純英文路徑openclaw config set workspace.path C:\openclaw-workspace openclaw gateway restart5.5 OAuth 相關(guān)報(bào)錯(cuò)現(xiàn)象提示OAuth token expired或要求重新授權(quán)。如果你用的是需要 OAuth 的模型通道token 過(guò)期了。TaoToken 走的是 API Key 模式不涉及 OAuth所以用統(tǒng)一 Key 能繞開(kāi)這類(lèi)問(wèn)題。確認(rèn)配置里provider是openai-compatible而不是某個(gè) OAuth provider。5.6 排查速查表報(bào)錯(cuò)關(guān)鍵詞最可能原因處理動(dòng)作401 UnauthorizedKey 錯(cuò)誤或 Base URL 帶后綴重貼 KeyURL 用https://taotoken.net/apilocal proxy failed網(wǎng)關(guān)未啟動(dòng)openclaw gateway startreading choicesModel ID 拼寫(xiě)錯(cuò)誤換成標(biāo)準(zhǔn)模型名技能不生效中文路徑工作目錄改純英文OAuth expired用了 OAuth 通道改用 API Key 模式6. 把 OpenClaw 用成日常統(tǒng)一 Key 與長(zhǎng)期編碼方案裝好只是開(kāi)始真正省時(shí)間的是把它嵌進(jìn)日常工作流。我現(xiàn)在的用法是早上到工位先讓 OpenClaw 整理昨天的下載文件和郵件附件中午用它把會(huì)議錄音轉(zhuǎn)寫(xiě)的文本總結(jié)成待辦下午批量處理報(bào)表。這些任務(wù)都不需要我寫(xiě)代碼自然語(yǔ)言描述就行。模型通道這塊TaoToken 的統(tǒng)一 Key 最大的好處是「配一次到處用」。OpenClaw 里配好之后如果你還用 Claude Code 做編碼、用其他工具做文檔處理同一個(gè) Key 和 Base URL 可以直接復(fù)用不用每個(gè)工具單獨(dú)注冊(cè)和配置。對(duì)于需要長(zhǎng)期跑編碼任務(wù)或 Agent 流程的場(chǎng)景可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_coding想快速驗(yàn)證某個(gè)模型效果直接用模型對(duì)話頁(yè)面試https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_models接入文檔在這里遇到配置細(xì)節(jié)可以查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_doc最后給幾個(gè)實(shí)測(cè)下來(lái)有用的技巧。第一把常用任務(wù)寫(xiě)成 OpenClaw 的定時(shí)任務(wù)比如每天早上九點(diǎn)自動(dòng)整理下載文件夾省得每次手動(dòng)觸發(fā)。第二技能不要一次裝太多先裝file-organizer和office-automation這兩個(gè)最高頻的用順了再加。第三配置文件改之前先備份config.json改壞了能快速回滾。第四如果團(tuán)隊(duì)多人用把工作目錄放在共享盤(pán)上但注意并發(fā)寫(xiě)入沖突建議每人一個(gè)子目錄。OpenClaw 的價(jià)值不在于它多智能而在于它把「說(shuō)一句話就能讓電腦干活」這件事變得門(mén)檻足夠低。裝一次配一次 Key后面就是不斷加技能、加任務(wù)的過(guò)程。 OpenClaw 快速安裝與本地應(yīng)用實(shí)戰(zhàn)：從 Node.js 到 ClawHub 每一步都有截圖加詳細(xì)說(shuō)明，TaoToken 統(tǒng)一 Key 讓打工人也有下屬
1. 為什么打工人需要一個(gè)本地 AI 助手OpenClaw 能幫你做什么如果你每天的工作里有一半時(shí)間在重復(fù)「下載文件夾又亂了」「周報(bào)數(shù)據(jù)要從三個(gè) Excel 里拼」「會(huì)議紀(jì)要要手動(dòng)整理」這類(lèi)事那 OpenClaw 值得你花十分鐘裝一次。它是一個(gè)開(kāi)源的本地智能體框架跑在你自己電腦上能調(diào)用大模型理解你的自然語(yǔ)言指令然后真的去操作文件、執(zhí)行腳本、拉取數(shù)據(jù)。和網(wǎng)頁(yè)版聊天機(jī)器人最大的區(qū)別是它不只是「說(shuō)」而是「做」。我第一次接觸 OpenClaw 是因?yàn)橐粋€(gè)很具體的痛點(diǎn)——每周要從十幾個(gè) CSV 里匯總銷(xiāo)售數(shù)據(jù)手動(dòng)復(fù)制粘貼要花四十分鐘。裝好 OpenClaw 之后一句「把 D 盤(pán)報(bào)表文件夾里本周的 CSV 合并成一張表按日期排序」就能搞定。它背后靠的是技能Skill機(jī)制類(lèi)似手機(jī)裝 App裝什么技能就能干什么活。這篇文章面向 Windows 用戶(hù)從零開(kāi)始走完整條鏈路裝 Node.js、配 PowerShell、拉 OpenClaw、裝 ClawHub 技能、接入模型、跑通第一個(gè)任務(wù)。每一步都有可復(fù)制的命令和驗(yàn)證動(dòng)作。模型接入這塊我用 TaoToken 的統(tǒng)一 Key 來(lái)做一個(gè) Key 走通多個(gè)模型省得在好幾個(gè)平臺(tái)之間來(lái)回切換配置。適合誰(shuí)看會(huì)用 PowerShell 復(fù)制粘貼命令、但沒(méi)寫(xiě)過(guò)復(fù)雜腳本的辦公族想給團(tuán)隊(duì)搭一個(gè)本地自動(dòng)化助手的運(yùn)維同學(xué)以及被各種 AI 工具注冊(cè)流程折騰煩了、想找個(gè)統(tǒng)一入口的開(kāi)發(fā)者。不需要你會(huì)寫(xiě)代碼但需要你愿意跟著敲命令。裝之前先確認(rèn)三件事系統(tǒng)是 Windows 10 21H2 以上或 Windows 1164 位內(nèi)存至少 8GB跑本地模型建議 16GB磁盤(pán)留 5GB 以上空間。另外安裝路徑和你的 Windows 用戶(hù)名都不要用中文這是后面技能加載失敗最常見(jiàn)的原因我踩過(guò)這個(gè)坑排查了半小時(shí)才發(fā)現(xiàn)是用戶(hù)名帶中文導(dǎo)致的。2. 前置準(zhǔn)備N(xiāo)ode.js、npm 與 PowerShell 環(huán)境一次配好OpenClaw 的核心依賴(lài)是 Node.js而且版本要求比較嚴(yán)必須 22.0.0 以上的 LTS 版本。低于這個(gè)版本會(huì)在啟動(dòng)時(shí)報(bào)語(yǔ)法錯(cuò)誤很多人卡在這一步以為是安裝腳本壞了其實(shí)是 Node 版本太舊。所以這一章我們先把地基打好。2.1 用 winget 裝 Node.js 22 LTSWindows 10/11 自帶 winget 包管理器這是最省事的方式。打開(kāi)管理員 PowerShell按 Win X選「終端(管理員)」執(zhí)行winget install OpenJS.NodeJS.LTS --version 22.12.0如果你不確定 winget 里有哪些版本可以先搜一下winget search OpenJS.NodeJS裝完之后必須重開(kāi)一個(gè) PowerShell 窗口因?yàn)榄h(huán)境變量需要重新加載。然后驗(yàn)證node --version npm --version正常輸出應(yīng)該是v22.12.0和類(lèi)似10.9.0的 npm 版本號(hào)。如果node命令提示「不是內(nèi)部或外部命令」說(shuō)明 PATH 沒(méi)生效重開(kāi)終端或者重啟電腦即可。2.2 切換 npm 國(guó)內(nèi)鏡像默認(rèn) npm 源在國(guó)內(nèi)下載會(huì)很慢甚至超時(shí)。切換成 npmmirror 鏡像npm config set registry https://registry.npmmirror.com npm config get registry第二條命令應(yīng)該返回https://registry.npmmirror.com/確認(rèn)切換成功。這一步能讓你后面裝 ClawHub 和技能包的速度從「等到懷疑人生」變成「幾秒鐘搞定」。2.3 配置 PowerShell 執(zhí)行策略O(shè)penClaw 的安裝腳本是遠(yuǎn)程腳本PowerShell 默認(rèn)會(huì)攔截。需要把當(dāng)前用戶(hù)的執(zhí)行策略設(shè)為 RemoteSignedSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser按 Y 確認(rèn)。這個(gè)設(shè)置只影響當(dāng)前用戶(hù)不會(huì)降低系統(tǒng)整體安全性是運(yùn)行本地腳本的標(biāo)準(zhǔn)操作。2.4 環(huán)境自檢清單在正式裝 OpenClaw 之前跑一遍這個(gè)自檢把問(wèn)題提前暴露Write-Host Node 版本: (node --version) Write-Host npm 版本: (npm --version) Write-Host npm 源: (npm config get registry) Write-Host 執(zhí)行策略: (Get-ExecutionPolicy -Scope CurrentUser) Write-Host 當(dāng)前用戶(hù): $env:USERNAME重點(diǎn)看兩處執(zhí)行策略必須是RemoteSigned或Unrestricted當(dāng)前用戶(hù)名不能含中文。如果用戶(hù)名是中文建議新建一個(gè)英文名的本地賬戶(hù)來(lái)跑 OpenClaw或者把工作目錄放到C:\openclaw-workspace這類(lèi)純英文路徑下。注意不要用系統(tǒng)自帶的 Node.js 舊版本直接升級(jí)容易殘留舊文件導(dǎo)致版本沖突。如果之前裝過(guò) Node先用winget uninstall OpenJS.NodeJS卸干凈再裝。3. 安裝 OpenClaw 并接入 TaoToken 統(tǒng)一 Key環(huán)境就緒后進(jìn)入正題。這一章分兩部分先把 OpenClaw 本體裝上再配置模型通道。模型這塊用 TaoToken 的統(tǒng)一 Key一個(gè) Key 就能調(diào)用多個(gè)模型配置一次到處能用。3.1 一鍵安裝 OpenClaw在管理員 PowerShell 里執(zhí)行官方安裝腳本iwr -useb https://openclaw.ai/install.ps1 | iex腳本會(huì)自動(dòng)檢測(cè) Node.js、下載 OpenClaw 核心程序、配置環(huán)境變量全程 3 到 8 分鐘取決于網(wǎng)速。中途不要關(guān)終端?？吹絆penClaw installed successfully就成功了。驗(yàn)證openclaw --version輸出類(lèi)似openclaw v2026.3.8即安裝成功。如果你已經(jīng)有 Node.js 22 環(huán)境也可以走 npm 手動(dòng)安裝更可控npm install -g openclawlatest openclaw --version3.2 獲取 TaoToken API Key打開(kāi) TaoToken 控制臺(tái)創(chuàng)建 API Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_install登錄后在「API Keys」頁(yè)面點(diǎn)創(chuàng)建復(fù)制生成的 Key形如sk-xxxxxxxx。這個(gè) Key 就是你的統(tǒng)一憑證后面所有模型調(diào)用都用它。建議先存到記事本下一步要粘貼。3.3 配置 OpenClaw 的模型通道OpenClaw 的配置文件在~/.openclaw目錄下Windows 上對(duì)應(yīng)C:\Users\你的用戶(hù)名\.openclaw。我們通過(guò)初始化向?qū)?lái)配置比手改文件更穩(wěn)。執(zhí)行openclaw onboard向?qū)?huì)依次問(wèn)你幾個(gè)問(wèn)題。走到模型配置這一步時(shí)選擇自定義 OpenAI 兼容通道Custom / OpenAI-Compatible然后填入以下三件套配置項(xiàng)填寫(xiě)內(nèi)容Base URLhttps://taotoken.net/apiAPI Key你剛才復(fù)制的sk-xxxxxxxxModel ID例如claude-sonnet-4-5或gpt-4o按需選Base URL 這里注意不要帶末尾斜杠也不要加 UTM 參數(shù)就是干凈的https://taotoken.net/api。Model ID 填你在 TaoToken 控制臺(tái)里能看到的具體模型名。如果你更習(xí)慣直接改配置文件OpenClaw 的模型配置存在~/.openclaw/config.json對(duì)應(yīng)的片段長(zhǎng)這樣{ models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: claude-sonnet-4-5 } }, gateway: { port: 18789, bind: 127.0.0.1 } }改完保存重啟網(wǎng)關(guān)生效。用 JSON 配置的好處是以后換模型只改model字段不用重跑向?qū)А?.4 啟動(dòng)網(wǎng)關(guān)服務(wù)配置完成后啟動(dòng) OpenClaw 網(wǎng)關(guān)openclaw gateway start看到Gateway started successfully后瀏覽器訪問(wèn)http://localhost:18789能打開(kāi)中文控制面板就說(shuō)明整條鏈路通了。面板里能看到 AI 對(duì)話、技能管理、定時(shí)任務(wù)幾個(gè)模塊。提示如果 18789 端口被占用執(zhí)行openclaw config set gateway.port 18790換端口然后重啟網(wǎng)關(guān)。4. 用 ClawHub 拉取技能并跑通第一個(gè)自動(dòng)化任務(wù)OpenClaw 本體只是個(gè)框架真正干活的是技能。ClawHub 是官方的技能管理工具類(lèi)似 npm 之于 Node.js。這一章我們裝 ClawHub、拉幾個(gè)高頻技能然后跑一個(gè)真實(shí)任務(wù)驗(yàn)證。4.1 安裝 ClawHub CLInpm install -g clawhublatest --registry https://registry.npmmirror.com clawhub --version能輸出版本號(hào)就裝好了。4.2 安裝高頻技能先裝一個(gè)安全守門(mén)人它會(huì)掃描其他技能的隱私風(fēng)險(xiǎn)必裝clawhub install skill-vetter然后按需裝幾個(gè)覆蓋日常場(chǎng)景的clawhub install office-automation clawhub install file-organizer clawhub install tavily-search clawhub install remind-meoffice-automation處理 Excel/Word/PPT 批量操作file-organizer自動(dòng)整理文件夾tavily-search做實(shí)時(shí)聯(lián)網(wǎng)搜索remind-me管會(huì)議和打卡提醒。裝完用clawhub list確認(rèn)clawhub list應(yīng)該能看到已安裝技能列表。裝完技能后重啟網(wǎng)關(guān)讓它們生效openclaw gateway restart4.3 跑通第一個(gè)任務(wù)整理下載文件夾打開(kāi)http://localhost:18789進(jìn)入對(duì)話界面輸入幫我整理 C:\Users\你的用戶(hù)名\Downloads 文件夾按文件類(lèi)型文檔、圖片、視頻、安裝包分類(lèi)歸檔刪除重復(fù)文件保留最新版本OpenClaw 會(huì)先展示一個(gè)執(zhí)行計(jì)劃列出它打算怎么分類(lèi)、移動(dòng)哪些文件。你確認(rèn)后它調(diào)用file-organizer技能執(zhí)行。執(zhí)行完打開(kāi)下載文件夾能看到文件已經(jīng)按類(lèi)型分好重復(fù)文件被清理。這一步的關(guān)鍵是先看計(jì)劃再確認(rèn)。OpenClaw 默認(rèn)不會(huì)直接動(dòng)手會(huì)等你點(diǎn)頭這是它的安全設(shè)計(jì)。如果你發(fā)現(xiàn)計(jì)劃里有不想動(dòng)的文件可以在確認(rèn)前補(bǔ)充指令比如「不要?jiǎng)?.zip 文件」。4.4 驗(yàn)證模型通道是否真的走通想確認(rèn)請(qǐng)求確實(shí)走了 TaoToken 通道可以在對(duì)話里問(wèn)一個(gè)需要模型推理的問(wèn)題比如「把下面這段會(huì)議記錄總結(jié)成三條待辦」。如果模型正常返回結(jié)構(gòu)化結(jié)果說(shuō)明 Base URL、Key、Model ID 三件套都配對(duì)了。如果返回報(bào)錯(cuò)看下一章的排查。5. 常見(jiàn)報(bào)錯(cuò)排查401、端口占用與技能加載失敗裝的過(guò)程中大概率會(huì)碰到幾個(gè)典型報(bào)錯(cuò)這一章按真實(shí)錯(cuò)誤信息來(lái)對(duì)照排查。5.1 401 Unauthorized現(xiàn)象對(duì)話時(shí)提示401 Unauthorized或invalid api key。原因基本是 Key 沒(méi)配對(duì)。檢查三處Key 是否復(fù)制完整有沒(méi)有漏掉sk-前綴后面的字符Base URL 是否寫(xiě)成了https://taotoken.net/api不要帶/v1后綴也不要帶 UTM 參數(shù)配置文件里apiKey字段有沒(méi)有多余空格。改完重啟網(wǎng)關(guān)。5.2 local proxy failed / connection refused現(xiàn)象啟動(dòng)時(shí)報(bào)local proxy failed或面板打不開(kāi)提示connection refused。這是網(wǎng)關(guān)沒(méi)起來(lái)或綁定地址不對(duì)。先確認(rèn)進(jìn)程在跑openclaw gateway status如果沒(méi)跑執(zhí)行openclaw gateway start。如果跑了但面板打不開(kāi)檢查配置里gateway.bind是不是127.0.0.1端口是不是被別的程序占了。換端口openclaw config set gateway.port 18790 openclaw gateway restart5.3 reading choices 報(bào)錯(cuò)現(xiàn)象模型返回時(shí)提示error reading choices或返回結(jié)構(gòu)解析失敗。這通常是 Model ID 填錯(cuò)了或者該模型不支持當(dāng)前調(diào)用格式?；氐?TaoToken 控制臺(tái)確認(rèn)模型名拼寫(xiě)換成claude-sonnet-4-5或gpt-4o這類(lèi)標(biāo)準(zhǔn)名再試。如果換了還不行檢查 Base URL 末尾有沒(méi)有多余斜杠。5.4 技能加載失敗 / 中文路徑問(wèn)題現(xiàn)象clawhub install成功但技能不生效或啟動(dòng)時(shí)報(bào)路徑錯(cuò)誤。九成是中文路徑導(dǎo)致的。檢查你的 Windows 用戶(hù)名和 OpenClaw 工作目錄是否含中文。如果是把工作目錄改到純英文路徑openclaw config set workspace.path C:\openclaw-workspace openclaw gateway restart5.5 OAuth 相關(guān)報(bào)錯(cuò)現(xiàn)象提示OAuth token expired或要求重新授權(quán)。如果你用的是需要 OAuth 的模型通道token 過(guò)期了。TaoToken 走的是 API Key 模式不涉及 OAuth所以用統(tǒng)一 Key 能繞開(kāi)這類(lèi)問(wèn)題。確認(rèn)配置里provider是openai-compatible而不是某個(gè) OAuth provider。5.6 排查速查表報(bào)錯(cuò)關(guān)鍵詞最可能原因處理動(dòng)作401 UnauthorizedKey 錯(cuò)誤或 Base URL 帶后綴重貼 KeyURL 用https://taotoken.net/apilocal proxy failed網(wǎng)關(guān)未啟動(dòng)openclaw gateway startreading choicesModel ID 拼寫(xiě)錯(cuò)誤換成標(biāo)準(zhǔn)模型名技能不生效中文路徑工作目錄改純英文OAuth expired用了 OAuth 通道改用 API Key 模式6. 把 OpenClaw 用成日常統(tǒng)一 Key 與長(zhǎng)期編碼方案裝好只是開(kāi)始真正省時(shí)間的是把它嵌進(jìn)日常工作流。我現(xiàn)在的用法是早上到工位先讓 OpenClaw 整理昨天的下載文件和郵件附件中午用它把會(huì)議錄音轉(zhuǎn)寫(xiě)的文本總結(jié)成待辦下午批量處理報(bào)表。這些任務(wù)都不需要我寫(xiě)代碼自然語(yǔ)言描述就行。模型通道這塊TaoToken 的統(tǒng)一 Key 最大的好處是「配一次到處用」。OpenClaw 里配好之后如果你還用 Claude Code 做編碼、用其他工具做文檔處理同一個(gè) Key 和 Base URL 可以直接復(fù)用不用每個(gè)工具單獨(dú)注冊(cè)和配置。對(duì)于需要長(zhǎng)期跑編碼任務(wù)或 Agent 流程的場(chǎng)景可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_coding想快速驗(yàn)證某個(gè)模型效果直接用模型對(duì)話頁(yè)面試https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_models接入文檔在這里遇到配置細(xì)節(jié)可以查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_doc最后給幾個(gè)實(shí)測(cè)下來(lái)有用的技巧。第一把常用任務(wù)寫(xiě)成 OpenClaw 的定時(shí)任務(wù)比如每天早上九點(diǎn)自動(dòng)整理下載文件夾省得每次手動(dòng)觸發(fā)。第二技能不要一次裝太多先裝file-organizer和office-automation這兩個(gè)最高頻的用順了再加。第三配置文件改之前先備份config.json改壞了能快速回滾。第四如果團(tuán)隊(duì)多人用把工作目錄放在共享盤(pán)上但注意并發(fā)寫(xiě)入沖突建議每人一個(gè)子目錄。OpenClaw 的價(jià)值不在于它多智能而在于它把「說(shuō)一句話就能讓電腦干活」這件事變得門(mén)檻足夠低。裝一次配一次 Key后面就是不斷加技能、加任務(wù)的過(guò)程。