1. 为什么要在 Windows 上折腾 OpenClaw如果你对 OpenClaw 还不太熟先简单说一句它是一个能真正“动手”的 AI Agent 框架。网页版聊天工具再能聊也改不了你 D 盘里那堆乱文件而 OpenClaw 可以读本地目录、跑脚本、调浏览器、串起一整条自动化流程。也正因为这样它才在 GitHub 上攒下超高星标被一堆人叫作“赛博龙虾”。但很多人卡在第一步Windows 到底能不能跑答案是能而且比想象中顺。Windows 10 和 Windows 11 都支持硬件门槛也不高——CPU 双核以上、内存 4GB 起步推荐 8GB、硬盘留 10GB 空闲就够。真正容易翻车的不是系统本身而是环境没铺好Node.js 版本不对、Git 没装、PowerShell 没重启、API Key 填错位置。这篇就把从 Node.js 到 TaoToken 配置的完整链路走一遍让你在 Windows 上把 OpenClaw 顺利跑起来并且把模型通道接稳。我试过在几台不同配置的 Windows 机器上装踩过的坑基本都集中在版本和路径上下面按顺序来你照着做就行。2. 前置环境Node.js 与 Git 一次装对OpenClaw 依赖 Node.js 运行官方要求 22.0.0 以上。为了后面切换版本方便建议用 nvm-windows 来管理而不是直接下安装包。装好 nvm 后在 PowerShell 里执行nvm install 24.13.0 nvm use 24.13.0装完验证一下node -v能打印出v24.13.0就说明 Node 环境 OK。这里有个细节nvm use需要管理员权限如果报权限错误用管理员身份重开 PowerShell 再执行一次。接着装 Git。下载Git-2.53.0-64-bit安装包向导里保持默认选项一路 Next 到底即可。装完一定要重启 PowerShell否则环境变量不生效。重启后验证git --version看到版本号就通过了。Git 的作用是让 OpenClaw 在需要拉取仓库、执行版本相关操作时有底层支持别跳过。3. 安装 OpenClaw 并初始化环境齐了装 OpenClaw 本身只有一条命令npm i -g openclaw全局安装会花一点时间耐心等它跑完。装完验证openclaw --version能看到版本号说明安装成功。接下来跑初始化向导openclaw onboard向导里第一个选项选YES第二个选QuickStart。到 AI 模型选择这一步建议优先选国内模型连接更稳定。按提示填入 API Key 即可。Skill 和 Hooks 先跳过后面需要再配。最后选择 Web 方式打开浏览器访问127.0.0.1:18789能看到界面就说明初步跑通了。常用管理命令记一下日常维护够用命令作用openclaw start启动服务openclaw stop停止服务openclaw restart重启服务openclaw status查看服务状态openclaw logs查看实时日志openclaw --help查看帮助4. 用 TaoToken 统一 Key 与 API 通道向导里直接填某一家模型的 Key 能用但如果你会同时用多个模型或者想让 OpenClaw 的请求走一条统一通道用 TaoToken 会更省心。它提供一个统一的 Key 和 API 入口OpenClaw 侧只需要改配置不用每换一个模型就重填一遍。TaoToken 官网是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 入口是https://taotoken.net/api。先去控制台创建一个 API Key位置在https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteKey 管理页在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite。创建后把 Key 复制出来注意别泄露。OpenClaw 的配置写在config.toml里。找到你的配置目录通常在用户目录下的.openclaw文件夹编辑config.toml把模型通道指向 TaoToken[model] provider openai-compatible base_url https://taotoken.net/api api_key 你的_TaoToken_Key model claude-sonnet-4-5 [server] host 127.0.0.1 port 18789这里provider用openai-compatible是因为 TaoToken 的 API 兼容 OpenAI 格式OpenClaw 能直接识别。model字段填你想用的模型名按 TaoToken 文档里支持的名称来写。改完保存重启服务openclaw restart注意base_url结尾不要多加/v1按上面写的https://taotoken.net/api即可多写反而容易 404。5. 验证请求是否真正打通配置改完不代表通了得实际发一次请求验证。最简单的办法是在 OpenClaw 界面里发一条测试消息比如“帮我列一下当前目录的文件”。如果模型正常返回说明通道打通。也可以直接用命令行验证 TaoToken 通道是否可用curl https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer 你的_TaoToken_Key -H Content-Type: application/json -d {\model\:\claude-sonnet-4-5\,\messages\:[{\role\:\user\,\content\:\ping\}]}返回里带choices字段和内容就说明 Key 和通道都没问题。如果 OpenClaw 界面里能对话但命令行报错多半是 Key 复制时带了空格重新复制一次。想单独测模型对话可以走https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite快速确认模型侧是否正常。如果你打算长期用 OpenClaw 跑编码或 Agent 任务建议了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入方式和文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。6. 本篇常见报错排查报错一openclaw不是内部或外部命令。这是全局安装路径没进环境变量。先确认npm i -g openclaw成功然后执行npm config get prefix看全局路径把这个路径加到系统 PATH 里重启 PowerShell。报错二node -v版本低于 22。nvm 切了版本但没生效检查是不是开了多个终端窗口。关掉所有 PowerShell重开一个再nvm use 24.13.0。报错三访问127.0.0.1:18789打不开。先openclaw status看服务是否在跑没跑就openclaw start。如果端口被占用改config.toml里的port换一个再重启。报错四模型请求 401。Key 错了或过期。去https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite重新生成一个注意config.toml里不要有多余引号或空格。报错五请求超时。检查base_url是否写成了https://taotoken.net/api/结尾多了斜杠改成不带斜杠的版本。另外确认本机网络能正常访问该地址。报错六config.toml改了不生效。OpenClaw 不会热加载配置必须openclaw restart。改完记得重启再看openclaw logs确认没有解析错误。排障时优先看日志openclaw logs会把请求和错误都打出来比猜快得多。接入相关的完整说明在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite遇到配置格式问题对着文档核一遍基本能解决。整套流程走下来Windows 上跑 OpenClaw 并不复杂关键就是环境版本对、配置路径对、Key 填对。把这三步做扎实后面让它帮你整理文件、跑自动化流程就顺理成章了。
