1. 为什么 Windows 上装 OpenClaw 总卡在环境这一步OpenClaw 是一个能操控本地电脑、读写文件、模拟键鼠的 AI Agent 工具v2.6.6 版本在 Windows 10/11 64 位上的安装体验已经比早期版本顺滑很多。但我在帮朋友装的过程中发现真正让人卡住的往往不是 OpenClaw 本身而是它背后依赖的 Python 和 Node.js 环境——版本不对、PATH 没配好、pip 源太慢、node-gyp 编译失败任何一个环节出问题都会让启动脚本报错退出。这篇内容面向的是完全没接触过命令行的小白目标是把 OpenClaw v2.6.6 在 Windows 上从零装到能正常对话。我会先讲清楚 Python 和 Node.js 这两个前置环境怎么准备再给出一键安装脚本的执行方式然后重点交付两份可复制的配置文件骨架——settings.json和config.toml并把 TaoToken 的统一 Key 接进去。最后给一个验证对话是否正常的检查动作确保你装完不是「看起来成功了但发消息没反应」。如果你之前装过其他 AI Agent 工具大概率遇到过「装完了但模型调不通」的情况。这篇会把模型接入这部分单独拎出来讲因为 OpenClaw 默认的模型配置对新手不太友好而用 TaoToken 的统一 Key 可以省掉逐个平台申请 Key 的麻烦。2. 装 OpenClaw 之前先把 TaoToken 的 Key 拿到手OpenClaw 本身是一个客户端框架它需要调用大模型 API 才能工作。默认配置里会让你填各种平台的 Key对新手来说光是注册和实名就够折腾半天。TaoToken 的做法是提供一个统一入口你只需要一个 Key 就能调用多个主流模型省去逐个平台配置的步骤。具体操作是打开官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后在控制台里创建一个 API Key。这个 Key 的格式通常是sk-开头的一串字符复制下来先存到记事本里后面配置settings.json和config.toml都要用到。注意Key 只在创建时完整显示一次关掉页面就看不到了。如果没存下来直接删掉重新创建一个就行不用纠结。拿到 Key 之后你还需要确认一下要用的模型名称。TaoToken 的模型列表在文档页可以查到常见的比如claude-sonnet-4-20250514、gpt-4o这类。OpenClaw 的配置里需要填具体的模型 ID填错了会报 404。我建议新手先用一个便宜且稳定的模型跑通流程确认链路没问题之后再换更强的模型。API 的基础地址是https://taotoken.net/api这个地址在配置文件里会用到。注意这个地址不带任何查询参数直接填进配置就行。3. Windows 环境准备Python 和 Node.js 怎么装才不踩坑OpenClaw v2.6.6 的一键安装脚本虽然号称「无需手动配置」但实际执行时它仍然会调用系统里的 Python 和 Node.js。如果这两个环境缺失或版本不对脚本会在依赖安装阶段直接失败。所以这一步不能跳过。3.1 Python 安装与版本选择OpenClaw 要求 Python 3.10 及以上版本。我实测下来 3.11 和 3.12 都比较稳3.13 在某些依赖包上还有兼容问题建议避开。去 Python 官网下载 Windows installer64-bit安装时务必勾选「Add Python to PATH」这个选项。很多人装完 Python 在命令行里敲python提示找不到命令就是因为没勾这个。如果你已经装了但忘了勾重新运行安装程序选 Modify 把 PATH 加上也行。装完之后打开 PowerShell 验证python --version pip --version正常应该输出类似Python 3.11.9和pip 24.x的版本信息。如果pip提示不是内部命令用python -m pip --version代替能用就说明 pip 本身没问题只是 PATH 里没加 Scripts 目录。pip 源建议换成国内镜像否则装依赖时会慢到怀疑人生python -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple3.2 Node.js 安装与 npm 配置OpenClaw 的前端部分依赖 Node.js要求 18.x 或 20.x LTS 版本。去 Node.js 官网下载 LTS 版的 Windows Installer.msi一路下一步就行安装程序会自动配好 PATH。装完验证node --version npm --version正常输出v20.x.x和10.x.x。npm 同样建议换源npm config set registry https://registry.npmmirror.com这一步做完之后Python 和 Node.js 两个前置环境就齐了。接下来执行一键安装脚本时它检测到这两个环境存在就会跳过自动下载环节直接进入依赖安装。4. 一键安装脚本执行与 settings.json / config.toml 配置4.1 执行一键安装OpenClaw v2.6.6 的安装包解压后目录里会有一个install.ps1或者setup.bat。以管理员身份打开 PowerShellcd 到解压目录执行cd D:\OpenClaw .\install.ps1如果提示执行策略限制先运行Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass这个只对当前窗口生效不会改系统全局设置。脚本会依次做这几件事检测 Python 和 Node.js 版本、创建虚拟环境、安装 Python 依赖、安装 npm 依赖、生成默认配置文件。整个过程大概 3 到 5 分钟取决于网络速度。如果卡在某个包下载不动大概率是源没换回去检查第 3 步的镜像配置。安装完成后目录结构大致是这样D:\OpenClaw\ ├── venv\ # Python 虚拟环境 ├── node_modules\ # Node 依赖 ├── settings.json # 主配置 ├── config.toml # 模型与渠道配置 ├── start.bat # 启动脚本 └── ...4.2 settings.json 骨架settings.json控制 OpenClaw 的基础行为包括 Gateway 端口、日志级别、工作目录等。下面这份是我实测能跑通的骨架你可以直接复制后按需改{ gateway: { host: 127.0.0.1, port: 8765, autoStart: true }, workspace: D:\\OpenClaw\\workspace, logLevel: info, language: zh-CN, security: { allowFileAccess: true, allowShellExec: true, allowedPaths: [ D:\\OpenClaw\\workspace, C:\\Users\\你的用户名\\Desktop ] } }几个关键点workspace是 OpenClaw 读写文件的默认目录路径必须用双反斜杠转义allowedPaths里列出的目录才允许 Agent 操作没列出的会被拒绝这是安全边界别图省事写成C:\\。port如果被占用可以改成 8766 或其他空闲端口。4.3 config.toml 接入 TaoToken 统一 Keyconfig.toml是模型接入的核心配置。OpenClaw 用 TOML 格式定义 provider 和 model下面这份配置把 TaoToken 作为统一入口接进去[providers.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 timeout 120 [models.default] provider taotoken model claude-sonnet-4-20250514 max_tokens 4096 temperature 0.7 [models.fast] provider taotoken model gpt-4o-mini max_tokens 2048 temperature 0.5 [agent] default_model default max_iterations 15type填openai-compatible是因为 TaoToken 的接口兼容 OpenAI 格式OpenClaw 能直接识别。base_url就是前面提到的https://taotoken.net/api注意结尾不要加/v1OpenClaw 会自己拼接路径。api_key换成你实际拿到的 Key。[models.default]和[models.fast]定义了两个模型档位default 用于复杂任务fast 用于简单对话。[agent]里的default_model指向 defaultmax_iterations控制 Agent 最多执行多少轮工具调用设太大容易陷入循环15 是个比较稳的值。改完配置后重启 OpenClaw 让配置生效。启动脚本是start.bat双击或者在 PowerShell 里执行.\start.bat5. 验证请求确认对话链路真的通了配置改完不代表就能用必须做一次实际请求验证。OpenClaw 启动后界面右上角会显示 Gateway 状态等它变成「在线」再进行下一步。5.1 用界面发一条测试消息在对话窗口输入一条简单指令比如「你好请回复你的模型名称」。如果配置正确几秒内会返回模型名称和问候语。如果超过 30 秒没反应或者报错「connection refused」说明 Gateway 没起来或者端口不对。5.2 用命令行直接验证 API 连通性界面验证通过后建议再用命令行确认一次排除界面层的干扰。在 PowerShell 里执行curl -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的TaoToken密钥 -H Content-Type: application/json -d {\model\:\claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\ping\}]}正常会返回一段 JSON包含choices字段和模型回复内容。如果返回 401说明 Key 不对返回 404说明模型 ID 写错了返回 429说明额度或频率受限。这一步能快速定位问题出在 Key、模型还是网络。5.3 检查 Gateway 日志如果界面和命令行都失败去看 OpenClaw 的日志。日志文件在D:\OpenClaw\logs\gateway.log用记事本打开搜索ERROR关键字。常见的错误有api_key invalid、model not found、connection timeout对应去改config.toml里的对应字段就行。6. 本篇常见错误排查装 OpenClaw 的过程中下面这几个错误出现频率最高我按实际遇到的顺序列出来你对照着排查。Python 版本不兼容报错信息里出现requires Python 3.10或者某个包编译失败。解决方法是卸载当前 Python装 3.11 或 3.12重装时记得勾 PATH。npm install 卡住或报错多半是源没换或者网络问题。先确认npm config get registry输出的是https://registry.npmmirror.com不是的话重新设置。如果某个包一直下载失败删掉node_modules和package-lock.json重新执行安装。Gateway 启动后一直显示离线检查settings.json里的port是否被其他程序占用用netstat -ano | findstr 8765查一下。如果被占用改成 8766 或 8767。另外确认host是127.0.0.1而不是0.0.0.0后者在某些网络环境下会被防火墙拦截。对话返回 401 UnauthorizedKey 填错了或者过期了。去 TaoToken 控制台重新创建一个 Key复制时注意不要带空格。config.toml里api_key的值要用双引号包起来。对话返回 404 model not found模型 ID 写错了。去 TaoToken 文档页确认模型名称注意大小写和版本号后缀。比如claude-sonnet-4-20250514不能简写成claude-sonnet-4。Agent 执行文件操作时报权限拒绝settings.json里的allowedPaths没包含目标目录。把要操作的目录加进去路径用双反斜杠。改完重启 OpenClaw。启动脚本闪退用管理员身份打开 PowerShellcd 到安装目录手动执行.\start.bat这样能看到报错信息。闪退通常是 Python 虚拟环境没激活或者依赖缺失重新跑一遍install.ps1修复。7. 装好之后怎么继续用OpenClaw 跑通之后你可以把它当成一个能操控电脑的 AI 助手来用。日常操作类的任务比如整理文件夹、批量重命名、查磁盘空间直接下指令就行。复杂一点的任务比如「把 D 盘下载文件夹里所有 PDF 按月份归类到桌面新建的文件夹」Agent 会自动拆解成多步执行。模型方面如果你后面要长期跑编码或 Agent 任务可以关注 TaoToken 的 Coding Plan它在长上下文和工具调用场景下更划算。日常对话和简单任务用默认的按量计费就够。需要管理多个 Key 或者查看用量去控制台页面操作。接入文档里有更详细的参数说明遇到配置问题可以先翻文档。我自己的习惯是先把config.toml里的fast模型设成便宜的小模型用来做意图识别和简单问答default设成强模型处理复杂任务。这样既省额度又不影响体验。OpenClaw 的 Agent 循环里max_iterations别设太大15 到 20 之间比较合适再大容易在死循环里烧 token。最后提醒一句settings.json里的allowedPaths是安全底线只加你确实需要 Agent 操作的目录不要图方便把整个 C 盘加进去。装好之后先跑几个只读任务验证行为确认没问题再放开写权限。