1. 为什么 Windows 装 OpenClaw 总在第一步卡住OpenClaw 是一个开源的 AI 智能体项目你可以把它理解成一个跑在自己电脑上的“任务执行器”通过聊天窗口给它下自然语言指令它调用本机环境帮你写代码、整理文件、跑自动化流程。它适合想在自己设备上折腾智能体、又不想把数据全交给云端的人尤其是 Windows 用户——而问题恰恰出在这里。官方给的一键脚本在 macOS 和 Linux 上基本顺滑到了 Windows 却经常在开头就报错。我见过最多的两类一是 PowerShell 提示“无法加载文件因为在此系统上禁止运行脚本”二是脚本跑到一半说找不到 node 或 git。根因不复杂OpenClaw 本体是 JavaScript 写的运行要靠 Node.js安装过程要从远端拉依赖包靠的是 Git。这两个东西 Windows 默认都没有一键脚本又假设你已经有了于是第一步就断。所以这篇不走一键脚本的捷径而是把 Node.js、Git 手动装好、校验版本再装 OpenClaw最后用 TaoToken 的统一 Key 把模型通道接上。全程命令可复制装完你能用一条启动命令确认服务真的活着。下面按顺序来别跳步。2. 装 OpenClaw 前先把 TaoToken 的 Key 和通道准备好OpenClaw 装好后要选一个“大脑”也就是背后调用的 AI 模型。引导程序里会列一堆平台让你填 API Key如果你每个平台单独申请、单独配Key 散落在各处换模型时改配置很烦。TaoToken 在这里的作用是提供一个统一的 API 通道你拿一个 Key就能在 OpenClaw 里切换不同模型配置只写一份。先做两件事。第一注册并登录后到控制台创建 API Key地址是 https://taotoken.net/api-keys 创建完把 Key 复制出来形如sk-开头的一长串只显示一次存好。第二记住两个地址官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 注意 API 地址后面不加任何查询参数配置里填的就是这个。注意Key 不要写进会提交到 Git 仓库的文件里也不要在聊天群里贴。后面配置文件里我们会用环境变量或本地文件的方式引用。如果你还没决定用哪个模型可以先到模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 试几句确认通道通不通再回来配 OpenClaw。这一步花两分钟能省掉后面“到底是 Key 错还是配置错”的排查。3. Windows 下 Node.js 与 Git 的安装和版本校验这一节是整篇的地基装错了后面全崩。建议用管理员身份操作避免权限问题。3.1 安装 Node.js 并锁定 LTS 版本Node.js 是让 JavaScript 在你电脑上跑起来的运行环境OpenClaw 没有它根本起不来。去 Node.js 官网下载 Windows 的 LTS长期支持版本选.msi安装包双击一路下一步即可安装向导里记得勾选“Add to PATH”这样命令行才能直接调用。装完必须校验打开一个新的 PowerShell 窗口不是旧的旧窗口读不到新 PATH执行node -v npm -v正常会输出类似v20.11.1和10.2.4的版本号。如果提示“不是内部或外部命令”说明 PATH 没生效重开窗口或重启一次还不行就手动把 Node.js 安装目录加进系统环境变量。版本上建议 Node.js 18 以上太老的版本跑 OpenClaw 会缺 API。3.2 安装 Git 并确认可调用Git 是代码版本管理工具OpenClaw 安装时用它从远端拉依赖包。去 Git 官网下载 Windows 版安装包安装过程中大部分默认即可遇到“Adjusting your PATH environment”那一页选“Git from the command line and also from 3rd-party software”保证命令行能调用。装完同样开新窗口校验git --version输出git version 2.43.0.windows.1这类信息就算成功。到这里两个前置依赖齐了可以进入 OpenClaw 本体安装。3.3 放开脚本执行权限再装 OpenClawWindows 默认禁止运行未签名的 PowerShell 脚本这就是一键安装报“禁止运行脚本”的原因。以管理员身份打开 PowerShell先放开当前用户的执行策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUser弹出确认时输入A回车。然后执行官方安装命令powershell -c irm https://openclaw.ai/install.ps1 | iex装完校验版本openclaw -v能打印出版本号说明本体装好了。如果这一步仍然报错先回头看第 5 节的排查表多半是 Node 或 Git 的 PATH 没生效。4. 可复制的 OpenClaw 配置文件骨架接入 TaoToken装完本体后OpenClaw 的配置通常放在用户目录下的配置文件夹里Windows 一般是C:\Users\你的用户名\.openclaw\。里面常见两个文件config.toml管模型和通道settings.json管运行参数。下面给的是骨架把占位符换成你自己的值即可。先看config.toml重点是模型提供方指向 TaoToken 的 API 基址# ~/.openclaw/config.toml [model] provider openai-compatible base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model claude-3-5-sonnet [gateway] host 127.0.0.1 port 8787这里provider用openai-compatible因为 TaoToken 的 API 兼容 OpenAI 的调用格式base_url严格填https://taotoken.net/api不要带斜杠后缀或查询参数api_key用${TAOTOKEN_API_KEY}引用环境变量避免明文落盘。模型名按你在模型对话页面确认可用的填。再看settings.json管的是本地运行行为{ gateway: { autoStart: true, logLevel: info }, skills: { autoUpdate: false }, security: { bindLocalOnly: true } }bindLocalOnly设为 true 是刻意为之网关只监听本机不往公网暴露端口。前面 excerpt 里提到的端口暴露风险靠这一条就能挡掉大半。设置环境变量在 PowerShell 里这样写当前会话有效$env:TAOTOKEN_API_KEY sk-你的Key想永久生效就写进系统环境变量或者用 OpenClaw 支持的密钥文件方式。配好后跑一次新手引导把通道串起来openclaw onboard --install-daemon引导里选 Manual 模式模型那一步选 OpenAI 兼容 / 自定义把上面的 base_url 和 Key 填进去聊天渠道和搜索服务先跳过Skills 至少加上 ClawHub。5. 启动验证与常见报错排查配置写完必须验证不然你不知道是通还是没通。启动网关openclaw gateway start然后另开一个窗口发一条测试请求确认模型通道真的返回内容openclaw chat 用一句话说明你当前使用的模型名称如果返回了正常文本说明 TaoToken 通道、Key、模型名三者都对上了。想更直观可以打开 Web UI引导程序结束时会给出本地地址通常是http://127.0.0.1:8787在网页里发消息看回复。下面是这一路最容易踩的坑对照处理报错现象大概率原因处理方式openclaw不是内部或外部命令安装后没重开终端PATH 未刷新关掉所有 PowerShell 重开仍不行则手动加 PATH禁止运行脚本执行策略未放开重跑Set-ExecutionPolicy RemoteSigned -Scope CurrentUser安装中卡在拉依赖Git 未装或不在 PATHgit --version校验重装并选命令行 PATH 选项401 / 鉴权失败Key 错、过期或环境变量没生效重新导出TAOTOKEN_API_KEY确认无多余空格404 / 模型不存在模型名拼错或该模型不可用到模型对话页面确认可用模型名再填网关启动后网页打不开端口被占或防火墙拦截换端口防火墙提示时选允许专用网络注意如果openclaw chat一直转圈不返回先确认网关进程还活着再看日志文件里的报错行多数是 base_url 多写了斜杠导致路径拼接错误。排查完再跑一次验证命令直到稳定返回。这一步过了本地环境就算真正可用。6. 后续怎么用把通道和编码场景接起来环境通了之后日常使用其实就两件事保持网关在跑以及按需扩展 Skills。如果你主要拿 OpenClaw 做长期编码、跑 Agent 任务建议把模型通道固定下来别频繁改配置——统一走 TaoToken 的好处就在这里换模型只改config.toml里一行modelKey 和 base_url 不动。需要长期编码额度的话可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和参数说明以官方文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你用的是 Claude Code 这类工具链Anthropic 兼容接法在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 有对应说明。控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理仍在 https://taotoken.net/api-keys 。最后提醒一句实操经验OpenClaw 的 Skills 是能力来源也是风险来源装之前用 Skill Vetter 扫一遍定期跑openclaw security audit看配置文件有没有被改。本地部署的最大优势是数据在自己手里别因为随手装了个来路不明的技能包把这个优势丢掉。