1. 为什么要在 Windows 上折腾 OpenClaw 这类桌面 AI 助手普通聊天式 AI 最大的问题是只能“动嘴”——它告诉你“你可以打开资源管理器把桌面图片按日期拖进文件夹”但真正动手的还是你自己。OpenClaw 这类工具的思路完全不同它把大模型的推理能力和本机的 PowerShell 执行通道接在一起让 AI 直接在你电脑上创建文件、移动目录、运行脚本、调用命令行工具。你只需要用自然语言描述任务剩下的动作由它落地。我关注这个方向有一段时间了核心原因有三个。第一Windows 是绝大多数普通用户和不少开发者的主力系统但很多自动化工具优先支持 macOS 或 LinuxWindows 上的落地路径反而讲得含糊。第二PowerShell 本身就是一个非常强的自动化引擎对象化的管道、丰富的 cmdlet、能直接调 .NET只要把执行通道打通AI 能做的事情非常多。第三Node.js 22 之后对 Windows 的支持已经相当成熟用它做运行环境安装和排障都比早年省心。这篇文章聚焦的就是 Windows 环境下的完整落地路径从 Node.js 运行环境准备到 PowerShell 执行通道打通再到让 AI 完成一次真实的文件整理任务。同时我会说明怎么通过 TaoToken 统一 Key 和 API 通道接入模型能力避免在多个服务商控制台之间来回切换。适合想真正让 AI 帮自己干活的 Windows 用户、喜欢折腾本地自动化的开发者以及需要批量处理文件、跑脚本的运维同学。需要提前说清楚一点让 AI 直接操控电脑是有安全风险的。它能执行命令就意味着错误指令也可能被执行。所以下面所有配置我都会强调权限边界和验证步骤先在小范围目录里试确认行为符合预期再放开。2. 前置准备Node.js 22 与 TaoToken 统一接入通道2.1 为什么是 Node.js 22OpenClaw 这类工具的运行环境要求 Node.js 22 及以上原因不复杂新版本在 Windows 上的文件监听、子进程管理、原生模块编译都更稳定。低于 22 的版本在部分 PowerShell 调用场景下会出现编码或路径转义问题排查起来很费时间。所以第一步就是把 Node 版本对齐。打开 PowerShell先确认当前版本node -v npm -v如果显示的不是 v22.x.x去 Node.js 官网下载 LTS 版本重新安装即可。安装时保持默认选项安装程序会自动把 node 和 npm 加进 PATH。装完关掉当前 PowerShell 窗口重新开一个再验证否则 PATH 不会刷新。2.2 用 TaoToken 统一 Key 和 API 通道模型能力这块我建议用 TaoToken 做统一入口。原因是 OpenClaw 在初始化时会让你选模型提供商并填 API Key如果你同时想试不同模型每换一次就要去对应平台控制台复制一次 Key很麻烦。TaoToken 提供统一的 API 通道Base URL 固定Key 也统一管理切换模型只需要改 Model ID。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 Base URL 使用。Key 的获取入口在控制台的 API Keys 页面登录后创建即可。模型对话入口可以用来先验证 Key 是否可用确认通道通了再去配 OpenClaw能省掉不少来回排查的时间。这里有个细节OpenClaw 初始化时如果让你填的是完整的 chat completions 端点记得在 Base URL 后面按它要求的格式补全路径。不同版本引导文案略有差异以你实际看到的输入框提示为准。核心是三件套要对齐——Base URL、API Key、Model ID缺一个都会在请求阶段报错。2.3 PowerShell 执行通道的权限边界OpenClaw 要操控电脑底层依赖 PowerShell 执行命令。Windows 默认的执行策略可能会拦截脚本所以需要确认当前策略Get-ExecutionPolicy -List如果 CurrentUser 这一行是 Restricted脚本类操作会被挡。可以针对当前用户放开Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSignedRemoteSigned 的含义是本地写的脚本可以直接跑从网络下载的脚本需要签名。这比 Unrestricted 安全也比 Restricted 实用。改完之后再查一次确认生效。另外安装和首次启动建议用管理员身份打开 PowerShell因为部分操作涉及写入系统目录和注册后台服务。但日常使用不建议一直挂着管理员权限权限越大误操作的影响面越大。3. 可复制配置OpenClaw 安装与模型接入片段3.1 一键安装脚本以管理员身份打开 PowerShell执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex这条命令会下载安装脚本并直接执行。安装过程会自动处理依赖等待完成即可。装完后输入openclaw启动引导。3.2 初始化引导与配置文件引导过程会依次问你选模型提供商、填 API Key、是否安装 Skills、是否接入聊天软件、是否开机自启。模型这块选自定义或 OpenAI 兼容通道然后填入 TaoToken 的信息。如果引导跳过了可以手动执行openclaw onboard --install-daemon配置文件通常落在用户目录下的.openclaw文件夹里。下面是一个 JSON 结构的配置片段路径和字段名以你本地实际生成的为准这里给出的是对齐三件套的写法{ provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514, gateway: { port: 18789, host: 127.0.0.1 }, skills: { enabled: true, workspace: C:\\Users\\你的用户名\\openclaw-workspace } }几个关键点说明一下。baseUrl填 TaoToken 的 API 地址不要带多余路径。apiKey换成你在控制台创建的那一串。model填你要用的 Model ID想换模型只改这一行。workspace是 AI 操作文件的工作目录强烈建议单独建一个目录不要直接指向桌面或整个 C 盘这样即使指令有问题影响范围也可控。如果你更习惯 TOML 风格部分版本也支持[provider] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514 [gateway] port 18789 host 127.0.0.1 [skills] enabled true workspace C:\\Users\\你的用户名\\openclaw-workspace改完配置后重启服务让配置生效openclaw daemon stop openclaw daemon start openclaw daemon status3.3 端口与工作目录调整默认端口 18789如果被占用启动时会报错。可以换端口openclaw gateway --port 18790 --verbose--verbose会打印详细日志排查连接问题时很有用。工作目录建议在配置文件里固定避免每次启动都问。4. 验证请求让 AI 完成一次真实的文件整理任务配置好之后最关键的一步是验证它真的能操控电脑而不是只回你一段文字。下面用一个完整的文件整理任务来验证。4.1 准备测试数据先在工作目录下造一批测试文件$ws C:\Users\你的用户名\openclaw-workspace New-Item -ItemType Directory -Force -Path $ws\test-files | Out-Null 1..5 | ForEach-Object { New-Item -ItemType File -Force -Path $ws\test-files\photo_2024-0$_.jpg | Out-Null } Get-ChildItem $ws\test-files这段脚本会在 test-files 目录里生成 5 个模拟图片文件文件名带日期。4.2 通过命令行触发任务OpenClaw 支持直接跑单条指令来验证 Skills 是否工作openclaw run 把 test-files 目录里的文件按文件名中的日期分类到对应子文件夹执行后观察输出。正常情况下它会解析你的意图生成对应的 PowerShell 操作然后实际执行。执行完再列一次目录Get-ChildItem $ws\test-files -Recurse如果看到类似2024-01、2024-02这样的子文件夹并且文件被移动进去了说明执行通道完全打通。4.3 通过 Web UI 验证浏览器打开http://localhost:18789在对话框里输入同样的自然语言指令比如“帮我看看 C 盘还剩多少空间”“列出工作目录下的所有文件”。它会调用 PowerShell 拿到真实结果再返回给你。这一步能确认模型通道和执行通道是协同工作的而不是只有一边通。4.4 确认模型通道如果任务能执行但回复内容很奇怪或者报模型相关错误先去 TaoToken 的模型对话入口发一条测试消息确认 Key 和 Model ID 没问题。模型通道和执行通道是两条独立的链路分开验证能快速定位问题在哪一侧。5. 本篇常见错排查401、local proxy failed 与 reading choices5.1 401 Unauthorized这是最常见的报错基本都出在 Key 上。可能的原因Key 复制时带了空格或换行Key 已经失效或被删除Base URL 和 Key 不匹配比如把 A 平台的 Key 填到了 B 平台的地址上。排查方法是在 TaoToken 控制台重新创建一个 Key完整复制后粘贴到配置里注意不要手动改动任何字符。改完重启 daemon。5.2 local proxy failed这个报错通常出现在网关启动阶段含义是本地代理端口没起来。常见原因是端口被占用或者上一次的进程没退干净。先查端口netstat -ano | findstr 18789如果有残留进程用任务管理器结束或者换端口启动openclaw gateway --port 18790 --verbose如果换端口能起来说明就是端口冲突把配置文件里的端口改掉即可。5.3 reading choices 相关报错这类报错一般出现在解析模型返回结果时说明返回结构不符合预期。可能原因Model ID 填错了导致返回的是错误信息而不是正常响应Base URL 路径不对请求打到了错误的端点。解决方法是先用模型对话入口确认当前 Model ID 能正常返回再把同样的值填进 OpenClaw 配置。三件套 Base URL、Key、Model ID 必须完全一致。5.4 OAuth 相关报错部分版本在接入某些提供商时会走 OAuth 流程如果本地回调地址被占用或浏览器拦截就会卡住。这种情况建议改用 API Key 方式接入也就是走 TaoToken 的统一通道绕开 OAuth 回调。配置里把 provider 设成 openai-compatible填 Base URL 和 Key 即可。5.5 权限与执行策略报错如果报“无法加载脚本”或“禁止运行脚本”回到第 2.3 节检查执行策略。另外确认 PowerShell 是以管理员身份打开的。WSL2 场景下如果网络异常可以重置wsl --shutdown netsh winsock reset netsh int ip reset执行完重启电脑再试。6. 把通道固定下来长期使用与 Coding Plan 的选择跑通一次之后接下来要考虑的是怎么稳定用下去。我的建议是把配置固定成一份不要每次启动都重新引导。配置文件里的 workspace 单独建目录模型切换只改 Model ID 一行这样日常维护成本很低。如果你打算长期用 AI 做编码和 Agent 类任务可以关注 TaoToken 的 Coding Plan它针对持续性的编码场景做了额度规划比按次调用更划算。接入文档里有不同语言和框架的示例照着改 Base URL 和 Key 就能接进自己的项目。API Keys 页面负责日常的 Key 管理创建、删除、查看用量都在那里。最后提醒一句AI 操控电脑的能力越强越要守住工作目录这条线。我自己的做法是给 OpenClaw 单独开一个 workspace所有文件操作都限制在里面涉及系统级命令时先让它把命令打印出来我确认没问题再执行。这样既享受了自动化的效率也不会因为一条错误指令把重要文件搞乱。
