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