1. Windows 下 OpenClaw 接入 deepseek 到底难在哪如果你最近在折腾 OpenClaw 接入 deepseek 的 Windows 安装大概率会遇到这么几个卡点PowerShell 权限不够导致脚本跑一半断掉、Node.js 版本低于 22.14 直接报错、onboard 向导填完 Key 却连不上模型、Gateway 起来了但浏览器打不开控制台。这些问题单独看都不复杂凑在一起就很容易让人在第一步就放弃。OpenClaw 本质上是一个本地运行的 AI Agent 调度壳它自己不带模型能力需要你给它配一个模型提供商的 API Key 才能真正干活。deepseek 因为价格便宜、中文理解好是很多人首选的对接对象。但 Windows 环境和 Linux/macOS 不一样PowerShell 的执行策略、PATH 环境变量、npm 全局路径这些细节都会影响安装成功率。这篇内容面向的是在 Windows 上第一次部署 OpenClaw 的读者假设你会用 PowerShell 但不算精通跟着步骤能一次跑通。我会把 PowerShell 权限设置、Node.js 版本校验、TaoToken 统一 Key 配置、连通性验证这几块拆开讲清楚每一步都给可复制的命令和预期输出。实测下来整个流程大约 20 分钟其中大部分时间花在等 npm 安装和下载依赖上。需要提前说明一点OpenClaw 的版本迭代比较快onboard 向导的界面可能和你看到的略有差异但核心逻辑不变——选提供商、填 Key、选模型、定工作区。只要这四步对了后面就能正常用。另外很多人在配置模型这一步会纠结用哪家的 Key。我的建议是如果你只是本地测试和日常使用用 TaoToken 的统一 Key 会更省事一个 Key 可以切换多个模型不用在 deepseek、通义、智谱之间来回注册。下面会具体讲怎么配。2. TaoToken 前置准备与 Node.js 版本校验在装 OpenClaw 之前先把运行环境和模型 Key 这两件事搞定。顺序不能反否则 onboard 向导走到填 Key 那一步会卡住。2.1 PowerShell 权限与执行策略Windows 默认的 PowerShell 执行策略是 Restricted直接跑安装脚本会被拦。你需要用管理员身份打开终端然后改执行策略。右键任务栏的 Windows 图标选择「终端管理员」弹窗点「是」。然后输入Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser回车后会问你是否确认输入Y回车。这条命令只对当前用户生效不会影响系统其他账户相对安全。验证一下Get-ExecutionPolicy -Scope CurrentUser输出应该是RemoteSigned。如果还是Restricted说明你开的不是管理员终端关掉重开。注意不要用-ExecutionPolicy Bypass全局绕过那样任何脚本都能跑风险太高。RemoteSigned 只允许本地脚本和签名脚本执行够用了。2.2 Node.js 版本校验OpenClaw 要求 Node.js ≥ 22.14推荐 24.x。先检查你当前的版本node --version npm --version如果 node 输出v22.14.0以下或者提示「不是内部命令」就需要重装。去 nodejs.org 下载 LTS 版本的.msi安装包一路 Next 默认安装。装完后必须关闭当前终端重新开一个新的 PowerShell否则 PATH 不会刷新。重新验证node --version # 预期输出v24.x.x npm --version # 预期输出11.x.x版本对了之后顺手把 npm 的全局路径确认一下后面排查「openclaw 不是内部命令」会用到npm config get prefix记下这个路径通常是C:\Users\你的用户名\AppData\Roaming\npm。2.3 TaoToken 统一 Key 配置OpenClaw 的模型配置支持自定义 Base URL这意味着你可以把请求指向 TaoToken 的 API 网关用一个 Key 调用 deepseek 等多个模型。先去 TaoToken 控制台创建一个 API Key。地址是https://taotoken.net/api-keys登录后点「创建 Key」复制保存好格式类似sk-xxxxxxxx。然后确认你要用的模型 ID。TaoToken 的模型列表在文档里能查到deepseek 系列常用的有模型 ID适用场景特点deepseek-chat日常对话、写作、分析速度快、便宜deepseek-reasoner复杂推理、编程、数学深度思考、准确率高Base URL 填https://taotoken.net/api注意不要加 UTM 参数那是给网页链接用的API 请求不需要。如果你还没注册 TaoToken可以先通过官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content了解一下注册后新用户有赠送额度测试够用。2.4 安装 OpenClaw环境准备好后在管理员 PowerShell 里跑安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex这个脚本会自动检测系统、校验 Node 版本、通过 npm 全局安装 OpenClaw。安装过程大约 2-5 分钟取决于网速。完成后验证openclaw --version # 预期输出OpenClaw 2026.x.x (xxxxxxx)如果报「openclaw 不是内部命令」说明 npm 全局路径没在 PATH 里。回到 2.2 步记下的 prefix 路径把它加到系统环境变量 Path 中然后重开终端。3. 可复制的 OpenClaw 配置文件与 onboard 参数OpenClaw 的配置有两种方式一种是跑openclaw onboard向导交互式填写另一种是直接改配置文件。向导适合第一次用配置文件适合批量部署和版本管理。这一节把两种方式都给出来你可以按需选。3.1 onboard 向导的完整参数在管理员 PowerShell 里运行openclaw onboard --install-daemon--install-daemon会把 Gateway 注册为 Windows 后台服务开机自启省得每次手动启动。向导会依次问四个问题第一步选模型提供商用方向键选「Custom」或「OpenAI Compatible」因为 TaoToken 走的是 OpenAI 兼容协议。第二步填 Base URL输入https://taotoken.net/api第三步填 API Key粘贴你从 TaoToken 控制台复制的sk-开头的 Key。第四步选默认模型输入deepseek-chat或deepseek-reasoner。第五步选工作区路径直接回车用默认的C:\Users\你的用户名\.openclaw\workspace。向导跑完后重启 Gateway 让配置生效openclaw gateway restart3.2 直接编辑配置文件如果你更喜欢手动改配置OpenClaw 的主配置文件在C:\Users\你的用户名\.openclaw\config.json。用 VSCode 或记事本打开填入以下内容{ gateway: { port: 18789, host: 127.0.0.1 }, models: { default: deepseek-chat, providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key粘贴在这里, models: [ deepseek-chat, deepseek-reasoner ] } } }, workspace: C:\\Users\\你的用户名\\.openclaw\\workspace }注意 JSON 里的反斜杠要转义写成\\。apiKey 字段填你实际的 Key。保存后重启 Gatewayopenclaw gateway restart3.3 环境变量方式适合多环境切换如果你需要在不同项目间切换 Key可以用环境变量。在 PowerShell 里临时设置$env:OPENCLAW_API_KEYsk-你的Key $env:OPENCLAW_BASE_URLhttps://taotoken.net/api $env:OPENCLAW_MODELdeepseek-chat这种方式只在当前终端会话有效关掉就没了。要永久生效用系统环境变量界面添加或者写进 PowerShell 的 profile 文件。3.4 工作区核心文件OpenClaw 启动后会读取工作区里的几个 Markdown 文件来了解你的偏好。建议至少创建这三个AGENTS.md写行为守则比如「不要删除文件用回收站替代」「对外发消息前必须问我」。SOUL.md写 AI 的说话风格比如「干脆利落不要客套话」。USER.md写你的基本信息比如称呼、时区、常用工具。这三个文件不需要很复杂几行字就够。写得越清楚AI 越贴合你的习惯。4. 验证请求与成功结果确认配置写完了不代表能跑通必须做连通性验证。这一节给三个层次的验证方法从简单到完整。4.1 检查 Gateway 状态openclaw gateway status预期输出类似Gateway is running on http://127.0.0.1:18789 Uptime: 2 minutes Models loaded: deepseek-chat, deepseek-reasoner如果显示Gateway is not running先跑openclaw gateway start再看状态。4.2 用 curl 直接测 API 连通性在 PowerShell 里用 curl 测一下 TaoToken 的接口能不能通curl -X POST https://taotoken.net/api/v1/chat/completions -H Content-Type: application/json -H Authorization: Bearer sk-你的Key -d {\model\:\deepseek-chat\,\messages\:[{\role\:\user\,\content\:\你好\}]}注意 PowerShell 里 curl 是Invoke-WebRequest的别名参数格式和 Linux 不一样。如果上面命令报错改用$body { model deepseek-chat messages ({roleuser; content你好}) } | ConvertTo-Json Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers {AuthorizationBearer sk-你的Key; Content-Typeapplication/json} -Body $body如果返回里有choices字段和模型回复内容说明 Key 和 Base URL 都对了。4.3 在 OpenClaw 控制台发消息打开浏览器访问http://127.0.0.1:18789这是 OpenClaw 的 Web 控制台。在输入框里发一条「你好介绍一下你自己」如果几秒内收到回复说明整条链路通了。你也可以用命令行打开控制台openclaw dashboard这会自动在默认浏览器里打开控制台页面。4.4 验证模型切换在控制台里试试切换模型。发一条需要推理的问题比如「9.11 和 9.9 哪个大」然后看回复。如果用的是deepseek-reasoner回复里会带推理过程用deepseek-chat则直接给答案。如果切换模型后报model not found检查配置文件里的模型 ID 是否和 TaoToken 文档一致大小写敏感。5. 本篇常见报错排查这一节把安装和配置过程中最容易遇到的报错列出来对照着排查。5.1 401 Unauthorized报错信息Error: 401 Unauthorized - Invalid API key原因通常是 Key 填错了、Key 过期了、或者 Base URL 和 Key 不匹配。检查三件事Key 是不是从 TaoToken 控制台复制的完整字符串有没有多余空格Base URL 是不是https://taotoken.net/api不要带路径后缀Key 对应的账户有没有余额。5.2 local proxy failed / connection refused报错信息Error: connect ECONNREFUSED 127.0.0.1:18789这是 Gateway 没起来。先跑openclaw gateway status确认如果是 stopped跑openclaw gateway start。如果启动失败跑openclaw doctor看具体原因。常见的是端口 18789 被占用用netstat -ano | findstr 18789找到占用进程关掉或者改配置里的端口。5.3 reading choices 报错报错信息TypeError: Cannot read properties of undefined (reading choices)这说明 API 返回的结构不对通常是 Base URL 写错了。比如写成了https://taotoken.net/api/v1多了一层路径。正确的应该是https://taotoken.net/apiOpenClaw 会自动拼接/v1/chat/completions。5.4 OAuth 相关报错报错信息Error: OAuth token expired如果你用的是 OAuth 方式登录的模型提供商token 会定期过期。OpenClaw 里如果用 API Key 方式就不会有这个问题。检查配置文件里type字段是不是openai-compatible而不是oauth。5.5 spawn git ENOENT报错信息Error: spawn git ENOENT这是没装 Git 或者 Git 没在 PATH 里。去 git-scm.com 下载安装装完后重开终端验证git --version能输出版本号。5.6 openclaw 不是内部命令这个前面提过是 npm 全局路径没在 PATH 里。用npm config get prefix找到路径加到系统环境变量 Path 中重开终端。5.7 Gateway 启动后浏览器打不开先确认 Gateway 状态是 running然后检查防火墙有没有拦 18789 端口。Windows Defender 防火墙有时候会拦本地回环以外的请求但 127.0.0.1 一般不受影响。如果还是打不开试试http://localhost:18789而不是 IP。6. 长期使用建议与资源入口跑通之后日常使用其实就两条命令openclaw gateway status确认在跑openclaw dashboard打开控制台。但如果你打算长期用有几个点值得注意。第一Key 的管理。如果你同时用多个模型提供商建议统一走 TaoToken 的 Key这样切换模型只需要改配置里的模型 ID不用换 Key。TaoToken 的模型对话入口在https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content可以在网页上先测试模型效果再决定配哪个到 OpenClaw。第二工作区的维护。MEMORY.md是 AI 自己维护的长期记忆文件会随着使用越来越长。定期清理过时内容能让 AI 的回复更聚焦。memory/目录下的每日日志可以保留方便回溯。第三升级和备份。升级用npm update -g openclaw升级前建议备份C:\Users\你的用户名\.openclaw\整个目录尤其是 config.json 和 workspace。卸载用npm uninstall -g openclaw但用户数据不会自动删需要手动清理。如果你打算把 OpenClaw 用于日常编码或者跑 Agent 任务可以考虑 TaoToken 的 Coding Plan地址是https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content相比按量计费更适合高频调用场景。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里面有各语言的调用示例和模型列表配置遇到不确定的地方可以对照查。最后说一个实际经验OpenClaw 的 onboard 向导在填 Key 那一步粘贴后不会显示明文只显示星号。如果你不确定有没有粘对可以先粘到记事本里检查一遍再复制过去。这个细节看起来小但 401 报错里有一半是粘贴时带了换行或者空格导致的。