OpenClaw（龙虾）本地部署小白整理版：TaoToken 统一 Key 配置与 PowerShell 验证

1. 为什么要在 Windows 上折腾 OpenClaw 本地部署OpenClaw圈里人叫它“龙虾”是一个能在本地跑起来的 AI Agent 框架装好之后你可以用命令行或 Web UI 跟它对话、让它读写文件、跑技能脚本。它适合谁适合刚装完 Node.js、npm想在自己 Windows 电脑上跑一个本地 AI 助手又不想一上来就啃官方英文文档的小白。我自己第一次装的时候把配置搞乱了最后重装系统从头来所以这篇就是把我踩过的坑按顺序整理出来。核心检索词先摆在这OpenClaw 本地部署、PowerShell 验证、TaoToken 统一 Key、config.toml、settings.json。这篇不讲太多“为什么”重点讲“怎么做”——从环境确认、安装 OpenClaw、写入统一 Key到用 PowerShell 发一次请求验证连通性。目标很明确你照着敲完能跑通第一个本地调用。需要提前说清楚一件事OpenClaw 的模型接入环节官方默认会让你选各种 provider有些 provider 需要海外账号或者已经下线。与其一个个试不如用一个统一的 API 通道把 Key 管起来这样换模型只改一个地方。下面所有操作都在 Windows PowerShell 里完成不需要额外装别的东西。2. 前置准备Node.js、npm 与 TaoToken 统一 Key2.1 确认 Node.js 和 npm 可用先开一个 PowerShell 窗口把这三个命令敲一遍。我中间直接验证没过原因是装完没重开窗口环境变量没刷新所以记住装完 Node.js 和 Git 之后一定要重新开一个 PowerShell 窗口再验证。git --version node -v npm -v正常的话会分别输出类似git version 2.53.0.windows.2、v24.14.1、11.x.x这样的版本号。如果node或npm提示“不是内部或外部命令”八成是没重开窗口或者安装时没勾选加入 PATH。如果执行脚本时报权限错误可以先跑一次这个解锁脚本权限有没有用我不完全确定但跑了不亏Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser2.2 拿到 TaoToken 统一 KeyTaoToken 在这里的作用是当一个统一的 API 通道你只需要一个 Key就能在 OpenClaw 里切换不同模型不用为每个 provider 单独配一套凭证。对小白来说最大的好处是配置集中出问题好排查。先去官网注册并登录https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后进控制台创建 API Key入口在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建完把 Key 复制出来形如sk-开头的一长串。注意这个 Key 只显示一次先粘到记事本里存好。API 的基础地址是https://taotoken.net/api这个地址后面写配置要用到注意它不带任何查询参数。提示不要把 Key 直接写进会提交到 Git 的文件里。本地测试阶段可以先放配置文件但记得别把带 Key 的文件传到公开仓库。3. 安装 OpenClaw 并写入 config.toml 与 settings.json3.1 安装 OpenClaw用 npm 全局安装。版本号按你需要的来我这里用2026.3.28举例因为再往后的版本有些 provider 选项会变npm install -g openclaw2026.3.28网速好的时候很快网速慢就多等一会儿别中途 CtrlC。装完之后跑一次 onboard 进入配置向导openclaw onboard --install-daemon向导里会问一堆问题几个关键项这样选第一项确认个人使用选 YES。第二项 Setup mode 选 QuickStart。第三项 Model/auth provider 这里如果你之前配过旧 provider会先问你 Config handling配置乱了就选 Reset然后 Full reset 全重来。provider 按你实际能用的选选完会让你填对应 Key。后面几项里Select channel 选 Skip for nowSearch provider 选 Skip for nowConfigure skills now 选 YesInstall missing skill dependencies 里用空格键勾选clawhubPreferred node manager 选 npm。再往后那几个Set XXX_API_KEY的GOOGLE_PLACES、NOTION、OPENAI、ELEVENLABS全选 Nohooks 也选 Skip for now。最后 How do you want to hatch your bot 选 Open the Web UI让它自己把网页弹出来别手动开网址令牌会过不去。3.2 config.toml 骨架OpenClaw 的配置文件一般在用户目录下的.openclaw文件夹里。先确认路径echo $HOME Get-ChildItem $HOME\.openclaw找到config.toml后用下面这个骨架改。重点是base_url指向 TaoToken 的 API 地址api_key填你刚才复制的统一 Key# ~/.openclaw/config.toml [provider] name taotoken base_url https://taotoken.net/api api_key sk-你的TaoToken统一Key model claude-3-5-sonnet [gateway] host 127.0.0.1 port 8787 [log] level infomodel这一行按你实际想调的模型名填TaoToken 支持的模型可以在模型对话页面确认https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content3.3 settings.json 骨架有些版本还会读一个settings.json放在同一目录下。它和 config.toml 不冲突一个管 provider一个管运行时行为{ provider: taotoken, apiBase: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, timeoutMs: 60000, retry: { maxAttempts: 3, backoffMs: 1000 } }这里我把 Key 换成了环境变量TAOTOKEN_API_KEY比直接写明文安全一点。下面用 PowerShell 把这个环境变量写进去。4. 用 PowerShell 写入统一 Key 并做连通性验证4.1 写入环境变量在当前会话写入并持久化到用户级环境变量这样重开窗口也还在$env:TAOTOKEN_API_KEY sk-你的TaoToken统一Key [Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, $env:TAOTOKEN_API_KEY, User)验证一下写进去没有$env:TAOTOKEN_API_KEY.Substring(0,6)能打印出sk-xxx前几位就说明写成功了。4.2 发一次请求验证连通性用 PowerShell 的Invoke-RestMethod直接打 TaoToken 的接口确认 Key 和网络都通。这一步不依赖 OpenClaw能单独定位问题$headers { Authorization Bearer $env:TAOTOKEN_API_KEY Content-Type application/json } $body { model claude-3-5-sonnet messages ( { role user; content 只回复两个字通了 } ) } | ConvertTo-Json -Depth 5 $resp Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body $resp.choices[0].message.content如果返回类似“通了”的内容说明 Key、地址、网络三样都没问题。这时候再回到 OpenClaw 里跑一次对话基本就能出结果了。4.3 在 OpenClaw 里跑首个本地调用确认接口通之后启动 OpenClawopenclaw start然后在 Web UI 或命令行里发一句“你好”看它能不能正常回。如果接口验证通过但 OpenClaw 里报错多半是配置文件路径或字段名写错了回到第 3 节对着骨架检查。5. 本篇常见报错排查5.1 404 错误最常见的就是 404。我重装时怎么着都报 404最后发现是 provider 选项对应的模型已经下线了。解决办法换一个当前可用的模型或者直接用 TaoToken 统一通道把base_url指向https://taotoken.net/api模型名换成模型对话页面里列出的可用项。5.2 401 / 403 鉴权失败一般是 Key 没写对或者没生效。先跑 4.1 的验证命令确认环境变量写进去了再检查 config.toml 里的api_key有没有多余空格。如果用的是环境变量方式确认settings.json里的apiKeyEnv名字和实际环境变量名完全一致大小写敏感。5.3 命令找不到 / 脚本被拦截openclaw提示不是内部或外部命令说明 npm 全局目录没进 PATH。跑npm config get prefix看路径把它加到系统环境变量里。脚本被拦截就重跑一次Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser。5.4 网关窗口被关掉onboard 最后会弹出一个openclaw-gateway的独立命令行窗口这个千万别关关了服务就断了。防火墙弹窗要选允许否则本地请求会被挡。5.5 配置改乱了想重来重新跑openclaw onboard --install-daemon在 Config handling 那一步选 Reset再选 Full reset就能清空重配。不用重装系统我那次是折腾太久才走了极端。6. 后续怎么用模型对话、Coding Plan 与文档跑通第一个调用之后日常使用主要分两个方向。一个是临时验证模型、试 prompt直接开模型对话页面就行https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content另一个是长期写代码、跑 Agent 任务这种高频调用更适合用 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最后给个实用技巧把TAOTOKEN_API_KEY写进用户级环境变量之后以后换 Key 只改这一处config.toml 和 settings.json 都不用动。这样即使 OpenClaw 升级换了配置格式你的 Key 也不会丢。