1. OpenClaw 在 Windows PowerShell 下的真实安装场景OpenClaw 是一个可以跑在本地的智能体框架能对接 Ollama 本地模型也能通过统一 API 通道调用云端模型。它适合想在 Windows 上快速搭一个私有 AI 助手、又不想折腾 Linux 环境的人。但我在 PowerShell 里第一次装它的时候踩的坑比想象中多Node 版本不对、npm 全局路径没进 PATH、Ollama 模型上下文窗口太小、配置文件 JSON 语法错一个逗号就起不来。这些问题单独看都不难凑在一起就很容易让人放弃。这篇内容聚焦一条完整路径从零准备 node.js、npm、ollama 依赖到安装 OpenClaw再到接入 TaoToken 统一 Key/API 通道最后给出卸载清理步骤。全程用 Windows PowerShell 操作命令可以直接复制。如果你只想本地跑模型Ollama 部分照做即可如果你希望 OpenClaw 既能用本地模型、又能通过一个 Key 调用多家云端模型那 TaoToken 的配置骨架就是重点。先明确一个判断OpenClaw 本身不生产模型它是个调度层。你的模型来源可以是本地 Ollama也可以是远端 API。把这两条路都配通后面换模型、换供应商才不用重装。下面按顺序来每一步都有验证动作别跳步。2. 前置依赖node.js、npm、ollama 与 TaoToken 通道准备2.1 检查并安装 Node.js 与 npmOpenClaw 对 Node.js 版本有硬要求低于 18 会在安装阶段直接报unsupported Node version。我实测下来用 LTS 版本最稳。以管理员身份打开 PowerShell先看现状node --version npm --version Get-ExecutionPolicy如果node命令报错或版本低于 18去 Node.js 官网下载 LTS 安装包安装时务必勾选 “Add to PATH”。装完关掉 PowerShell 重开再验证一次。Get-ExecutionPolicy如果返回Restricted脚本会被拦执行Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force这一步不做后面npm install -g可能直接失败。2.2 安装 Ollama 并拉取基础模型Ollama 负责在本地跑模型。去 Ollama 官网下载 Windows 版安装后它会在后台常驻。验证ollama --version ollama pull qwen2.5:7bqwen2.5:7b约 4.7GB中文能力不错适合做 OpenClaw 的本地大脑。显存只有 4GB 的话可以换qwen2.5:4b但效果会打折。拉完后用ollama list确认模型在列表里。2.3 为什么还要准备 TaoToken 通道本地模型受限于显存和上下文窗口复杂任务容易力不从心。TaoToken 提供统一的 Key 和 API 通道让 OpenClaw 在不改架构的前提下调用云端模型。它的接入文档在https://taotoken.net/docAPI 基址是https://taotoken.net/api。你需要先去控制台创建一个 API Key路径是https://taotoken.net/consoleKey 管理在https://taotoken.net/api-keys。这个 Key 后面会写进 OpenClaw 的配置里作为云端模型的认证凭据。注意API Key 只显示一次创建后立刻复制保存。不要把它提交到任何公开仓库。3. 可复制配置安装 OpenClaw 并写入 settings.json 与 config.toml3.1 全局安装 OpenClaw在管理员 PowerShell 中执行npm install -g openclaw openclaw --version如果遇到EACCES权限错误不要用管理员强装改成用户目录方案mkdir ~/.npm-global npm config set prefix ~/.npm-global然后把C:\Users\你的用户名\.npm-global加进系统 PATH重开 PowerShell 再装。装完openclaw --version能输出版本号就说明命令可用。3.2 运行配置向导openclaw onboard向导里几个关键选择Provider 选 CustomBase URL 填http://127.0.0.1:11434/v1Model ID 填你创建的本地模型名。API Key 字段不能留空随便填ollama或123都行OpenClaw 需要这个字段有值才能过校验。配置成功后屏幕会显示Verification successful并给出 Web UI 地址通常是http://127.0.0.1:18789和管理员 Token务必保存。3.3 settings.json 骨架OpenClaw 的主配置目录在C:\Users\你的用户名\.openclaw\。settings.json用来放全局开关和通道定义骨架如下{ gateway: { port: 18789, host: 127.0.0.1 }, providers: { ollama-local: { type: openai-compatible, base_url: http://127.0.0.1:11434/v1, api_key: ollama, models: [qwen2.5:7b-32k] }, taotoken-cloud: { type: openai-compatible, base_url: https://taotoken.net/api, api_key: 你的_TaoToken_API_Key, models: [claude-sonnet-4-20250514] } }, default_provider: ollama-local }这里把本地 Ollama 和 TaoToken 云端通道并列定义default_provider决定默认走哪条。想切云端把默认值改成taotoken-cloud即可不用重装。3.4 config.toml 骨架部分 OpenClaw 版本用config.toml管理运行时参数和settings.json配合使用。骨架[gateway] port 18789 host 127.0.0.1 [model] provider ollama-local name qwen2.5:7b-32k context_window 32768 [model.fallback] provider taotoken-cloud name claude-sonnet-4-20250514 [logging] level infocontext_window必须和模型实际能力一致写小了会触发 “context window too small” 报错。fallback段是本地模型不可用时的兜底通道指向 TaoToken这样即使 Ollama 没启动OpenClaw 也不会完全哑掉。4. 验证请求从本地模型到 TaoToken 通道的连通测试4.1 创建高上下文窗口的本地模型Ollama 默认下载的模型上下文只有 4096OpenClaw 要求至少 16000。先建一个 32k 版本cd C:\Users\$env:USERNAME FROM qwen2.5:7b PARAMETER num_ctx 32768 | Out-File -Encoding ascii Modelfile ollama create qwen2.5:7b-32k -f Modelfile ollama listollama list里能看到qwen2.5:7b-32k就说明创建成功。再用ollama show qwen2.5:7b-32k --modelfile确认num_ctx是 32768。4.2 启动并访问 Web UIopenclaw status openclaw doctor --fix服务 running 后浏览器打开http://127.0.0.1:18789输入向导里保存的 Token 登录。发一条消息如果本地模型正常会看到回复。4.3 验证 TaoToken 通道想确认云端通道通不通可以在 OpenClaw 里临时把默认 provider 切到taotoken-cloud或者直接用 curl 测 APIcurl -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer 你的_TaoToken_API_Key -H Content-Type: application/json -d {\model\:\claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\ping\}]}返回里有choices字段就说明 Key 和通道都正常。这一步过了再把 OpenClaw 的 fallback 指向它本地和云端就都通了。模型对话的在线入口在https://taotoken.net/model-chat不想写代码时可以直接在网页里试模型。5. 本篇常见错排查安装、配置与运行时报错5.1 Node 版本不兼容或命令找不到现象是openclaw提示 command not found或安装时报unsupported Node version。先node --version确认版本低于 18 就重装 LTS。版本对但命令仍找不到说明 npm 全局路径没进 PATH。运行npm prefix -g拿到路径加进系统环境变量重开 PowerShell。5.2 npm 安装权限被拒EACCES错误不要用管理员强装。按 3.1 的用户目录方案配置npm config set prefix把对应绝对路径加进 PATH重开终端再装。5.3 模型上下文窗口过小报错Model context window too small (4096 tokens). Minimum is 16000。打开C:\Users\你的用户名\.openclaw\openclaw.json找到模型配置块把context_window从 4096 改成 32768保存后运行openclaw doctor --fix重启服务。5.4 模型不存在或调用失败model not found多半是配置里的 Model ID 和ollama list输出不一致。注意大小写和冒号重新运行openclaw configure --section model核对。同时确认 Ollama 在后台运行。5.5 API Key 认证失败对接 Ollama 时 API Key 字段不能空填任意非空字符。对接 TaoToken 时确认 Key 没有多余空格且请求头是Authorization: Bearer 你的Key。如果 Key 泄露或失效去https://taotoken.net/api-keys重新生成。5.6 Web UI 打不开或 Token 失效先openclaw status看服务是否 running不是就openclaw doctor --fix。端口不通的话检查 Windows 防火墙有没有放行 18789或者用openclaw config get gateway.port看实际端口。Token 失效就重新生成复制时别带空格。6. 卸载清理与后续接入建议6.1 卸载 OpenClawnpm uninstall -g openclaw Remove-Item -Recurse -Force C:\Users\$env:USERNAME\.openclaw第一条移除全局命令第二条清掉配置和缓存。如果之前改过 npm prefix配置目录在~/.npm-global下一并检查。6.2 卸载 Ollama 与清理模型Ollama 在 Windows 的卸载走“设置 应用 已安装的应用”找到 Ollama 卸载。模型文件默认在C:\Users\你的用户名\.ollama\models卸载后手动删掉这个目录能释放几个 GB。想保留模型以后重装就只删程序不删目录。6.3 长期编码与 Agent 场景的接入选择如果你只是偶尔跑一下对话本地 Ollama 加默认配置就够了。但如果要把 OpenClaw 当长期编码助手或 Agent 底座频繁调用云端模型建议走 Coding Plan 通道入口在https://taotoken.net/coding-plan。它的计费和配额更适合持续调用配合前面settings.json里的taotoken-cloud通道切换时只改default_provider一个字段。Claude Code 相关的接入细节在https://taotoken.net/ClaudeCodeAnthropic需要的话可以对照配置。整套流程走下来最花时间的其实是环境准备和第一次模型拉取。配置本身不难难在报错信息不直观。把openclaw logs follow开着出问题先看日志比盲目重装有效得多。