1. 为什么要在 Windows 上折腾这只“龙虾”OpenClaw 是一个可以跑在本地的 AI 助手框架你可以把它理解成一个“数字员工”——它不只是聊天还能通过技能Skills帮你整理文件、汇总邮件、定时抓新闻。而 Windows 本地部署 OpenClaw 的核心价值在于数据不出本机、模型自己选、Key 自己管。但真正上手时很多人会卡在三个地方NodeJs 版本不对、Ollama 模型上下文太短、以及模型接入通道配置混乱。尤其是第三点如果你既想用本地 Ollama 的 qwen2.5又想随时切换到云端更强的模型没有一个统一的 Key 管理入口会非常痛苦。这篇教程面向 Windows 10/11 用户从零跑通 OpenClaw Ollama 本地模型同时接入 TaoToken 统一 Key 通道让你在本地模型和 OpenAI-compatible 云端接口之间自由切换。全程可复制配置骨架直接给踩过的坑我也会标出来。2. 前置准备NodeJs、Ollama 与 TaoToken 统一 Key2.1 NodeJs 环境检查OpenClaw 依赖 NodeJs 20 以上版本。打开 PowerShell输入node -v如果输出v20.x.x或更高就没问题。低于 20 的话去 NodeJs 官网下载 LTS 版本安装安装时勾选“Add to PATH”。2.2 安装 Ollama 并拉取模型Ollama 是本地模型运行环境下载 Windows 安装包后一路下一步即可。安装完成后验证ollama -v然后拉取 qwen2.5:7bollama pull qwen2.5:7b这个模型默认上下文只有 8k 左右对于 OpenClaw 处理长文档、多轮对话来说不够用。我们需要扩容到 32k。2.3 模型上下文扩容在用户目录下创建一个 Modelfilecd C:\Users\你的用户名 FROM qwen2.5:7b PARAMETER num_ctx 32768 | Out-File -Encoding ascii Modelfile ollama create qwen2.5:7b-32k -f Modelfile执行完后用ollama list应该能看到qwen2.5:7b-32k。2.4 TaoToken 统一 Key 的作用TaoToken 在这里扮演的是“统一 API 通道”的角色。你可以用它生成一个 Key然后在 OpenClaw 里配置 OpenAI-compatible 接口这样无论是本地 Ollama 还是云端模型都走同一套配置格式。对于需要频繁切换模型的场景这比每次改 base_url 和 key 要省事得多。注册和获取 Key 的入口在官网API 地址是https://taotoken.net/api。拿到 Key 后先放着后面配置会用到。3. 可复制配置OpenClaw 安装与 config.toml / settings.json 骨架3.1 安装 OpenClawnpm install -g openclaw openclaw onboard向导会依次问你几个关键项按下面填配置项填写内容Model/auth providerCustom ProviderAPI Base URLhttp://127.0.0.1:11434/v1本地 OllamaAPI Keyollama不能留空随便填一个字符串Endpoint compatibilityOpenAI-compatibleModel IDqwen2.5:7b-32k通讯渠道、技能等选项全部选Skip for now或No。3.2 config.toml 骨架OpenClaw 的配置文件通常在~/.openclaw/config.tomlWindows 下是C:\Users\用户名\.openclaw\config.toml。一个可用的骨架如下[gateway] port 18789 host 127.0.0.1 [model] provider custom base_url http://127.0.0.1:11434/v1 api_key ollama model_id qwen2.5:7b-32k compatibility openai [model.fallback] # 当本地模型不可用时走 TaoToken 统一通道 base_url https://taotoken.net/api/v1 api_key 你的TaoToken Key model_id gpt-4o-mini compatibility openai注意fallback段是可选的。如果你只想跑本地模型可以删掉。但加上它之后本地 Ollama 没启动时 OpenClaw 会自动切到云端不会直接报错。3.3 settings.json 补充配置部分版本的 OpenClaw 会用settings.json管理运行时参数{ gateway: { port: 18789, token_required: true }, model: { timeout: 120, max_retries: 2, stream: true }, skills: { auto_load: true, directory: ~/.openclaw/skills } }3.4 CC Switch 切换步骤如果你装了 CC Switch一个模型切换工具可以这样配置cc-switch add local-ollama --base-url http://127.0.0.1:11434/v1 --api-key ollama --model qwen2.5:7b-32k cc-switch add taotoken-cloud --base-url https://taotoken.net/api/v1 --api-key 你的Key --model gpt-4o-mini cc-switch use local-ollama切换时只需cc-switch use taotoken-cloudOpenClaw 下次请求就会走 TaoToken 通道。4. 验证请求一次对话跑通全链路4.1 启动 OpenClawopenclaw start看到Gateway running on http://127.0.0.1:18789就说明起来了。4.2 生成访问令牌openclaw token generate复制输出的令牌浏览器打开http://127.0.0.1:18789粘贴令牌登录。4.3 发一条测试消息在控制台对话框输入你好请用一句话介绍你自己并告诉我你当前使用的模型名称。如果配置正确你会看到类似回复我是运行在本地 OpenClaw 上的 AI 助手当前使用的模型是 qwen2.5:7b-32k。4.4 验证 TaoToken 通道把 config.toml 里的[model]段临时改成 fallback 的内容或者用 CC Switch 切到taotoken-cloud重启 OpenClaw 后再发一条消息。如果也能正常回复说明统一 Key 通道打通了。4.5 用 curl 直接验证接口不想开浏览器的话可以直接用 curl 测curl http://127.0.0.1:11434/v1/chat/completions -H Content-Type: application/json -H Authorization: Bearer ollama -d {model:qwen2.5:7b-32k,messages:[{role:user,content:test}]}返回 JSON 里有choices字段就说明 Ollama 的 OpenAI-compatible 接口正常。5. 本篇常见错排查5.1 NodeJs 版本过低导致安装失败报错关键词EBADENGINE或Unsupported engine。解决方法是升级到 NodeJs 20然后删掉node_modules重装。5.2 Ollama 端口被占用报错bind: address already in use。检查 11434 端口netstat -ano | findstr 11434如果有其他进程占用要么杀掉它要么改 Ollama 的监听端口环境变量OLLAMA_HOST。5.3 API Key 留空导致 401OpenClaw 向导里 API Key 不能留空即使本地 Ollama 不校验也要填一个占位符。填ollama就行。5.4 模型 ID 写错导致 404如果你拉的是qwen2.5:7b但配置里写qwen2.5:7b-32k而扩容步骤没执行成功就会报model not found。用ollama list确认模型名。5.5 上下文超限报错报错context length exceeded。说明 num_ctx 没生效。重新执行 Modelfile 创建步骤注意Out-File -Encoding ascii不能省否则 Windows 默认 UTF-16 会导致 Ollama 解析失败。5.6 TaoToken 通道 403检查 Key 是否复制完整、base_url 是否写成https://taotoken.net/api/v1注意结尾的/v1。如果还不行去控制台确认 Key 状态。6. 接入文档与模型对话入口本地跑通之后下一步就是让它真正干活。你可以先装几个核心技能openclaw skills install tavily-search openclaw skills install summarize openclaw skills install file-organizer技能装好后在控制台里直接下指令比如“帮我整理 Downloads 文件夹里的 PDF”。如果你需要长期编码或跑 Agent 任务建议用 Coding Plan 模式把模型切换和 Key 管理交给 TaoToken 统一处理省得每次手动改配置。接入文档与 API Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite模型对话测试入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite长期编码与 Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite遇到配置报错时优先看openclaw doctor的输出它会直接告诉你哪个环节断了。
1. 为什么要在 Windows 上折腾这只“龙虾”OpenClaw 是一个可以跑在本地的 AI 助手框架你可以把它理解成一个“数字员工”——它不只是聊天还能通过技能Skills帮你整理文件、汇总邮件、定时抓新闻。而 Windows 本地部署 OpenClaw 的核心价值在于数据不出本机、模型自己选、Key 自己管。但真正上手时很多人会卡在三个地方NodeJs 版本不对、Ollama 模型上下文太短、以及模型接入通道配置混乱。尤其是第三点如果你既想用本地 Ollama 的 qwen2.5又想随时切换到云端更强的模型没有一个统一的 Key 管理入口会非常痛苦。这篇教程面向 Windows 10/11 用户从零跑通 OpenClaw Ollama 本地模型同时接入 TaoToken 统一 Key 通道让你在本地模型和 OpenAI-compatible 云端接口之间自由切换。全程可复制配置骨架直接给踩过的坑我也会标出来。2. 前置准备NodeJs、Ollama 与 TaoToken 统一 Key2.1 NodeJs 环境检查OpenClaw 依赖 NodeJs 20 以上版本。打开 PowerShell输入node -v如果输出v20.x.x或更高就没问题。低于 20 的话去 NodeJs 官网下载 LTS 版本安装安装时勾选“Add to PATH”。2.2 安装 Ollama 并拉取模型Ollama 是本地模型运行环境下载 Windows 安装包后一路下一步即可。安装完成后验证ollama -v然后拉取 qwen2.5:7bollama pull qwen2.5:7b这个模型默认上下文只有 8k 左右对于 OpenClaw 处理长文档、多轮对话来说不够用。我们需要扩容到 32k。2.3 模型上下文扩容在用户目录下创建一个 Modelfilecd C:\Users\你的用户名 FROM qwen2.5:7b PARAMETER num_ctx 32768 | Out-File -Encoding ascii Modelfile ollama create qwen2.5:7b-32k -f Modelfile执行完后用ollama list应该能看到qwen2.5:7b-32k。2.4 TaoToken 统一 Key 的作用TaoToken 在这里扮演的是“统一 API 通道”的角色。你可以用它生成一个 Key然后在 OpenClaw 里配置 OpenAI-compatible 接口这样无论是本地 Ollama 还是云端模型都走同一套配置格式。对于需要频繁切换模型的场景这比每次改 base_url 和 key 要省事得多。注册和获取 Key 的入口在官网API 地址是https://taotoken.net/api。拿到 Key 后先放着后面配置会用到。3. 可复制配置OpenClaw 安装与 config.toml / settings.json 骨架3.1 安装 OpenClawnpm install -g openclaw openclaw onboard向导会依次问你几个关键项按下面填配置项填写内容Model/auth providerCustom ProviderAPI Base URLhttp://127.0.0.1:11434/v1本地 OllamaAPI Keyollama不能留空随便填一个字符串Endpoint compatibilityOpenAI-compatibleModel IDqwen2.5:7b-32k通讯渠道、技能等选项全部选Skip for now或No。3.2 config.toml 骨架OpenClaw 的配置文件通常在~/.openclaw/config.tomlWindows 下是C:\Users\用户名\.openclaw\config.toml。一个可用的骨架如下[gateway] port 18789 host 127.0.0.1 [model] provider custom base_url http://127.0.0.1:11434/v1 api_key ollama model_id qwen2.5:7b-32k compatibility openai [model.fallback] # 当本地模型不可用时走 TaoToken 统一通道 base_url https://taotoken.net/api/v1 api_key 你的TaoToken Key model_id gpt-4o-mini compatibility openai注意fallback段是可选的。如果你只想跑本地模型可以删掉。但加上它之后本地 Ollama 没启动时 OpenClaw 会自动切到云端不会直接报错。3.3 settings.json 补充配置部分版本的 OpenClaw 会用settings.json管理运行时参数{ gateway: { port: 18789, token_required: true }, model: { timeout: 120, max_retries: 2, stream: true }, skills: { auto_load: true, directory: ~/.openclaw/skills } }3.4 CC Switch 切换步骤如果你装了 CC Switch一个模型切换工具可以这样配置cc-switch add local-ollama --base-url http://127.0.0.1:11434/v1 --api-key ollama --model qwen2.5:7b-32k cc-switch add taotoken-cloud --base-url https://taotoken.net/api/v1 --api-key 你的Key --model gpt-4o-mini cc-switch use local-ollama切换时只需cc-switch use taotoken-cloudOpenClaw 下次请求就会走 TaoToken 通道。4. 验证请求一次对话跑通全链路4.1 启动 OpenClawopenclaw start看到Gateway running on http://127.0.0.1:18789就说明起来了。4.2 生成访问令牌openclaw token generate复制输出的令牌浏览器打开http://127.0.0.1:18789粘贴令牌登录。4.3 发一条测试消息在控制台对话框输入你好请用一句话介绍你自己并告诉我你当前使用的模型名称。如果配置正确你会看到类似回复我是运行在本地 OpenClaw 上的 AI 助手当前使用的模型是 qwen2.5:7b-32k。4.4 验证 TaoToken 通道把 config.toml 里的[model]段临时改成 fallback 的内容或者用 CC Switch 切到taotoken-cloud重启 OpenClaw 后再发一条消息。如果也能正常回复说明统一 Key 通道打通了。4.5 用 curl 直接验证接口不想开浏览器的话可以直接用 curl 测curl http://127.0.0.1:11434/v1/chat/completions -H Content-Type: application/json -H Authorization: Bearer ollama -d {model:qwen2.5:7b-32k,messages:[{role:user,content:test}]}返回 JSON 里有choices字段就说明 Ollama 的 OpenAI-compatible 接口正常。5. 本篇常见错排查5.1 NodeJs 版本过低导致安装失败报错关键词EBADENGINE或Unsupported engine。解决方法是升级到 NodeJs 20然后删掉node_modules重装。5.2 Ollama 端口被占用报错bind: address already in use。检查 11434 端口netstat -ano | findstr 11434如果有其他进程占用要么杀掉它要么改 Ollama 的监听端口环境变量OLLAMA_HOST。5.3 API Key 留空导致 401OpenClaw 向导里 API Key 不能留空即使本地 Ollama 不校验也要填一个占位符。填ollama就行。5.4 模型 ID 写错导致 404如果你拉的是qwen2.5:7b但配置里写qwen2.5:7b-32k而扩容步骤没执行成功就会报model not found。用ollama list确认模型名。5.5 上下文超限报错报错context length exceeded。说明 num_ctx 没生效。重新执行 Modelfile 创建步骤注意Out-File -Encoding ascii不能省否则 Windows 默认 UTF-16 会导致 Ollama 解析失败。5.6 TaoToken 通道 403检查 Key 是否复制完整、base_url 是否写成https://taotoken.net/api/v1注意结尾的/v1。如果还不行去控制台确认 Key 状态。6. 接入文档与模型对话入口本地跑通之后下一步就是让它真正干活。你可以先装几个核心技能openclaw skills install tavily-search openclaw skills install summarize openclaw skills install file-organizer技能装好后在控制台里直接下指令比如“帮我整理 Downloads 文件夹里的 PDF”。如果你需要长期编码或跑 Agent 任务建议用 Coding Plan 模式把模型切换和 Key 管理交给 TaoToken 统一处理省得每次手动改配置。接入文档与 API Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite模型对话测试入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite长期编码与 Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite遇到配置报错时优先看openclaw doctor的输出它会直接告诉你哪个环节断了。
