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 系统与工具检查先确认系统版本WinR输入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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 注意这个地址不带任何查询参数。先去控制台建 Key入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。建完复制那串sk-开头的 Key后面配置里要用。想先确认模型能不能正常对话可以直接在模型对话页试 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。注意Key 只存在本地配置文件里别提交到 Git 仓库也别贴到聊天群里。泄露了就去控制台吊销重建。4. 可复制配置settings.json 与 config.toml 骨架OpenClaw 的配置目录在$env:USERPROFILE\.openclaw\。先建目录再写文件New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.openclaw4.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 cliallowInputSimulation打开后才能模拟鼠标键盘allowScreenCapture打开后才能抓屏做视觉定位。这两个不开后面跑 demo 会静默失败。4.3 对接 CC Switch / Cline如果你平时用 CC Switch 或 Cline 这类工具它们也支持自定义 API 通道填法一致Base URL 填https://taotoken.net/apiAPI Key 填同一个sk-Key模型名从上面models列表里选。这样 OpenClaw 和编辑器插件共用一套 Key额度统一在控制台看不用分别记账。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到字段对不上可以翻一下。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通道下你配的那个模型即可。然后跑官方 demoopenclaw 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 低于 22node -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找到 PIDtaskkill /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_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。Claude Code 相关的接入说明在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite 。配置改完记得openclaw restart让新参数生效别改完文件就直接测那样读的还是旧配置。
Windows电脑部署OpenClaw保姆级教程（2026最新版）：TaoToken统一Key接入与PowerShell验证
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 系统与工具检查先确认系统版本WinR输入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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 注意这个地址不带任何查询参数。先去控制台建 Key入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。建完复制那串sk-开头的 Key后面配置里要用。想先确认模型能不能正常对话可以直接在模型对话页试 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。注意Key 只存在本地配置文件里别提交到 Git 仓库也别贴到聊天群里。泄露了就去控制台吊销重建。4. 可复制配置settings.json 与 config.toml 骨架OpenClaw 的配置目录在$env:USERPROFILE\.openclaw\。先建目录再写文件New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.openclaw4.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 cliallowInputSimulation打开后才能模拟鼠标键盘allowScreenCapture打开后才能抓屏做视觉定位。这两个不开后面跑 demo 会静默失败。4.3 对接 CC Switch / Cline如果你平时用 CC Switch 或 Cline 这类工具它们也支持自定义 API 通道填法一致Base URL 填https://taotoken.net/apiAPI Key 填同一个sk-Key模型名从上面models列表里选。这样 OpenClaw 和编辑器插件共用一套 Key额度统一在控制台看不用分别记账。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到字段对不上可以翻一下。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通道下你配的那个模型即可。然后跑官方 demoopenclaw 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 低于 22node -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找到 PIDtaskkill /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_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。Claude Code 相关的接入说明在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite 。配置改完记得openclaw restart让新参数生效别改完文件就直接测那样读的还是旧配置。