OpenClaw Windows 安装与初始化手册：TaoToken 统一 Key 接入与 PowerShell 验证

发布时间：2026/10/2 14:23:17来源：尧图网络

1. Windows 上跑 OpenClaw 到底卡在哪从安装到初始化的真实场景OpenClaw 是一个可以在本机运行的 Agent 网关它能把你常用的聊天渠道Telegram、飞书等和各类大模型串起来让 AI 助手真正落到日常工具里。适合谁适合想在 Windows 上本地部署一个可控 Agent、又不想折腾 Linux 双系统的开发者。它是什么一句话一个跑在127.0.0.1:18789的本地服务通过 CLI 管理、通过 Web 控制台操作、通过统一 API 通道调用模型。但 Windows 环境下的坑比想象中密集。我自己第一次装的时候卡在npm error code 128整整一个下午——报错信息是gitgithub.com: Permission denied (publickey)看起来像 SSH 问题实际上是 npm 依赖里混了 GitHub 仓库地址而本机没配 SSH key。后来又在 PowerShell 执行策略上栽了一次默认策略禁止运行远程脚本安装脚本刚跑就退出连报错都不明显。这篇手册聚焦三件事安装命令可复制、初始化配置可落地、PowerShell 验证可复现。同时把模型接入统一走 TaoToken 的 Key/API 通道避免你在多个 Provider 之间反复切换 Key。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 地址是 https://taotoken.net/api 后面配置里会反复用到。先明确目标装完 OpenClaw CLI、跑通 Onboarding 初始化、Gateway 服务起来、Web 控制台能访问、至少一个模型通道验证成功。下面按顺序来每一步都有 PowerShell 命令和预期输出。2. 装之前先把地基打好Node.js、Git 与 PowerShell 执行策略OpenClaw 对环境的硬性要求不多但每一条都不能省。Node.js 版本必须 ≥ 22实测 v24.14.0 稳定可用。建议直接下 Node.js 官方 Windows MSI 安装包安装时勾选「Add to PATH」省得后面手动配环境变量。装完在 PowerShell 里验证node -v npm -v预期输出类似v24.14.0和10.9.0。如果node命令找不到八成是 PATH 没生效重开一个 PowerShell 窗口再试。Git 也必须装OpenClaw 的部分依赖通过 Git 拉取。装 Git for Windows 后验证git --version正常输出git version 2.50.0.windows.1这种格式。注意这里用的是 Windows PowerShell不是 CMD。CMD 下某些脚本行为不一致官方文档也建议用 PowerShell。权限方面普通用户权限即可不需要管理员。接下来是最容易被忽略的一步——执行策略。Windows 默认禁止执行远程脚本OpenClaw 的安装脚本是iwr ... | iex形式策略不放开会直接失败。推荐只对当前会话临时放开Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process输入Y确认。这个设置只对当前 PowerShell 窗口生效关掉就恢复安全性可控。如果你图省事用-Scope CurrentUser永久放开记得后面手动改回去。还有一个隐藏坑公司网络或国内网络下npm 拉 GitHub 依赖经常超时。提前把 Git 的 SSH 地址强制走 HTTPS能省掉后面一大半报错git config --global url.https://github.com/.insteadOf gitgithub.com:这条命令的意思是以后所有gitgithub.com:开头的地址自动替换成https://github.com/。配完可以用git config --global --list确认。环境检查清单对照表检查项命令通过标准Node.jsnode -v≥ v22npmnpm -v随 Node 附带Gitgit --version任意 2.x执行策略Get-ExecutionPolicyBypass 或 RemoteSignedGit 地址替换git config --global --list含 insteadOf 规则这几步做完地基就算打好了。别跳过执行策略和 Git 替换后面会感谢自己。3. 安装 OpenClaw 与 TaoToken 统一 Key 接入配置安装有两种方式。推荐官方脚本一条命令搞定iwr -useb https://openclaw.ai/install.ps1 | iex顺利的话会看到[OK] Windows detected、[OK] Node.js vXX found、[*] Installing OpenClaw (openclawlatest)...。如果卡在npm error code 128别慌这是最常见的报错处理方式在下一节。脚本失败时改用手动安装npm config set registry https://registry.npmmirror.com npm cache clean --force npm install -g openclawlatest装完验证openclaw --version输出类似2026.3.2就说明 CLI 就位了。接下来是初始化。启动向导openclaw onboard --install-daemon--install-daemon会把 Gateway 注册成 Windows 计划任务开机自启。向导里 Gateway 部分默认即可端口18789、绑定127.0.0.1、认证方式 Token自动生成。关键在模型与鉴权这一步。这里我们统一走 TaoToken 的 API 通道好处是一个 Key 管所有模型不用为每个 Provider 单独配。配置写入 OpenClaw 的配置文件路径通常在C:\Users\用户名\.openclaw\config.json。你可以直接编辑也可以用 CLI 写入。下面是可复制的 JSON 片段{ providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, models: { default: claude-sonnet-4-5, fast: gpt-4o-mini } } }, gateway: { port: 18789, bind: 127.0.0.1, auth: { type: token } } }三件套必须写全Base URL是https://taotoken.net/apiKey从控制台生成Model ID按你实际要用的填。Key 的获取入口在 https://taotoken.net/api-keys 生成后复制粘贴到apiKey字段。注意 Key 属于敏感信息别提交到 Git 仓库建议用环境变量注入setx TAOTOKEN_API_KEY sk-你的密钥然后在配置里引用apiKey: ${TAOTOKEN_API_KEY}。这样配置文件可以安全地进版本管理。如果你用的是 Claude Code 这类工具TaoToken 的接入文档在 https://taotoken.net/doc 里面有各客户端的详细配置。OpenClaw 这边配好providers.taotoken后Onboarding 里选择模型时就能直接选到。配置写完重启 Gateway 让配置生效openclaw gateway restart到这里安装和接入就完成了。下一步验证。4. PowerShell 验证请求确认 Gateway 与模型通道都通了配置写完不代表能用必须验证。分三层CLI 层、Gateway 层、模型通道层。先看 Gateway 状态openclaw gateway status预期输出里有reachable字样说明服务在跑。如果显示unreachable先检查计划任务是否启动Get-ScheduledTask -TaskName *openclaw*找到任务后手动启动Start-ScheduledTask -TaskName OpenClaw Gateway接着拿 Gateway Token用于访问 Web 控制台openclaw config get gateway.auth.token复制输出的 Token浏览器访问http://127.0.0.1:18789/#token你的Token。能看到控制台界面就说明 Gateway 正常。最关键的是模型通道验证。用 PowerShell 直接打 TaoToken 的 API确认 Key 和 Base URL 都对$headers { Authorization Bearer $env:TAOTOKEN_API_KEY Content-Type application/json } $body { model claude-sonnet-4-5 messages ( { role user; content 回复两个字通了 } ) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body如果返回里有choices字段且内容是「通了」说明模型通道完全打通。这一步过了OpenClaw 里调用模型就不会有问题。再回到 OpenClaw 内部验证一次用 CLI 发一条测试消息openclaw chat --message 你好确认通道正常预期能看到模型回复。如果这里报错但 PowerShell 直连 API 正常说明是 OpenClaw 配置里的baseUrl或apiKey写错了回去检查config.json。验证清单验证层命令通过标志CLIopenclaw --version版本号输出Gatewayopenclaw gateway statusreachableWeb 控制台浏览器访问界面加载模型通道Invoke-RestMethod返回 choices端到端openclaw chat模型回复五层全过才算真正跑通。别只看 CLI 版本就以为完事了模型通道才是核心。5. 常见报错逐个拆npm error 128、401、local proxy failed 怎么修这一节把 Windows 下最容易撞的报错列全对照着修。npm error code 128报错长这样gitgithub.com: Permission denied (publickey)。根因是 npm 依赖里有 GitHub 仓库默认走 SSH本机没配 key。修复三步git config --global url.https://github.com/.insteadOf gitgithub.com: npm config set registry https://registry.npmmirror.com npm cache clean --force npm install -g openclawlatest如果还不行检查是否有公司网络拦截换个网络环境重试。401 Unauthorized模型通道返回 401说明 Key 无效或没带上。检查三处config.json里apiKey是否正确、环境变量TAOTOKEN_API_KEY是否生效echo $env:TAOTOKEN_API_KEY验证、请求头是否带了Bearer。Key 重新生成入口在 https://taotoken.net/api-keys 。local proxy failed这个报错通常出现在 Gateway 启动时提示本地代理连接失败。原因是端口18789被占用或者绑定地址写错。检查端口占用netstat -ano | findstr 18789如果有进程占用要么杀掉要么改 Gateway 端口。改端口在config.json的gateway.port字段改完openclaw gateway restart。reading choices 报错类似cannot read property choices of undefined说明 API 返回结构不对。八成是baseUrl写成了https://taotoken.net而漏了/api或者路径拼成了/v1/chat/completions但 base 里已经含/api。正确写法baseUrl填https://taotoken.net/api请求路径由 OpenClaw 内部拼接。OAuth 相关报错如果你在配置里误开了 OAuth 模式会提示OAuth flow not supported。OpenClaw 接 TaoToken 用 API Key 模式即可把配置里的auth.type改成token或apikey别用 OAuth。飞书渠道报app do not have bot这是渠道配置问题不是模型问题。飞书机器人必须同时满足三个条件企业自建应用、启用「机器人」能力、分配 IM 权限并发布。缺一个都会报这个错。权限至少要有im:message、im:chat、contact:user.base:readonly。插件安装失败飞书插件会下载到C:\Users\用户名\.openclaw\extensions\feishu。如果提示已存在但安装失败手动删掉这个目录再重新执行 Onboarding。排错时记住一个原则先分层定位。CLI 报错查环境Gateway 报错查端口和计划任务模型报错查 Key 和 baseUrl渠道报错查权限。别一上来就重装浪费时间。6. 后续怎么用从验证通过到日常运维跑通之后日常运维就几条命令。查看 Gateway Tokenopenclaw config get gateway.auth.token生成新 TokenToken 泄露时用openclaw doctor --generate-gateway-token打开控制台openclaw dashboard --no-open安全审计openclaw security audit --deep openclaw security audit --fixOpenClaw 默认是「个人 Agent」安全模型绑定127.0.0.1不适合直接暴露公网。多人使用务必拆分账号和 Token启用 allowlist最小化工具权限。官方安全文档在 https://docs.openclaw.ai/security 建议通读一遍。如果你后续要做长期编码或 Agent 任务TaoToken 的 Coding Plan 在 https://taotoken.net/coding-plan 按量计费比单次调用划算。模型对话调试入口在 https://taotoken.net/chat 可以快速验证某个模型 ID 是否可用省得在 OpenClaw 里反复试。最后提醒一个实操细节Windows 计划任务偶尔会因为系统更新被禁用导致 Gateway 开机不启动。定期用Get-ScheduledTask -TaskName *openclaw*检查状态发现Disabled就手动启用。这个坑我踩过一次排查了半天才发现是计划任务被系统关了。装完、配好、验证通过剩下的就是按你的场景去接渠道、写技能、跑自动化。基础打牢了后面扩展不用重复安装。

网站建设高端定制企业官网