【openClaw本地部署】Windows系统本地部署+连接本地ollama完整指南：TaoToken统一Key接入配置

1. Windows 本地跑 openClaw 到底卡在哪openClaw 是一个能在本地电脑上执行操作的 AI Agent 框架你可以把它理解成一个「住在你电脑里的助手」——它能读写文件、开浏览器、跑定时任务而模型可以走云端也可以走本地。适合谁适合想在 Windows 上折腾本地 AI 工具链、又不想把数据全丢给云端的开发者。但真正动手你会发现卡人的从来不是安装本身而是三件事Node.js 版本不对、ollama 模型上下文不够、以及多工具调用时 Key 和 API 通道乱成一锅粥。我这次把整条链路重新捋了一遍Windows 装 Node.js → 装 openClaw → 起 gateway → 拉 ollama 本地模型 → 用 TaoToken 统一 Key 接管云端通道 → 验证连通。重点放在「多工具调用时的 Key 与 API 通道配置」上因为 openClaw 一旦同时挂本地 ollama 和云端模型配置文件里那几行写错就是 401 或者模型不响应。先说结论本地 ollama 负责隐私和离线TaoToken 统一 Key 负责云端模型和 coding 场景的稳定通道两者在 openClaw 里可以共存。下面每一步都给可复制的命令和配置骨架你照着敲基本能一次跑通。2. 前置准备Node.js、ollama 与 TaoToken 统一 Key2.1 Node.js 版本是硬门槛openClaw 要求 Node.js 大于 18.0npm 大于 8。先在 CMD 里验证node --version npm --version如果低于 v18去 Node.js 官网下 LTS 版本重装。装完记得关掉所有终端重开否则 PATH 不刷新node还是旧版本。这一步踩过坑的人特别多明明装了新版却一直报版本不够就是终端没重启。2.2 安装 openClaw 三选一CMD 方式推荐最省事curl -fsSL https://openclaw.ai/install.cmd -o install.cmd install.cmd del install.cmdPowerShell 方式iwr -useb https://openclaw.ai/install.ps1 | iexNPM 方式需要先装 pnpmnpm install -g pnpm npm install -g openclaw装完验证openclaw --version能打印版本号就说明装好了。如果提示openclaw 不是内部或外部命令说明全局 bin 目录没进 PATH重开终端或者手动把 npm 全局路径加进去。2.3 为什么需要 TaoToken 统一 KeyopenClaw 的配置向导里会让你选模型 provider支持千问、kimi 等云端模型每个都要单独去官网注册拿 Key。工具一多Key 就散落在各处切换模型时改配置改到崩溃。TaoToken 的作用是把这些云端模型的调用收敛到一个统一 Key 和统一 API 通道上openClaw 里只配一次后面换模型只改 model id 就行。TaoToken 官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。先去控制台建一个 Key后面配置里要用。3. 可复制配置settings.json 与 config.toml 骨架openClaw 的配置分两块一块是它自己的 settings.json管 gateway、权限、工具另一块是模型通道的 config.toml管 provider 和 Key。下面给的是能直接抄的骨架你按自己路径改。3.1 settings.json 骨架位置一般在用户目录下的.openclaw/settings.json。核心字段{ gateway: { port: 18789, host: 127.0.0.1 }, tools: { profile: full }, agents: { defaults: { sandbox: { workspaceAccess: rw } } }, models: { default: qwen3:8b-32kb, providers: { local-ollama: { type: openai-compatible, baseUrl: http://127.0.0.1:11434/v1, apiKey: ollama }, taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api/v1, apiKey: 你的_TaoToken_Key } } } }这里tools.profile设成full是给 openClaw 操作本地电脑的权限workspaceAccess设成rw是文件读写权限。注意这两个权限开了之后Agent 理论上能改你本地文件自己评估风险别在生产机上乱开。3.2 config.toml 骨架如果你走的是 config.toml 那套部分版本用 TOML 管 provider骨架长这样[gateway] port 18789 host 127.0.0.1 [models] default qwen3:8b-32kb [models.providers.local-ollama] type openai-compatible base_url http://127.0.0.1:11434/v1 api_key ollama [models.providers.taotoken] type openai-compatible base_url https://taotoken.net/api/v1 api_key 你的_TaoToken_Key [tools] profile full [agents.defaults.sandbox] workspace_access rw两个文件二选一即可看你装的版本读哪个。改完配置一定要重启 gateway否则不生效。3.3 权限配置命令不想手改文件的话openClaw 提供了命令行方式openclaw config set tools.profile full openclaw config set agents.defaults.sandbox.workspaceAccess rw openclaw gateway restart这三条执行完权限就到位了。4. 启动 ollama 并验证 openClaw 连通性4.1 拉本地模型去 ollama 官网下 Windows 安装包装完在 CMD 里拉模型ollama pull qwen3:8b ollama listollama list里能看到qwen3:8b就说明拉取成功。这里有个大坑别拉 deepseek 的模型目前 openClaw 对 deepseek 系列支持有问题老老实实用 qwen3:8b 或者 qwen2.5:7b这两个实测可用。4.2 创建 32K 上下文模型openClaw 默认要求至少 16000 tokens 上下文而 ollama 默认的 qwen3:8b 上下文不够。需要建一个自定义 ModelfileFROM qwen3:8b PARAMETER num_ctx 32768保存成Modelfile然后ollama create qwen3:8b-32kb -f Modelfile再ollama list确认qwen3:8b-32kb出现了。这一步不做的话openClaw 连上 ollama 也会因为上下文不足报错或者直接不响应。4.3 启动 gateway 并验证openclaw gateway start或者指定端口openclaw gateway --port 18789启动后浏览器打开http://127.0.0.1:18789如果配置向导跑过它会带一个#tokenxxxxxxx的链接这个 token 要留着后面 401 排查全靠它。验证 ollama 通道是否通curl http://127.0.0.1:11434/v1/models能返回模型列表就说明 ollama 的 OpenAI 兼容接口正常。再验证 TaoToken 通道curl https://taotoken.net/api/v1/models -H Authorization: Bearer 你的_TaoToken_Key返回模型列表说明统一 Key 通道没问题。两个通道都通openClaw 里配的 provider 才能正常调用。4.4 跑一次配置向导openclaw onboard向导里几个关键选项免责声明选 YESOnboarding mode 选 QuickStartModel/auth provider 选 Custom Provider列表最后一项然后填 Model ID 为qwen3:8b-32kbAPI Key 随便填本地模型不需要Select channel 可以 Skip for nowConfigure skills 可以 Skip for now向导可以反复跑跑错了没后果大胆试。5. 本篇常见错排查5.1 HTTP 401: Invalid Authentication最常见。大概率是 token 没写或者写错。打开http://127.0.0.1:18789在概览-网关令牌里把配置向导自动打开那个链接后面的 token 填进去点连接。如果是 TaoToken 通道报 401检查apiKey字段是不是把 Key 复制全了有没有多余空格。5.2 openClaw 不能操作本地电脑权限没配。执行openclaw config set tools.profile full openclaw config set agents.defaults.sandbox.workspaceAccess rw openclaw gateway restart重启后新开一个会话再试。5.3 ollama 连上了但模型不响应九成是上下文不够。确认你用的是ollama create出来的 32K 版本而不是原始的qwen3:8b。在 openClaw 里 Model ID 要填qwen3:8b-32kb填错成qwen3:8b就会卡住。5.4 端口被占用openclaw gateway start报端口占用换个端口openclaw gateway --port 18790同时把 settings.json 里的gateway.port也改成一致。5.5 多工具调用时 Key 冲突如果你同时配了本地 ollama 和 TaoTokenopenClaw 默认走models.default指定的那个。想切云端模型把default改成taotoken对应的 model id或者直接在会话里指定 provider。别在两个 provider 里填同一个 Key本地 ollama 的 apiKey 填ollama占位就行。6. 通道分工与后续接入本地 ollama 适合隐私敏感、离线场景但 8B 模型跑复杂任务确实吃力读个本地 Excel 显卡能烧半天。云端通道适合需要更强模型或者长期 coding、Agent 任务的场景。TaoToken 在这里的价值是把云端模型的 Key 和 API 通道统一掉openClaw 里只维护一份配置。如果你主要做排障和接入先去 API Keys 页面建 Key再对照接入文档把 baseUrl 和 model id 填对API Keys 在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。想先验证模型通不通用模型对话页面直接测https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。长期跑编码和 Agent 任务的话Coding Plan 更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。最后留个实操建议配置改完先openclaw gateway restart再用 curl 分别打本地和云端两个/v1/models接口两个都返回列表了再去跑 Agent 任务。这样能把「配置错」和「模型错」分开定位省得在一堆报错里瞎猜。