1. Windows 10 部署 OpenClaw 龙虾踩坑记Node.js 环境准备与 PowerShell 权限问题OpenClaw 龙虾是一个开源的本地 AI Agent 运行框架能让你在自己的 Windows 电脑上跑起一个可对话、可执行工具调用的智能助手。它支持接入任意 OpenAI 或 Anthropic 兼容的模型端点适合想在本机做 AI 自动化实验、又不想把数据发到第三方平台的开发者。我第一次在 Windows 10 上装它的时候以为跟装个 npm 包差不多结果从 Node.js 版本到 PowerShell 执行策略再到 Gateway 服务注册一路踩了四五个坑。这篇文章把整个流程拆开每一步都给可复制的命令和配置片段你照着做就能在本地跑通并确认服务可用。先说清楚整体链路OpenClaw 本体是一个 Node.js 应用通过 npm 全局安装它的核心进程叫 Gateway默认监听ws://127.0.0.1:18789同时提供一个 Web 控制台http://127.0.0.1:18789/。模型接入走的是「自定义 Provider」模式你填 Base URL、API Key、Model ID 三件套就行。Windows 10 上最容易出问题的三个点一是 Node.js 版本太低导致安装脚本报错二是 PowerShell 默认禁止运行脚本让iwr | iex直接失败三是 Gateway 服务用schtasks注册计划任务时被系统策略拒绝。下面逐个解决。环境准备阶段你需要确认三样东西Node.js 版本、npm 版本、PowerShell 执行策略。Node.js 建议 22 以上我实测用的是 v24.14.0npm 自带 11.9.0。如果你机器上还是 Node 16 甚至更老先卸载再装新版别想着兼容。PowerShell 这边Windows 10 默认的 Restricted 策略会让安装脚本跑不起来需要临时放开当前用户的执行权限。# 检查 Node.js 和 npm 版本 node -v npm.cmd -v # 查看当前 PowerShell 执行策略 Get-ExecutionPolicy -List # 如果 CurrentUser 是 Restricted改成 RemoteSigned Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force # 再次确认 Get-ExecutionPolicy -Scope CurrentUser这里有个细节在 PowerShell 里直接敲npm -v有时会报「无法加载文件 npm.ps1因为在此系统上禁止运行脚本」这是因为 npm 的 PowerShell 包装脚本被策略拦了。用npm.cmd -v可以绕过或者把执行策略改成 RemoteSigned 之后npm -v也能正常用。我建议直接改策略后面 OpenClaw 的安装脚本也依赖这个。Node.js 安装包从官网下 msi 就行装的时候勾选「Add to PATH」省得手动配环境变量。装完开一个新的 PowerShell 窗口再验证老窗口的 PATH 不会自动刷新。如果你之前装过 nvm-windows 之类的版本管理器注意确认当前node -v指向的是你想要的版本别被旧版本截胡。还有一个容易被忽略的点Windows 10 的 PowerShell 版本。Win10 自带的是 Windows PowerShell 5.1而 OpenClaw 的安装脚本里有些语法在 5.1 上跑没问题但如果你装了 PowerShell 7 并且默认用 pwsh行为会略有差异。我建议统一用 Windows PowerShell 5.1 来跑安装减少变量。确认方式$PSVersionTable.PSVersion如果显示 5.1.x 就对了。到这一步环境准备完成可以进入安装环节。记住核心检索词Windows 10 部署 OpenClaw 龙虾关键前置就是 Node.js 版本达标加 PowerShell 策略放开这两步不做后面全是报错。2. TaoToken 前置配置获取 GLM-5 接入所需的 Base URL 与 API KeyOpenClaw 装好之后它自己不带模型你得给它接一个。这篇用 GLM-5 做示例走的是 Anthropic 兼容端点。在配置之前你需要先拿到三样东西Base URL、API Key、Model ID。这三件套是后面 OpenClaw 配置向导里必须填的缺一个都验证不过。Base URL 是模型服务的接口地址格式通常是https://xxx/v1或者不带/v1的根地址具体看服务商文档。API Key 是你的访问凭证一般是一串长字符串创建后只显示一次记得当场复制存好。Model ID 是模型的唯一标识比如ZhipuAI/GLM-5这种带命名空间的形式不能简写成glm5否则请求会返回模型不存在的错误。如果你用的是 TaoToken 这类聚合接入服务获取流程大致是这样先到官网注册账号然后进控制台创建 API Key。TaoToken 的 API 地址是https://taotoken.net/api控制台里可以管理密钥和查看可用模型列表。创建 Key 的时候建议选长期有效避免调试到一半过期。拿到 Key 之后去模型列表页确认 GLM-5 的准确 Model ID复制下来。这里要强调一个常见误区很多人以为 Base URL 填https://taotoken.net就行实际上要填到 API 路径层级。OpenClaw 的 Custom Provider 会拿你填的 Base URL 去拼/v1/messages或/v1/chat/completions所以 Base URL 应该是https://taotoken.net/api这种已经包含版本路径的形式。填错了会直接 404 或者 401。三件套准备好之后建议先在 PowerShell 里用 curl 快速验证一下 Key 是否有效别等到 OpenClaw 配置向导里才发现问题。验证命令# 把 $API_KEY 换成你的真实 Key $API_KEY sk-xxxxxxxxxxxxxxxx # 列出可用模型确认 GLM-5 在列表里 curl.exe -s https://taotoken.net/api/v1/models -H Authorization: Bearer $API_KEY | ConvertFrom-Json | Select-Object -ExpandProperty data | Select-Object id如果返回的列表里有ZhipuAI/GLM-5或者类似的 ID说明 Key 有效且模型可用。如果返回 401检查 Key 有没有复制完整、有没有多余空格。如果返回 403可能是账号权限或余额问题。这一步过了后面 OpenClaw 里的验证基本不会卡在鉴权上。另外提醒一点API Key 不要硬编码在会提交到 Git 的配置文件里。OpenClaw 的配置存在C:\Users\你的用户名\.openclaw\openclaw.json这个文件默认在用户目录下不会被 Git 追踪相对安全。但如果你要分享配置片段记得把 Key 打码。TaoToken 的 Coding Plan 适合长期跑 Agent 的场景如果你打算让 OpenClaw 持续做编码辅助或者自动化任务可以了解一下它的套餐。模型对话页面则适合先手动测试模型响应质量确认 GLM-5 的输出符合预期再接入 OpenClaw。接入文档里有各语言的调用示例配置卡住的时候可以对照看。3. 可复制配置OpenClaw 安装命令与 openclaw.json 关键字段这一节是核心操作部分所有命令都可以直接复制到 PowerShell 里跑。先装 OpenClaw 本体再走配置向导最后检查生成的配置文件。安装命令是一行iwr -useb https://openclaw.ai/install.ps1 | iex跑完之后你会看到安装器输出检测到 Windows 和 Node.js 版本然后开始装openclawlatest。装完会提示版本号类似OpenClaw 2026.3.13。接着自动进入 onboarding 向导。向导第一步是安全警告让你确认理解这是个人 Agent、默认单用户边界。选 Yes 继续。第二步选 Onboarding 模式选 QuickStart后面细节可以再改。第三步是 Gateway 配置默认端口 18789、绑定 Loopback、Token 认证直接确认。第四步是模型 Provider 选择这是关键。列表里选Custom Provider (Any OpenAI or Anthropic compatible endpoint)。然后依次填API Base URL填你的接入地址比如https://taotoken.net/apiAPI Key 提供方式选Paste API key nowAPI Key粘贴你的 KeyEndpoint compatibility选Anthropic-compatible (Uses /messages)Model ID填ZhipuAI/GLM-5Endpoint ID等验证成功后自动生成直接回车Model alias可留空直接回车验证成功会显示Verification successful。如果这里报错多半是 Base URL 或 Model ID 不对回到上一节用 curl 再确认一遍。接下来是通道选择QuickStart 会列出 Telegram、Discord、飞书等。如果你只是本地测试选Skip for now后面可以用openclaw channels add再加。Web 搜索 Provider 也选 Skip没有 Key 的话 web_search 用不了但不影响核心对话。Skills 配置选 NoHooks 配置里用方向键选中session-memory按空格变成[]状态回车确认。这一步会让 Agent 在/new或/reset时把会话上下文存到记忆里对长期使用有帮助。向导跑完会生成配置文件C:\Users\用户名\.openclaw\openclaw.json。这个文件是 JSON 格式关键字段结构如下{ gateway: { port: 18789, bind: loopback, auth: token }, models: { providers: { custom-api-inference-modelscope-cn: { baseUrl: https://taotoken.net/api, apiKey: sk-xxxxxxxxxxxxxxxx, compatibility: anthropic, models: [ { id: ZhipuAI/GLM-5, alias: } ] } } }, hooks: { session-memory: { enabled: true } } }注意baseUrl和apiKey要和你实际填的一致compatibility字段对应你选的 Anthropic-compatible。如果你后面要换模型改models[].id就行不用重跑整个向导。配置文件生成后向导会尝试注册 Gateway 服务。在 Windows 10 上这一步经常失败报schtasks create failed原因是计划任务创建被系统策略拒绝。向导会提示回退到用户启动文件夹方式或者让你用管理员权限重跑。我的建议是先别管服务注册直接手动启动 Gateway 验证功能服务化的事后面再说。手动启动命令openclaw.cmd gateway正常输出会显示监听地址、PID、日志文件路径以及加载的 hook 列表。看到listening on ws://127.0.0.1:18789就说明 Gateway 起来了。这时候别关这个窗口另开一个 PowerShell 做后续验证。4. 验证请求确认 Gateway 监听与控制台可访问Gateway 启动后第一件事是确认端口真的在监听。用netstat或者Test-NetConnection都行# 检查 18789 端口是否在监听 netstat -ano | Select-String 18789 # 或者用 Test-NetConnection Test-NetConnection -ComputerName 127.0.0.1 -Port 18789netstat输出里应该能看到LISTENING状态和对应的 PID。Test-NetConnection的TcpTestSucceeded应该是True。如果端口没监听说明 Gateway 没起来或者启动时报错了回头看上一个窗口的日志。接着访问 Web 控制台。Gateway 启动日志里会打印一个带 token 的 URL类似http://127.0.0.1:18789/#token3e1e45fc925077d37a0fea7071c8edd34551d1bc2e8d8e63把这个 URL 复制到浏览器打开应该能看到 OpenClaw Control 界面。如果提示连接失败检查两点一是 Gateway 窗口是否还在运行二是 URL 里的 token 是否完整复制了。token 是每次启动随机生成的重启 Gateway 后旧 token 失效要用新的。控制台打开后你可以直接在 WebChat 里发一条消息测试模型响应。比如输入「你好请用一句话介绍你自己」。如果模型配置正确几秒内会返回 GLM-5 的回复。如果一直转圈或者报错看 Gateway 窗口的日志输出常见错误有401 UnauthorizedAPI Key 无效或过期model not foundModel ID 拼写错误connection refusedBase URL 不可达日志文件路径在启动时会打印类似C:\Users\用户名\AppData\Local\Temp\openclaw\openclaw-2026-03-15.log出问题的时候直接看这个文件最准。除了 Web 控制台你也可以用命令行验证 Gateway 的 WebSocket 接口。OpenClaw 提供了一个 health check 机制不过最直接的方式还是看启动日志里的[gateway] listening on那一行。如果那行出现了且端口测试通过基本就稳了。还有一个验证点模型上下文窗口。Gateway 启动日志里可能会打印low context window: ... ctx16000 (warn32000)。这说明 GLM-5 在当前配置下上报的上下文窗口是 16000 token低于 OpenClaw 建议的 32000 阈值会触发警告但不影响使用。如果你要处理长文档可能需要换一个上下文更大的模型或者调整 OpenClaw 的 compaction 策略。到这一步如果 Web 控制台能正常对话说明整条链路——Node.js 运行时、OpenClaw Gateway、模型 Provider、API Key 鉴权——全部打通。你可以开始让 Agent 执行工具调用了比如让它读一个本地文件、跑一条命令。不过工具权限默认是受限的需要在配置里显式开启。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 报错对照这一节把我在 Windows 10 部署 OpenClaw 过程中实际遇到的报错整理出来每个都给排查方向。你遇到问题时可以对照着看。报错一401 Unauthorized这是最常见的鉴权失败。可能原因有三个API Key 复制时带了空格或换行、Key 已过期或被撤销、Base URL 和 Key 不匹配比如 Key 是 A 平台的Base URL 填了 B 平台。排查方法用第 2 节的 curl 命令单独测 Key如果 curl 也 401就是 Key 本身的问题如果 curl 成功但 OpenClaw 报 401检查openclaw.json里apiKey字段有没有被截断。报错二local proxy failed / connection refused这个报错通常出现在 Gateway 启动阶段提示无法绑定端口或者无法连接上游。如果是绑定失败检查 18789 端口是否被其他程序占用用netstat -ano | Select-String 18789看 PID然后在任务管理器里结束那个进程。如果是连接上游失败检查 Base URL 是否可达用Test-NetConnection测一下域名解析和端口连通性。公司网络环境下可能有防火墙拦截需要找 IT 放行。报错三reading choices / unexpected response format这个报错说明 OpenClaw 拿到了模型响应但解析失败。最常见的原因是 Endpoint compatibility 选错了。如果你选的是OpenAI-compatible但实际端点返回的是 Anthropic 格式或者反过来解析就会失败。回到配置向导或者直接改openclaw.json里的compatibility字段Anthropic 端点填anthropicOpenAI 端点填openai。另一个可能是 Model ID 不对服务端返回了错误信息而不是正常的 choices 数组。报错四OAuth / token expired如果你用的是需要 OAuth 刷新的接入方式token 过期后会报这个。OpenClaw 的 Custom Provider 模式用的是静态 API Key一般不会遇到 OAuth 问题。但如果你接的是某些需要 OAuth 的官方端点需要在外部刷新 token 后更新配置。排查方法确认你的接入方式是否支持静态 Key如果不支持考虑换一个支持静态 Key 的端点。报错五schtasks create failed这是 Windows 特有的服务注册失败出现在 onboarding 最后阶段。原因是当前用户没有创建计划任务的权限。解决方案有两个一是用管理员权限重跑 PowerShell再执行openclaw gateway install二是跳过服务安装每次手动用openclaw.cmd gateway启动。手动启动的缺点是关掉窗口 Gateway 就停了适合调试阶段。要长期运行的话可以把启动命令写成一个.ps1脚本放到启动文件夹里。报错六gateway closed (1006 abnormal closure)Web 控制台连不上 Gateway 时常见。1006 表示 WebSocket 异常关闭通常是因为 Gateway 进程已经退出了。检查 Gateway 窗口是否还在如果已经关了重新openclaw.cmd gateway启动。如果 Gateway 在运行但控制台还是报 1006可能是 token 不匹配用最新启动日志里的 URL 重新打开。排查通用思路先看 Gateway 窗口的实时日志再看日志文件最后用 curl 单独测模型端点。三层定位基本能覆盖 90% 的问题。6. 语义一致 CTAGLM-5 接入后的模型验证与长期编码方案Gateway 跑起来、Web 控制台能对话之后建议先做一轮模型验证确认 GLM-5 在你的实际使用场景下表现符合预期。验证方式很简单在控制台里发几条不同类型的请求比如代码生成、文本总结、多轮对话看响应质量和延迟。如果发现模型对某些任务响应不好可以在配置里换 Model ID 试试其他模型不用重装 OpenClaw。模型验证阶段可以用模型对话页面手动测试对比不同模型在相同 prompt 下的输出。确认 GLM-5 适合你的场景后再把它固定到 OpenClaw 配置里。如果你打算让 OpenClaw 长期跑编码辅助或者自动化 Agent 任务Coding Plan 提供了更适合持续调用的套餐。接入文档里有完整的 API 参考和配置示例遇到配置字段不确定的时候可以查。API Keys 管理页面可以创建和撤销密钥建议为 OpenClaw 单独创建一个 Key方便追踪用量和在泄露时快速撤销。最后说一个实用技巧OpenClaw 的配置文件openclaw.json支持热重载部分字段改完模型配置后不用重启 Gateway在控制台发一条新消息就会用新配置。但 Gateway 端口、绑定地址这类字段改了必须重启。我习惯把常用配置备份一份到openclaw.json.bak向导每次覆盖配置时会自动生成备份出问题可以回滚。到这一步你的 Windows 10 上应该已经有一个能对话、能调工具的 OpenClaw 龙虾在跑了。接下来可以探索 Skills 和 Hooks让它做更多自动化的事。