1. Windows 上跑 OpenClaw,真正卡住人的不是安装
OpenClaw 是一个轻量级开源 AI 自动化框架,社区里叫它“龙虾助手”。它能在 Windows 上做系统级控制:模拟鼠标点击、键盘输入、窗口切换,抓取屏幕内容做 UI 元素定位,还能通过 Telegram、微信、飞书这类渠道远程控制电脑执行任务。适合谁?适合想把重复桌面操作交给脚本、又不想依赖付费云服务的人,Intel/AMD 全系处理器都能跑,Win11 体验更好。
但我在 Windows 上部署时发现,真正让人卡住的从来不是npm install,而是三件事:PowerShell 默认禁止脚本执行、Node 版本低于 22 导致依赖装不上、以及装完之后模型 API 通道没配通,openclaw chat能进交互模式却回不了话。这篇就按完整链路走一遍:Node.js 环境准备、PowerShell 执行安装、TaoToken 统一 Key 接入、配置文件骨架、CC Switch/Cline 对接,最后用 PowerShell 命令验证 API 连通性。每一步都给可复制的命令和配置片段,你照着敲就能在本地跑通。
2. 部署前置:Node.js 22 与 PowerShell 权限
2.1 系统与工具检查
先确认系统版本,Win+R输入winver回车,Windows 10 21H2+ 或 Windows 11 22H2+ 都行,64 位,内存 8GB 起步、16GB 更稳,留 5GB 以上磁盘空间。账户必须是管理员权限,后面装服务和改环境变量都要用。
核心依赖三个:PowerShell 7+、Git、Node.js 22+。Node 版本是硬门槛,低于 22 会在装依赖时报引擎不兼容。用 winget 一次装齐:
winget install Git.Git winget install OpenJS.NodeJS --version 22.9.0装完验证,三个版本号都要出来:
node -v; npm -v; git --version2.2 开启 PowerShell 脚本执行权限
Windows 默认禁止运行第三方脚本,不开启的话安装脚本第一步就报“禁止运行脚本”。以管理员身份打开 PowerShell,执行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入Y回车确认。这一步只影响当前用户,不会动系统全局策略,安全上可以放心。
2.3 安装 OpenClaw
一键脚本方式最省事,管理员 PowerShell 里执行:
iwr -useb https://openclaw.ai/install.ps1 | iex如果下载卡顿,换镜像脚本:
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex脚本跑完验证:
openclaw --version正常输出类似openclaw/0.8.2 win32-x64 node-v22.2.0。如果提示“无法将‘openclaw’项识别为 cmdlet”,是 npm 全局路径没进环境变量,补一下:
$npmPath = npm config get prefix [Environment]::SetEnvironmentVariable("Path", "$env:Path;$npmPath", "User")关掉当前窗口,重新以管理员身份打开 PowerShell,再验证一次。
3. TaoToken 前置:统一 Key 与 API 通道
OpenClaw 本身只是执行框架,真正让它“听懂人话”的是背后接的大模型。这里我用 TaoToken 做统一入口,一个 Key 就能调不同模型,省得在多个平台之间来回切。官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,API 基址是 https://taotoken.net/api ,注意这个地址不带任何查询参数。
先去控制台建 Key,入口在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ,Key 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。建完复制那串sk-开头的 Key,后面配置里要用。想先确认模型能不能正常对话,可以直接在模型对话页试: https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。
注意:Key 只存在本地配置文件里,别提交到 Git 仓库,也别贴到聊天群里。泄露了就去控制台吊销重建。
4. 可复制配置:settings.json 与 config.toml 骨架
OpenClaw 的配置目录在$env:USERPROFILE\.openclaw\。先建目录再写文件:
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.openclaw"4.1 settings.json
这个文件管模型通道和默认参数。用记事本打开:
notepad "$env:USERPROFILE\.openclaw\settings.json"粘贴下面这段,把sk-你的Key换成自己的:
{ "defaultModel": "claude-sonnet-4-5", "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的Key", "type": "anthropic", "models": [ "claude-sonnet-4-5", "claude-opus-4-1", "gpt-4o" ] } }, "timeout": 60000, "maxRetries": 3 }type字段按你实际调的模型族填,走 Anthropic 系就写anthropic,走 OpenAI 系写openai。baseUrl一定写https://taotoken.net/api,不要自己拼/v1之类的后缀,通道会自己路由。
4.2 config.toml
这个文件管运行时行为,比如日志级别、端口、权限开关:
[server] port = 3000 host = "127.0.0.1" [log] level = "info" path = "~/.openclaw/logs/openclaw.log" [permissions] allowFileSystem = true allowScreenCapture = true allowInputSimulation = true [channel] default = "cli"allowInputSimulation打开后才能模拟鼠标键盘,allowScreenCapture打开后才能抓屏做视觉定位。这两个不开,后面跑 demo 会静默失败。
4.3 对接 CC Switch / Cline
如果你平时用 CC Switch 或 Cline 这类工具,它们也支持自定义 API 通道,填法一致:Base URL 填https://taotoken.net/api,API Key 填同一个sk-Key,模型名从上面models列表里选。这样 OpenClaw 和编辑器插件共用一套 Key,额度统一在控制台看,不用分别记账。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ,遇到字段对不上可以翻一下。
5. 验证请求:PowerShell 确认 API 连通性
配置写完先别急着启动 OpenClaw,用一条 PowerShell 命令直接打 API,确认 Key 和通道是通的:
$headers = @{ "Authorization" = "Bearer sk-你的Key" "Content-Type" = "application/json" } $body = @{ model = "claude-sonnet-4-5" max_tokens = 64 messages = @(@{ role = "user"; content = "只回复两个字:通了" }) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri "https://taotoken.net/api/v1/messages" -Method Post -Headers $headers -Body $body返回里能看到content字段带文字,就说明 Key 有效、通道正常。如果报 401,是 Key 错了或没带Bearer;报 404,是路径拼错了,检查是不是多写了后缀。
通道确认后启动 OpenClaw 并初始化:
openclaw start openclaw onboard openclaw statusonboard首次运行会引导你选模型,选taotoken通道下你配的那个模型即可。然后跑官方 demo:
openclaw run demo再进交互模式实测一条指令:
openclaw chat输入“创建 test 文件夹,新建 hello.txt 并写入 Hello OpenClaw”,如果系统自动建了文件,说明部署和 API 通道都通了。Web 面板在浏览器访问http://localhost:3000,用初始化时设的密码登录。
6. 本篇常见错排查
报“禁止运行脚本”:PowerShell 执行策略没开,回到 2.2 执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser,输Y。
openclaw命令找不到:npm 全局路径没进环境变量,按 2.3 的修复命令补,然后重开 PowerShell。
装依赖报 Node 引擎不兼容:Node 低于 22,node -v确认,低了就卸了重装 22 LTS。
openclaw chat能进但模型不回话:八成是 settings.json 里baseUrl或apiKey写错。先用第 5 节的 PowerShell 命令单独测 API,通了再回来查配置。注意baseUrl只写https://taotoken.net/api。
鼠标键盘模拟没反应:config.toml里allowInputSimulation没开,或者 Windows 隐私设置里没给 OpenClaw 辅助功能权限。去“设置 → 隐私和安全性 → 无障碍”把 OpenClaw 加进授权列表,路径一般是C:\Users\你的用户名\AppData\Roaming\npm\openclaw.exe,改完重启服务。
端口 3000 被占用:netstat -ano | findstr :3000找到 PID,taskkill /PID 进程号 /F结束,或者改config.toml里的port。
要看详细日志:
openclaw logs --tail 100 openclaw logs --level debug日志文件在$env:USERPROFILE\.openclaw\logs\openclaw.log。
如果你打算长期跑编码类或 Agent 类任务,调用量会比较大,可以看下 Coding Plan: https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。Claude Code 相关的接入说明在 https://taotoken.net/claude-code?utm_source=taotoken_aicg_blog_end&utm_content=claude-code&utm_campaign=rewrite 。配置改完记得openclaw restart让新参数生效,别改完文件就直接测,那样读的还是旧配置。