Windows系统部署OpenClaw龙虾保姆级教程，轻松搭建专属AI Agent

1. Windows 部署 OpenClaw 龙虾前先把 Node.js 与 PowerShell 环境理顺OpenClaw 龙虾是一个可以在本地跑起来的 AI Agent 运行框架它能读取你电脑上的文件、执行命令、调用大模型完成多步任务适合想在 Windows 上搭建专属智能助手的开发者。它和那种纯网页聊天工具不一样OpenClaw 更像一个“住在你电脑里的执行器”你给它一句自然语言指令它会自己规划步骤、调用工具、把结果落盘。我第一次接触它的时候最直观的感受是原来 Agent 不是只能跑在服务器上Windows 本地也能玩得很顺。不过 Windows 环境和 Linux 差异不小很多教程默认你在 macOS 或 Ubuntu 上操作直接照搬到 PowerShell 里就会遇到路径、权限、环境变量各种坑。这篇就按 Windows 原生环境来不依赖 WSL也不需要额外的虚拟化层用 Node.js PowerShell 从零把 OpenClaw 龙虾跑起来并且接入 TaoToken 的统一 Key/API 通道让模型调用走一个稳定的入口。先说清楚适合谁看如果你已经装过 Node.js会用 PowerShell 敲几条命令想拥有一个能读写本地文件、能持续对话、能开机自启的 AI Agent那这篇就是给你写的。如果你完全没碰过命令行也没关系我会把每条命令的作用和预期输出都写出来照着做就行。部署前需要准备的东西其实不多一台 Windows 10 或 Windows 11 的机器管理员权限的 PowerShell 窗口以及一个可用的模型 API Key。这里我推荐用 TaoToken 的统一通道原因是它把多家模型的接入方式统一成一套 Base URL Key Model ID 的组合后面换模型只需要改一个字符串不用重新折腾配置。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后到控制台拿 Key 即可。环境检查这一步别跳过。很多人后面报openclaw 不是内部或外部命令根源就是 Node.js 没装好或者 npm 全局路径没进 PATH。我们先把三样东西确认到位Node.js、npm、Git。Git 不是必须但 OpenClaw 某些技能包会依赖它拉取仓库装上省事。以管理员身份打开 PowerShell 的方法是右键点击开始菜单选择“Windows PowerShell(管理员)”或“终端(管理员)”。然后依次执行下面几条命令看看版本号能不能正常打印node -v npm -v git -v正常的话会分别输出类似v20.11.0、10.2.4、git version 2.43.0这样的结果。如果node或npm报“无法将项识别为 cmdlet”说明 Node.js 没装或者没进 PATH去 Node.js 官网下载 LTS 版本安装包安装时保持默认选项它会自动把路径写进环境变量。装完关掉当前 PowerShell 重新开一个再验证一次。还有一个容易被忽略的点是 PowerShell 的执行策略。Windows 默认会拦截脚本执行后面我们写开机自启脚本时会用到.ps1文件所以提前把当前用户的执行策略设为 RemoteSignedSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser执行后会提示你确认输入Y回车。这个设置只影响当前用户不会动系统级策略相对安全。做完这几步基础环境就算齐了。接下来进入 OpenClaw 本体的安装和初始化。2. TaoToken 统一 Key 通道准备Base URL、API Key 与模型 ID 三件套在装 OpenClaw 之前先把模型通道准备好这样初始化配置时可以直接填不用中途停下来找 Key。TaoToken 的作用是把模型调用统一到一个入口你拿到的是一套标准的 OpenAI 兼容接口Base URL 固定Key 在控制台生成模型 ID 按需选择。对 OpenClaw 来说它只关心三件事请求发到哪个地址、用哪个 Key 认证、调哪个模型。先到控制台创建 API Key。打开 https://taotoken.net/api 这个 API 入口域名或者从官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进控制台找到 API Keys 页面点新建复制生成的 Key。这个 Key 只显示一次建议先粘到记事本里临时存着。注意不要把它提交到 Git 仓库后面我们会用环境变量的方式引用避免硬编码。三件套的具体内容是这样的配置项值说明Base URLhttps://taotoken.net/api所有请求的统一入口不加 UTM 参数API Key控制台生成的sk-开头字符串认证凭证走环境变量注入Model ID例如claude-sonnet-4-20250514按控制台模型列表填写这里要强调一下 Base URL 的写法。OpenClaw 底层走的是 OpenAI 兼容协议所以 Base URL 填到/api这一层就行不要自己补/v1/chat/completions框架会自己拼路径。我试过手动补全路径结果请求 404排查了半天才发现是画蛇添足。Key 的管理建议用环境变量而不是写死在配置文件里。Windows 下设置用户级环境变量有两种方式一种是图形界面一种是 PowerShell 命令。命令行方式更快[Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, sk-你的Key, User) [Environment]::SetEnvironmentVariable(TAOTOKEN_BASE_URL, https://taotoken.net/api, User)设置完要新开一个 PowerShell 窗口才能读到因为环境变量在进程启动时加载。验证是否写入成功echo $env:TAOTOKEN_API_KEY echo $env:TAOTOKEN_BASE_URL能打印出对应值就说明 OK。如果打印为空检查是不是在同一个窗口里设置的——当前窗口的$env:只反映进程内变量用SetEnvironmentVariable写的是持久化的用户变量需要新窗口读取。模型 ID 这块TaoToken 控制台会列出当前可用的模型。选一个适合 Agent 场景的Agent 需要多步推理和工具调用建议选指令跟随能力强的模型。把选好的 Model ID 也记下来初始化 OpenClaw 时会用到。如果你后面想换模型只改这一个字符串就行Base URL 和 Key 都不用动这就是统一通道的好处。顺便提一句如果你打算长期跑 Agent 任务比如让它定时处理文件、做代码辅助可以关注一下 Coding Plan 这类长期方案入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按需选择即可。现在三件套齐了开始装 OpenClaw。3. 可复制配置npm 安装 OpenClaw 与 onboard 初始化全流程安装 OpenClaw 本体用 npm 全局安装一条命令搞定。在管理员 PowerShell 里执行npm install -g openclawlatest这条命令会从 npm 源拉取最新版并装到全局目录。安装过程中如果看到added X packages之类的回显说明成功。如果卡在idealTree很久不动多半是网络问题可以换 npm 镜像源重试npm config set registry https://registry.npmmirror.com装完后验证一下命令是否可用openclaw --version能打印版本号就说明全局命令注册成功。如果报“不是内部或外部命令”说明 npm 全局路径没进 PATH。用下面这条命令查一下全局路径npm config get prefix把打印出来的路径通常是C:\Users\你的用户名\AppData\Roaming\npm加到系统环境变量 Path 里重开 PowerShell 再试。接下来是初始化配置这是整个部署里交互最多的一步。执行openclaw onboard它会进入一个交互式向导逐项问你配置。我按实际会遇到的顺序说明每一项怎么选第一步会问是否继续部署选yes回车。然后问配置模式选QuickStart它会用一套默认模板帮你快速跑起来后面需要改再改。接着问模型供应商。这里不要选内置的那些预设选自定义或 OpenAI 兼容选项然后手动填我们准备好的三件套。Base URL 填https://taotoken.net/apiAPI Key 粘贴你控制台生成的那个Model ID 填你选好的模型字符串。填完回车确认。再往后会问工具配置初次部署选skip for now先把基础对话跑通工具后面按需开。Skills 配置也选no跳过。日志和会话记录建议全部勾选用方向键移动、空格键选中回车确认。这些记录在排查问题时很有用。向导最后会启动 OpenClaw 的 Gateway 程序并自动打开浏览器到一个本地管理页面。默认端口是 18789地址类似http://localhost:18789。如果浏览器没自动弹手动访问这个地址即可。初始化完成后OpenClaw 会在你的用户目录下生成配置文件。Windows 下路径通常是C:\Users\你的用户名\.openclaw\config.json这个文件里保存了模型通道、端口、日志等设置。如果你想手动核对或修改可以直接编辑它。一个典型的配置片段长这样{ gateway: { port: 18789, host: 127.0.0.1 }, model: { baseUrl: https://taotoken.net/api, apiKey: ${TAOTOKEN_API_KEY}, modelId: claude-sonnet-4-20250514 }, logging: { enabled: true, level: info } }注意apiKey这里用了${TAOTOKEN_API_KEY}的引用写法OpenClaw 启动时会从环境变量读取这样配置文件里就不会出现明文 Key。如果你在 onboard 时直接填了明文也可以手动改成这种引用形式更安全。配置改完需要重启 Gateway 生效。如果当前 Gateway 还在前台跑着按CtrlC停掉然后重新执行openclaw gateway run看到类似Gateway listening on 127.0.0.1:18789的输出就说明服务起来了。这一步是后面所有验证的前提Gateway 不在跑管理页面打不开Agent 也不会响应。4. 验证请求用一次对话和文件创建确认 Agent 正常响应配置跑通不代表 Agent 真能用得实际发一次请求看它有没有正确调用模型并执行动作。OpenClaw 的管理页面里有一个对话输入框我们用它做两个验证一个是纯对话看模型通道通不通一个是文件操作看 Agent 的工具执行能力。先做对话验证。在管理页面的输入框里输入一句简单的话比如“你好请用一句话介绍你自己”回车发送。正常情况下几秒内会返回模型的回复。如果返回了内容说明 Base URL、Key、Model ID 三件套都生效了请求成功打到了 TaoToken 通道并拿到了响应。再做文件操作验证这一步能确认 Agent 不只是聊天还能真正操作本地文件。在对话里输入在当前用户桌面创建一个名为 hi.txt 的文件内容写“OpenClaw 部署成功”然后告诉我文件的完整路径。Agent 会规划步骤定位桌面路径、创建文件、写入内容、返回路径。等它执行完去桌面看看hi.txt是不是真的出现了内容对不对。如果文件创建成功说明 Agent 的工具调用链路是通的。这里有个细节要注意OpenClaw 执行文件操作时工作目录很关键。如果你是在某个特定目录下启动的 GatewayAgent 的相对路径会基于那个目录。为了行为可预期建议在用户主目录下启动或者在配置里显式指定工作目录。我踩过的坑就是在一个临时目录里启动结果 Agent 把文件创建到了意想不到的地方找了半天。验证通过后你会面临一个实际问题现在 Gateway 是在前台窗口跑着的一旦关掉 PowerShell 窗口Agent 就停了。每次开机都要手动打开 PowerShell、敲openclaw gateway run这显然不现实。所以下一步要把它注册成 Windows 服务实现开机自启。注册服务用 NSSM 这个工具它能把任意可执行程序包装成 Windows 服务。思路是下载 NSSM用它把node.exe加上 OpenClaw 的入口脚本注册成服务设置好工作目录和环境变量配置自动重启然后启动。这样开机后服务自动拉起管理页面随时可访问。在写自启脚本之前先确认两个路径Node.js 的可执行文件路径以及 OpenClaw 的入口脚本路径。Node 通常在C:\Program Files\nodejs\node.exeOpenClaw 入口在 npm 全局目录下的node_modules\openclaw\dist\index.js。用下面命令确认where.exe node npm root -g第二条会打印全局模块根目录OpenClaw 入口就在它下面的openclaw\dist\index.js。把这两个路径记下来写脚本时要用。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth 报错部署过程中最容易卡住的不是安装而是各种报错。我把实际遇到过的几类整理出来对照着排查能省不少时间。第一类是认证失败典型报错是401 Unauthorized或invalid api key。原因通常是 Key 没读到或者填错了。先确认环境变量在当前进程里能读到echo $env:TAOTOKEN_API_KEY如果为空说明设置环境变量后没开新窗口。如果值对但还报 401检查配置文件里apiKey的引用写法是不是${TAOTOKEN_API_KEY}变量名有没有拼错。还有一种情况是 Key 复制时带了空格或换行粘到配置里就失效了重新复制一次。第二类是local proxy failed或连接被拒绝。这个报错说明 OpenClaw 尝试请求 Base URL 但连不上。先确认 Base URL 写的是https://taotoken.net/api没有多余路径。然后在 PowerShell 里直接测一下连通性Invoke-WebRequest -Uri https://taotoken.net/api -Method Head如果这条命令也失败说明本机网络到该地址不通检查防火墙或安全软件有没有拦截。如果这条能通但 OpenClaw 报错那多半是配置文件里的地址写错了逐字符核对。第三类是reading choices相关的报错通常表现为解析响应失败。这往往是因为请求打到了非 OpenAI 兼容的端点返回的 JSON 结构里没有choices字段。根源还是 Base URL 填错比如误填了某个具体模型的完整路径。记住 Base URL 只到/api剩下的交给框架。第四类是 OAuth 相关报错比如OAuth token expired或authentication flow failed。OpenClaw 某些技能会走 OAuth 授权如果你在 onboard 时跳过了工具配置后面启用时可能触发。解决办法是重新跑一次openclaw onboard在工具配置那一步选择配置而不是跳过按提示完成授权。如果只是基础对话不启用这些技能可以暂时忽略。还有一类是服务启动失败表现为Start-Service报错或者服务状态是 Stopped。这时候去看日志文件路径在C:\OpenClaw\Logs\openclaw-err.log用下面命令看最后几行Get-Content C:\OpenClaw\Logs\openclaw-err.log -Tail 20常见原因是 Node 路径或脚本路径写错服务找不到可执行文件。核对脚本里的$nodeExe和$scriptPath两个变量确保指向真实存在的文件。另一个原因是工作目录没设对OpenClaw 找不到配置文件在 NSSM 配置里加上AppDirectory指向用户主目录即可。排查时有个通用思路先确认 Gateway 在前台能跑通再考虑注册服务。前台跑不通的问题注册成服务只会更难查。所以建议顺序是前台openclaw gateway run验证对话和文件操作都正常再写自启脚本。6. 接入文档与后续把 OpenClaw 用起来的几个实用方向服务跑起来只是起点真正让 OpenClaw 有价值的是你用它做什么。这里给几个上手方向都是我自己试过觉得顺手的。第一个方向是本地文件整理。Agent 能读目录、能移动文件、能按规则重命名。你可以让它把下载文件夹里按扩展名分类或者把散落的截图按日期归档。这类任务规则明确、重复性高交给 Agent 很合适。指令写清楚规则就行比如“把 D:\Downloads 下的图片移到 D:\Pictures按年月建子文件夹”。第二个方向是代码辅助。OpenClaw 能读项目文件、能执行命令配合模型可以做代码解释、生成测试、批量重构。如果你在 Windows 上做开发让它帮你跑一遍 lint、整理 import、生成 commit message 都很顺手。这类场景对模型指令跟随能力要求高选模型时注意。第三个方向是定时任务。注册成 Windows 服务后OpenClaw 常驻后台你可以让它按计划执行任务比如每天早上汇总某个目录的变化、定时抓取信息整理成报告。这需要用到它的调度能力在配置里开启即可。如果你想把 OpenClaw 接到其他工具里比如编辑器插件或自动化平台接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有接口说明和示例。模型对话的在线体验入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 想先试试模型效果再去配 Agent 的话可以从这里进。API Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 需要新建或轮换 Key 时用得上。最后说一个实际经验OpenClaw 的配置文件和环境变量是两套东西改配置后要重启 Gateway改环境变量后要重开进程。很多人改了配置发现不生效就是忘了重启。养成习惯改完先CtrlC停掉再openclaw gateway run能省掉大量“为什么没生效”的困惑。服务模式下则是Restart-Service -Name OpenClawGateway效果一样。到这里Windows 本地部署 OpenClaw 龙虾的完整链路就走通了环境准备、通道配置、安装初始化、请求验证、报错排查、服务自启。接下来就是把它用起来让它替你处理那些重复又琐碎的事。