1. Win10 上从零跑通 OpenClaw 的真实卡点OpenClaw 是一个能在本地跑起来、并且可以挂载工具集与技能skills的智能体运行框架适合想在 Windows 上做本地 Agent 实验、又不想被各种模型 Key 分散管理的开发者。这篇面向的是在 Win10 上从零搭建 OpenClaw 的人先用 choco 把依赖装齐再用 git 拉源码接着用 ollama 跑本地模型最后用 TaoToken 的统一 Key 和 API 通道接管模型调用。整套流程走完你会有两个配置文件骨架settings.json 与 config.toml、一组环境变量写法以及一次真实对话请求来验证通道是否生效。我试过在纯净的 Win10 上重装一遍最容易翻车的不是 OpenClaw 本身而是三件事PowerShell 执行策略拦脚本、npm 默认源太慢导致安装卡死、以及模型调用地址散落在多个地方改起来头大。前两个属于环境问题第三个才是真正影响长期使用的点——当你想在本地 ollama 和云端模型之间切换时如果每个工具都各配一份 Key维护成本会迅速上升。所以这篇的重点不只是“装完能跑”而是把模型调用收敛到一条统一通道上。下面按顺序来先装 choco、git、ollama 三个前置再拉 OpenClaw 源码并配置然后接入 TaoToken 统一 Key最后用一次请求验证。每一步都给可复制的命令和配置遇到报错直接对照第 5 节排查。2. 前置依赖choco、git、ollama 三件套2.1 用 choco 装依赖Chocolatey 是 Windows 上的包管理器装好之后很多依赖一条命令就能搞定。以管理员身份打开 PowerShell先放开当前进程的执行策略再执行官方安装脚本Set-ExecutionPolicy Bypass -Scope Process -Force [System.Net.ServicePointManager]::SecurityProtocol [System.Net.ServicePointManager]::SecurityProtocol -bor 3072 iex ((New-Object System.Net.WebClient).DownloadString(https://community.chocolatey.org/install.ps1))装完验证一下版本能打印出来就说明 choco 可用了choco --version注意Set-ExecutionPolicy Bypass -Scope Process只影响当前这个 PowerShell 窗口关掉就恢复不会改动系统全局策略属于比较稳妥的做法。2.2 安装 git 与 ollamagit 可以直接用 choco 装也可以自己下安装包这里给 choco 的写法choco install git -y git --versionollama 同样可以自行安装装完后确认服务在跑ollama --version ollama listollama list如果返回空列表也没关系说明服务通了只是还没拉模型。本地模型按需拉一个轻量的即可比如ollama pull qwen2.5:7b2.3 配置 npm 镜像并安装 OpenClawOpenClaw 的安装脚本依赖 npm国内直连默认源经常超时先换成镜像源再装npm config set registry https://registry.npmmirror.com iwr -useb https://openclaw.ai/install.ps1 | iex装完后确认命令可用openclaw --version到这里三件套加 OpenClaw 本体就齐了。接下来是本文的核心把模型调用统一到 TaoToken 通道上。3. 接入 TaoToken 统一 Key 与 API 通道3.1 为什么要在 OpenClaw 里做统一通道OpenClaw 支持本地 ollama 模型也支持云端模型。问题在于如果你同时用多个模型供应商每个都要单独配 Key、单独记 base_url切换时改配置很容易漏。TaoToken 提供的是统一的 Key 和 API 通道把模型调用收敛到一个入口OpenClaw 里只需要指向这一个地址换模型时改模型名就行不用动 Key。TaoToken 官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。先去控制台生成一个 API Key后面配置里会用到。3.2 环境变量写法推荐把 Key 放进环境变量而不是硬编码进配置文件这样换机器或换 Key 时只改一处。在 PowerShell 里设置当前用户级环境变量[Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, 你的Key, User) [Environment]::SetEnvironmentVariable(TAOTOKEN_BASE_URL, https://taotoken.net/api, User)设置完重开一个 PowerShell 窗口让它生效验证一下echo $env:TAOTOKEN_API_KEY echo $env:TAOTOKEN_BASE_URL注意SetEnvironmentVariable写入的是用户级变量不会污染系统级配置也不需要管理员权限。3.3 settings.json 可复制骨架OpenClaw 的模型相关配置放在 settings.json 里下面是一个可直接改用的骨架把模型调用指向 TaoToken 通道{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, model: glm-4.7, timeout: 60000 }, tools: { profile: full } }几个字段说明provider用 openai-compatible 是因为 TaoToken 走的是兼容协议apiKeyEnv指向刚才设的环境变量名避免明文写 Keymodel换成你要用的模型名即可tools.profile设为 full 会启用命令执行等完整工具集。3.4 config.toml 可复制骨架如果你更习惯 TOML 风格或者 OpenClaw 的某些子命令读的是 config.toml可以用下面这份[model] provider openai-compatible base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY model glm-4.7 timeout 60000 [tools] profile full两份配置的语义是一致的选一份你实际用到的即可。改完配置后用 OpenClaw 的 config 命令确认一下工具集已生效openclaw config set tools.profile full4. 验证请求一次对话确认通道生效配置写完不算数得发一次真实请求看返回。先启动服务再发一条对话ollama launch openclaw如果你想让 OpenClaw 直接走 TaoToken 通道而不是本地 ollama用配置启动ollama launch openclaw --config然后发一条最简单的对话请求观察返回内容是否正常openclaw chat 用一句话说明你现在用的是哪个模型通道如果返回里能看到模型正常应答并且没有报鉴权错误说明 TaoToken 通道已经接管了模型调用。你也可以在 TaoToken 控制台看调用记录确认请求确实打到了统一通道上。想验证模型切换是否顺畅把 settings.json 里的model字段改成另一个模型名重启服务再发一次请求如果不用改 Key 就能切换成功说明统一通道的价值就体现出来了。5. 本篇常见报错排查5.1 安装脚本被拦截报错类似“无法加载文件因为在此系统上禁止运行脚本”这是执行策略问题。回到 2.1 节用Set-ExecutionPolicy Bypass -Scope Process -Force在当前窗口放开即可不要图省事改成全局 Unrestricted。5.2 npm 安装卡住或超时多半是源的问题。确认镜像源已切换npm config get registry如果不是https://registry.npmmirror.com重新执行 2.3 节的设置命令。切换后清一下缓存再装npm cache clean --force5.3 模型调用返回 401 或鉴权失败先确认环境变量在当前窗口能打印出来。如果打印为空说明变量没生效重开窗口或重新设置。如果变量正常但仍报鉴权失败检查 settings.json 里的apiKeyEnv拼写是否和实际变量名一致大小写敏感。5.4 请求打到了本地 ollama 而不是 TaoToken检查启动命令。ollama launch openclaw默认可能走本地模型要让它读配置走统一通道用ollama launch openclaw --config。另外确认 settings.json 里的baseUrl是https://taotoken.net/api没有多余斜杠或拼错。5.5 工具集没生效如果发现命令执行等能力不可用确认tools.profile已设为 full并重新执行一次openclaw config set tools.profile full然后重启服务。6. 后续怎么用得更顺装完之后日常最常做的两件事是切模型和加技能。切模型只改 settings.json 里的model字段Key 和地址都不用动这就是统一通道省心的地方。加技能可以用 clawhub先登录再安装clawhub login --token 你的cli_token clawhub whoami clawhub install tavily-searchcli_token在 clawhub 个人中心生成clawhub whoami能返回身份就说明登录成功。技能装完后重启 OpenClaw 服务即可加载。如果你打算长期在本地做编码或 Agent 实验建议把模型调用稳定挂在 TaoToken 通道上再按需在本地 ollama 和云端模型之间切换。需要生成和管理 Key 就去 API Keys 页面 https://taotoken.net/console/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 。长期跑编码任务的话Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 会更合适。