一 Key 與 config.toml 骨架)
1. Windows 上跑 openclaw ollama到底難在哪openclaw 是一個(gè)可以本地部署的 AI 助手網(wǎng)關(guān)它能對(duì)接云端 API也能對(duì)接你本機(jī)跑的大模型ollama 則是 Windows 上最省心的本地大模型運(yùn)行工具一條命令就能把 qwen 系列模型拉下來跑起來。把這兩個(gè)東西接在一起你就能得到一個(gè)完全跑在自己電腦上的對(duì)話入口數(shù)據(jù)不出本機(jī)斷網(wǎng)也能用。適合誰適合想折騰本地 AI、又不想被各種 Key 和額度卡住的開發(fā)者尤其是手里有 16G 以上內(nèi)存、裝了獨(dú)顯或者能接受 CPU 推理慢一點(diǎn)的 Windows 用戶。但真上手你會(huì)發(fā)現(xiàn)坑不少Node.js 版本不對(duì)導(dǎo)致 npm 全局安裝失敗、ollama 的/v1接口和 openclaw 的 provider 類型對(duì)不上、config.toml 里 endpoint 寫錯(cuò)一個(gè)斜杠就連不上、API key 明明 ollama 不需要卻被校驗(yàn)攔住。我試過在幾臺(tái) Windows 機(jī)器上重復(fù)這套流程最耗時(shí)間的從來不是安裝而是配置骨架寫錯(cuò)之后的報(bào)錯(cuò)定位。這篇就按「環(huán)境準(zhǔn)備 → 安裝 openclaw → 寫 config.toml → 接入 ollama → 驗(yàn)證對(duì)話 → 排錯(cuò)」的順序走一遍同時(shí)把 TaoToken 的統(tǒng)一 Key 通道也接進(jìn)來這樣你本地模型和云端模型可以共用一套配置骨架后面想切模型只改幾行。全程命令可直接復(fù)制配置文件給完整片段。2. 前置準(zhǔn)備Node.js、ollama 與 TaoToken 統(tǒng)一 Key2.1 Node.js 環(huán)境openclaw 通過 npm 分發(fā)所以第一步是裝 Node.js。去 Node.js 官網(wǎng)下載 Windows 安裝包選 LTS 版本即可安裝時(shí)勾選「Add to PATH」。裝完用管理員權(quán)限打開 PowerShell 驗(yàn)證node -v npm -v正常會(huì)輸出類似v22.x.x和10.x.x的版本號(hào)。如果提示「不是內(nèi)部或外部命令」說明 PATH 沒生效重開一個(gè) PowerShell 窗口或者手動(dòng)把 Node 安裝目錄加進(jìn)系統(tǒng)環(huán)境變量。注意不要用太老的 Node比如 16 以下openclaw 的部分依賴要求 Node 18版本過低會(huì)在npm install -g階段報(bào) engine 不匹配。2.2 ollama 安裝與模型拉取去 ollama 官網(wǎng)下載 Windows 安裝包雙擊裝完它會(huì)自動(dòng)在后臺(tái)起一個(gè)服務(wù)默認(rèn)監(jiān)聽127.0.0.1:11434。打開一個(gè)新的 PowerShell 驗(yàn)證ollama -v ollama pull qwen2.5:7b ollama psollama ps會(huì)列出當(dāng)前加載的模型全名比如qwen2.5:7b。這個(gè)名字后面要一字不差地填進(jìn) openclaw 的配置里寫錯(cuò)一個(gè)字符就會(huì)報(bào)模型不存在。ollama 的 OpenAI 兼容接口地址是http://127.0.0.1:11434/v1注意結(jié)尾的/v1不能少openclaw 走的是 OpenAI 兼容協(xié)議靠這個(gè)路徑區(qū)分。2.3 TaoToken 統(tǒng)一 Key 的作用本地 ollama 其實(shí)不需要真實(shí) API key但 openclaw 的 provider 配置里這個(gè)字段不能為空隨便填一串字符也能過。那為什么還要提 TaoToken因?yàn)閷?shí)際用起來你往往不止一個(gè)模型本地 qwen 跑簡單任務(wù)遇到復(fù)雜推理想切云端模型。如果每個(gè) provider 都單獨(dú)配 Key、單獨(dú)記地址config.toml 會(huì)越來越亂。TaoToken 提供的是統(tǒng)一 Key 和統(tǒng)一 API 通道你可以在一個(gè)地方管理 Key然后讓 openclaw 通過同一個(gè) base_url 訪問不同模型。它的 API 地址是https://taotoken.net/api控制臺(tái)在https://taotoken.net/consoleKey 在https://taotoken.net/api-keys生成。這樣你的 config.toml 里可以同時(shí)保留本地 ollama 端點(diǎn)和 TaoToken 端點(diǎn)切換時(shí)只改默認(rèn)模型指向。3. 安裝 openclaw 并生成 config.toml 骨架3.1 全局安裝用管理員權(quán)限打開 PowerShell執(zhí)行npm install -g openclawlatest等它跑完驗(yàn)證openclaw --version有版本號(hào)輸出就說明裝好了。如果卡在下載階段多半是 npm 源慢可以臨時(shí)切到國內(nèi)鏡像npm config set registry https://registry.npmmirror.com裝完再切回來也行或者保持鏡像源不影響使用。3.2 初始化配置openclaw 的配置走 onboard 流程但為了讓你看清結(jié)構(gòu)我建議先手動(dòng)建好 config.toml 再啟動(dòng)。默認(rèn)配置目錄在用戶目錄下C:\Users\你的用戶名\.openclaw\config.toml如果目錄不存在就手動(dòng)建。下面是一份可直接用的骨架包含本地 ollama 和 TaoToken 兩個(gè) provider# ~/.openclaw/config.toml default_provider ollama-local [providers.ollama-local] type openai-compatible base_url http://127.0.0.1:11434/v1 api_key ollama default_model qwen2.5:7b [providers.taotoken] type openai-compatible base_url https://taotoken.net/api api_key 你的_TaoToken_Key default_model claude-sonnet-4-20250514 [gateway] host 127.0.0.1 port 8787幾個(gè)關(guān)鍵點(diǎn)解釋一下。type必須寫openai-compatible因?yàn)?ollama 的/v1就是標(biāo)準(zhǔn) OpenAI 格式選錯(cuò)類型會(huì)直接連不上。base_url結(jié)尾不要多加斜杠http://127.0.0.1:11434/v1/這種多一個(gè)斜杠在某些版本會(huì)拼出雙斜杠導(dǎo)致 404。api_key對(duì) ollama 來說隨便填但字段不能省。default_model要和ollama ps顯示的全名完全一致。提示TaoToken 的 Key 建議單獨(dú)放環(huán)境變量再引用避免明文寫在配置文件里。openclaw 支持${ENV_VAR}語法寫成api_key ${TAOTOKEN_KEY}也行。3.3 啟動(dòng)網(wǎng)關(guān)配置寫好后啟動(dòng)openclaw gateway run第一次啟動(dòng)它會(huì)讀 config.toml加載 provider?？吹筋愃苂ateway listening on 127.0.0.1:8787就說明起來了。如果端口被占用改 config.toml 里的 port 再重啟。4. 驗(yàn)證請(qǐng)求從命令行到對(duì)話閉環(huán)4.1 命令行驗(yàn)證 ollama 端點(diǎn)先確認(rèn) ollama 本身能被 OpenAI 協(xié)議訪問用 curl 測一下curl http://127.0.0.1:11434/v1/chat/completions -H Content-Type: application/json -d {\model\:\qwen2.5:7b\,\messages\:[{\role\:\user\,\content\:\你好\}]}能返回一段 JSON 帶choices字段就說明 ollama 側(cè)沒問題。如果這里就報(bào)錯(cuò)先解決 ollama別急著調(diào) openclaw。4.2 通過 openclaw 發(fā)起對(duì)話網(wǎng)關(guān)起來后另開一個(gè) PowerShell 窗口openclaw chat --provider ollama-local --message 用一句話解釋什么是本地大模型如果配置正確你會(huì)看到模型返回的中文回答。這一步跑通說明 openclaw → ollama 的鏈路完整了。4.3 切換到 TaoToken 端點(diǎn)想驗(yàn)證云端通道把 provider 換成 taotokenopenclaw chat --provider taotoken --message 你好測試統(tǒng)一 Key 通道返回正常就說明 TaoToken 的 Key 和 base_url 都配對(duì)了。你也可以打開模型對(duì)話頁面https://taotoken.net/models直接在網(wǎng)頁里對(duì)比同一個(gè)問題的輸出確認(rèn)通道一致。4.4 打開 Dashboardopenclaw 自帶一個(gè) Control UI執(zhí)行openclaw dashboard它會(huì)自動(dòng)帶 token 打開瀏覽器跳到已授權(quán)的頁面。如果提示 token_missing說明網(wǎng)關(guān)沒起或者 token 沒生成先openclaw gateway status看狀態(tài)再openclaw gateway stop然后openclaw gateway run重啟。5. 本篇常見報(bào)錯(cuò)排查5.1 npm install 報(bào) EACCES 或權(quán)限錯(cuò)誤Windows 上全局安裝偶爾會(huì)因?yàn)槟夸洐?quán)限失敗。解決辦法是用管理員權(quán)限開 PowerShell或者改 npm 全局目錄到用戶目錄npm config set prefix C:\Users\你的用戶名\npm-global然后把C:\Users\你的用戶名\npm-global加進(jìn) PATH重開終端再裝。5.2 連接 ollama 報(bào) ECONNREFUSED這個(gè)報(bào)錯(cuò)基本是 ollama 服務(wù)沒起或者地址寫錯(cuò)。先確認(rèn)ollama ps如果命令本身報(bào)錯(cuò)說明 ollama 沒裝好或沒啟動(dòng)。如果ollama ps正常但 openclaw 連不上檢查 config.toml 里的base_url是不是http://127.0.0.1:11434/v1別寫成localhost某些環(huán)境解析到 IPv6 會(huì)失敗也別漏了/v1。5.3 報(bào) model not found模型名和ollama ps顯示的不一致。比如你拉的是qwen2.5:7b配置里寫成qwen2.5就會(huì)報(bào)錯(cuò)。ollama 的模型名帶 tag必須完整。改完 config.toml 記得重啟網(wǎng)關(guān)。5.4 返回 404 或路徑錯(cuò)誤多半是 base_url 結(jié)尾多了斜杠或者 provider type 寫成了別的。確認(rèn)type openai-compatiblebase_url結(jié)尾是/v1不帶斜杠。5.5 TaoToken 通道報(bào) 401Key 無效或沒填對(duì)。去https://taotoken.net/api-keys重新生成一個(gè)確認(rèn)復(fù)制時(shí)沒有多余空格。如果用了環(huán)境變量引用確認(rèn)變量名拼寫一致且啟動(dòng)網(wǎng)關(guān)的終端里能讀到這個(gè)變量。5.6 網(wǎng)關(guān)端口沖突openclaw gateway run報(bào)端口被占用改 config.toml 里的port比如改成 8788然后重啟。也可以用openclaw gateway stop先停掉舊進(jìn)程。6. 后續(xù)怎么用本地與云端共存的配置思路這套骨架跑通后你手里其實(shí)有了一個(gè)可擴(kuò)展的模型網(wǎng)關(guān)。本地 ollama 負(fù)責(zé)隱私敏感、斷網(wǎng)可用的場景TaoToken 通道負(fù)責(zé)需要更強(qiáng)推理能力的任務(wù)。config.toml 里加新模型就是復(fù)制一段 provider 塊改base_url、api_key、default_model三處。如果你打算長期用 openclaw 做編碼助手或者接 Agent 工作流建議把 TaoToken 的 Coding Plan 也了解一下地址在https://taotoken.net/coding-plan它針對(duì)長時(shí)間編碼場景做了額度優(yōu)化配合 openclaw 的 provider 配置可以直接用。接入文檔在https://taotoken.net/doc里面有各語言 SDK 的調(diào)用示例想自己寫腳本調(diào)模型的時(shí)候能省不少事。最后提醒一句改完 config.toml 一定要重啟網(wǎng)關(guān)openclaw 不會(huì)熱加載配置。每次改完先openclaw gateway stop再openclaw gateway run然后openclaw gateway status確認(rèn)狀態(tài)這三步養(yǎng)成習(xí)慣能省掉一半的「明明改了卻沒生效」的困惑。 （Windows）本地安裝openclaw，完成配置并接入本地大模型（ollama）全流程指南：TaoToken 統(tǒng)一 Key 與 config.toml 骨架
1. Windows 上跑 openclaw ollama到底難在哪openclaw 是一個(gè)可以本地部署的 AI 助手網(wǎng)關(guān)它能對(duì)接云端 API也能對(duì)接你本機(jī)跑的大模型ollama 則是 Windows 上最省心的本地大模型運(yùn)行工具一條命令就能把 qwen 系列模型拉下來跑起來。把這兩個(gè)東西接在一起你就能得到一個(gè)完全跑在自己電腦上的對(duì)話入口數(shù)據(jù)不出本機(jī)斷網(wǎng)也能用。適合誰適合想折騰本地 AI、又不想被各種 Key 和額度卡住的開發(fā)者尤其是手里有 16G 以上內(nèi)存、裝了獨(dú)顯或者能接受 CPU 推理慢一點(diǎn)的 Windows 用戶。但真上手你會(huì)發(fā)現(xiàn)坑不少Node.js 版本不對(duì)導(dǎo)致 npm 全局安裝失敗、ollama 的/v1接口和 openclaw 的 provider 類型對(duì)不上、config.toml 里 endpoint 寫錯(cuò)一個(gè)斜杠就連不上、API key 明明 ollama 不需要卻被校驗(yàn)攔住。我試過在幾臺(tái) Windows 機(jī)器上重復(fù)這套流程最耗時(shí)間的從來不是安裝而是配置骨架寫錯(cuò)之后的報(bào)錯(cuò)定位。這篇就按「環(huán)境準(zhǔn)備 → 安裝 openclaw → 寫 config.toml → 接入 ollama → 驗(yàn)證對(duì)話 → 排錯(cuò)」的順序走一遍同時(shí)把 TaoToken 的統(tǒng)一 Key 通道也接進(jìn)來這樣你本地模型和云端模型可以共用一套配置骨架后面想切模型只改幾行。全程命令可直接復(fù)制配置文件給完整片段。2. 前置準(zhǔn)備Node.js、ollama 與 TaoToken 統(tǒng)一 Key2.1 Node.js 環(huán)境openclaw 通過 npm 分發(fā)所以第一步是裝 Node.js。去 Node.js 官網(wǎng)下載 Windows 安裝包選 LTS 版本即可安裝時(shí)勾選「Add to PATH」。裝完用管理員權(quán)限打開 PowerShell 驗(yàn)證node -v npm -v正常會(huì)輸出類似v22.x.x和10.x.x的版本號(hào)。如果提示「不是內(nèi)部或外部命令」說明 PATH 沒生效重開一個(gè) PowerShell 窗口或者手動(dòng)把 Node 安裝目錄加進(jìn)系統(tǒng)環(huán)境變量。注意不要用太老的 Node比如 16 以下openclaw 的部分依賴要求 Node 18版本過低會(huì)在npm install -g階段報(bào) engine 不匹配。2.2 ollama 安裝與模型拉取去 ollama 官網(wǎng)下載 Windows 安裝包雙擊裝完它會(huì)自動(dòng)在后臺(tái)起一個(gè)服務(wù)默認(rèn)監(jiān)聽127.0.0.1:11434。打開一個(gè)新的 PowerShell 驗(yàn)證ollama -v ollama pull qwen2.5:7b ollama psollama ps會(huì)列出當(dāng)前加載的模型全名比如qwen2.5:7b。這個(gè)名字后面要一字不差地填進(jìn) openclaw 的配置里寫錯(cuò)一個(gè)字符就會(huì)報(bào)模型不存在。ollama 的 OpenAI 兼容接口地址是http://127.0.0.1:11434/v1注意結(jié)尾的/v1不能少openclaw 走的是 OpenAI 兼容協(xié)議靠這個(gè)路徑區(qū)分。2.3 TaoToken 統(tǒng)一 Key 的作用本地 ollama 其實(shí)不需要真實(shí) API key但 openclaw 的 provider 配置里這個(gè)字段不能為空隨便填一串字符也能過。那為什么還要提 TaoToken因?yàn)閷?shí)際用起來你往往不止一個(gè)模型本地 qwen 跑簡單任務(wù)遇到復(fù)雜推理想切云端模型。如果每個(gè) provider 都單獨(dú)配 Key、單獨(dú)記地址config.toml 會(huì)越來越亂。TaoToken 提供的是統(tǒng)一 Key 和統(tǒng)一 API 通道你可以在一個(gè)地方管理 Key然后讓 openclaw 通過同一個(gè) base_url 訪問不同模型。它的 API 地址是https://taotoken.net/api控制臺(tái)在https://taotoken.net/consoleKey 在https://taotoken.net/api-keys生成。這樣你的 config.toml 里可以同時(shí)保留本地 ollama 端點(diǎn)和 TaoToken 端點(diǎn)切換時(shí)只改默認(rèn)模型指向。3. 安裝 openclaw 并生成 config.toml 骨架3.1 全局安裝用管理員權(quán)限打開 PowerShell執(zhí)行npm install -g openclawlatest等它跑完驗(yàn)證openclaw --version有版本號(hào)輸出就說明裝好了。如果卡在下載階段多半是 npm 源慢可以臨時(shí)切到國內(nèi)鏡像npm config set registry https://registry.npmmirror.com裝完再切回來也行或者保持鏡像源不影響使用。3.2 初始化配置openclaw 的配置走 onboard 流程但為了讓你看清結(jié)構(gòu)我建議先手動(dòng)建好 config.toml 再啟動(dòng)。默認(rèn)配置目錄在用戶目錄下C:\Users\你的用戶名\.openclaw\config.toml如果目錄不存在就手動(dòng)建。下面是一份可直接用的骨架包含本地 ollama 和 TaoToken 兩個(gè) provider# ~/.openclaw/config.toml default_provider ollama-local [providers.ollama-local] type openai-compatible base_url http://127.0.0.1:11434/v1 api_key ollama default_model qwen2.5:7b [providers.taotoken] type openai-compatible base_url https://taotoken.net/api api_key 你的_TaoToken_Key default_model claude-sonnet-4-20250514 [gateway] host 127.0.0.1 port 8787幾個(gè)關(guān)鍵點(diǎn)解釋一下。type必須寫openai-compatible因?yàn)?ollama 的/v1就是標(biāo)準(zhǔn) OpenAI 格式選錯(cuò)類型會(huì)直接連不上。base_url結(jié)尾不要多加斜杠http://127.0.0.1:11434/v1/這種多一個(gè)斜杠在某些版本會(huì)拼出雙斜杠導(dǎo)致 404。api_key對(duì) ollama 來說隨便填但字段不能省。default_model要和ollama ps顯示的全名完全一致。提示TaoToken 的 Key 建議單獨(dú)放環(huán)境變量再引用避免明文寫在配置文件里。openclaw 支持${ENV_VAR}語法寫成api_key ${TAOTOKEN_KEY}也行。3.3 啟動(dòng)網(wǎng)關(guān)配置寫好后啟動(dòng)openclaw gateway run第一次啟動(dòng)它會(huì)讀 config.toml加載 provider?？吹筋愃苂ateway listening on 127.0.0.1:8787就說明起來了。如果端口被占用改 config.toml 里的 port 再重啟。4. 驗(yàn)證請(qǐng)求從命令行到對(duì)話閉環(huán)4.1 命令行驗(yàn)證 ollama 端點(diǎn)先確認(rèn) ollama 本身能被 OpenAI 協(xié)議訪問用 curl 測一下curl http://127.0.0.1:11434/v1/chat/completions -H Content-Type: application/json -d {\model\:\qwen2.5:7b\,\messages\:[{\role\:\user\,\content\:\你好\}]}能返回一段 JSON 帶choices字段就說明 ollama 側(cè)沒問題。如果這里就報(bào)錯(cuò)先解決 ollama別急著調(diào) openclaw。4.2 通過 openclaw 發(fā)起對(duì)話網(wǎng)關(guān)起來后另開一個(gè) PowerShell 窗口openclaw chat --provider ollama-local --message 用一句話解釋什么是本地大模型如果配置正確你會(huì)看到模型返回的中文回答。這一步跑通說明 openclaw → ollama 的鏈路完整了。4.3 切換到 TaoToken 端點(diǎn)想驗(yàn)證云端通道把 provider 換成 taotokenopenclaw chat --provider taotoken --message 你好測試統(tǒng)一 Key 通道返回正常就說明 TaoToken 的 Key 和 base_url 都配對(duì)了。你也可以打開模型對(duì)話頁面https://taotoken.net/models直接在網(wǎng)頁里對(duì)比同一個(gè)問題的輸出確認(rèn)通道一致。4.4 打開 Dashboardopenclaw 自帶一個(gè) Control UI執(zhí)行openclaw dashboard它會(huì)自動(dòng)帶 token 打開瀏覽器跳到已授權(quán)的頁面。如果提示 token_missing說明網(wǎng)關(guān)沒起或者 token 沒生成先openclaw gateway status看狀態(tài)再openclaw gateway stop然后openclaw gateway run重啟。5. 本篇常見報(bào)錯(cuò)排查5.1 npm install 報(bào) EACCES 或權(quán)限錯(cuò)誤Windows 上全局安裝偶爾會(huì)因?yàn)槟夸洐?quán)限失敗。解決辦法是用管理員權(quán)限開 PowerShell或者改 npm 全局目錄到用戶目錄npm config set prefix C:\Users\你的用戶名\npm-global然后把C:\Users\你的用戶名\npm-global加進(jìn) PATH重開終端再裝。5.2 連接 ollama 報(bào) ECONNREFUSED這個(gè)報(bào)錯(cuò)基本是 ollama 服務(wù)沒起或者地址寫錯(cuò)。先確認(rèn)ollama ps如果命令本身報(bào)錯(cuò)說明 ollama 沒裝好或沒啟動(dòng)。如果ollama ps正常但 openclaw 連不上檢查 config.toml 里的base_url是不是http://127.0.0.1:11434/v1別寫成localhost某些環(huán)境解析到 IPv6 會(huì)失敗也別漏了/v1。5.3 報(bào) model not found模型名和ollama ps顯示的不一致。比如你拉的是qwen2.5:7b配置里寫成qwen2.5就會(huì)報(bào)錯(cuò)。ollama 的模型名帶 tag必須完整。改完 config.toml 記得重啟網(wǎng)關(guān)。5.4 返回 404 或路徑錯(cuò)誤多半是 base_url 結(jié)尾多了斜杠或者 provider type 寫成了別的。確認(rèn)type openai-compatiblebase_url結(jié)尾是/v1不帶斜杠。5.5 TaoToken 通道報(bào) 401Key 無效或沒填對(duì)。去https://taotoken.net/api-keys重新生成一個(gè)確認(rèn)復(fù)制時(shí)沒有多余空格。如果用了環(huán)境變量引用確認(rèn)變量名拼寫一致且啟動(dòng)網(wǎng)關(guān)的終端里能讀到這個(gè)變量。5.6 網(wǎng)關(guān)端口沖突openclaw gateway run報(bào)端口被占用改 config.toml 里的port比如改成 8788然后重啟。也可以用openclaw gateway stop先停掉舊進(jìn)程。6. 后續(xù)怎么用本地與云端共存的配置思路這套骨架跑通后你手里其實(shí)有了一個(gè)可擴(kuò)展的模型網(wǎng)關(guān)。本地 ollama 負(fù)責(zé)隱私敏感、斷網(wǎng)可用的場景TaoToken 通道負(fù)責(zé)需要更強(qiáng)推理能力的任務(wù)。config.toml 里加新模型就是復(fù)制一段 provider 塊改base_url、api_key、default_model三處。如果你打算長期用 openclaw 做編碼助手或者接 Agent 工作流建議把 TaoToken 的 Coding Plan 也了解一下地址在https://taotoken.net/coding-plan它針對(duì)長時(shí)間編碼場景做了額度優(yōu)化配合 openclaw 的 provider 配置可以直接用。接入文檔在https://taotoken.net/doc里面有各語言 SDK 的調(diào)用示例想自己寫腳本調(diào)模型的時(shí)候能省不少事。最后提醒一句改完 config.toml 一定要重啟網(wǎng)關(guān)openclaw 不會(huì)熱加載配置。每次改完先openclaw gateway stop再openclaw gateway run然后openclaw gateway status確認(rèn)狀態(tài)這三步養(yǎng)成習(xí)慣能省掉一半的「明明改了卻沒生效」的困惑。