【2026.5最新】OpenClaw Windows 保姆级安装教程 | 依赖配置+报错解决一次搞定

1.安装node.js

1.1下载地址为https://nodejs.org/zh-cn/download/https://nodejs.org/zh-cn/download/

选择 Windows 平台，推荐下载 Windows 安装程序 (.msi)（64 位系统对应 x64 版本，如 node-v24.16.0-x64.msi）1.2 准备安装
将下载好的 .msi 文件放到一个无中文、无空格的路径下（例如 D:\tool\nodejs\），避免后续因路径问题报错。

1.2.下载后放在自己特定的文件夹里面双击进行安装

路径选择自己要安装到的路径，最好不要放在C盘，放到其他盘，我就放到了D盘

1.3 安装过程中会遇到一个「Tools for Native Modules」的步骤，这里有个选项一定要注意！

因为我们后续要安装「龙虾」这类需要编译原生模块的项目，必须勾选 「Automatically install the necessary tools」。

勾选后，程序会自动装好 Python、VS Build Tools 这些编译需要的环境，还会顺带装个 Windows 包管理器 Chocolatey，安装完会自动弹个窗口跑配置脚本，不用自己折腾。

要是不勾这个选项，后面装「龙虾」的时候大概率会报找不到编译工具的错误，新手就直接选自动安装就行～

此时应该是会卡主，如果不是已管理身份运行

1.4 此时在开始，搜索nodejs

找到这个后以管理员身份运行

脚本安装详细内容解释

组件名称	全称 / 说明	核心作用	对你的项目的意义
Visual Studio Build Tools	微软 C/C++ 构建工具集	提供 C/C++ 编译器（MSVC）、Windows SDK、构建工具，是编译原生模块的核心	没有它，你的项目里的 C/C++ 代码根本无法被编译，npm install 会直接报错
Python	Python 运行环境（脚本会自动安装兼容版本）	为 Node.js 的构建工具`node-gyp`提供运行环境，执行构建配置脚本	`node-gyp` （Node.js 官方的原生模块构建工具）依赖 Python 运行，没有 Python 就无法启动编译流程
Chocolatey	Windows 平台的包管理器	一个自动化的工具安装 / 管理工具，脚本用它来自动下载、安装上面的 Python 和 Build Tools，不用你手动找安装包、配置环境	相当于帮你「一键托管」了所有依赖的安装流程，避免手动安装时的各种坑
Required Windows Updates	必要的 Windows 系统更新	安装 Build Tools/Python 所需的系统运行库、API 补丁，确保工具能正常运行	很多旧版本 Windows 会因为缺少特定更新，导致 Build Tools 安装失败或运行报错

1.5 之后点击任意键，一直到弹出powershell为止，进行安装必要的文件，这个比较耗时要一直等

1.6 按enter键，结束

1.7 检查

打开命令提示符，输入

node -v

如果显示版本则显示安装好了

npm -v

2. 安装OpenClaw

2.1打开powershell，并且已管理员身份运行

并且输入以下命令

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入Y后回车

命令	全称 / 说明	核心作用
`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`	PowerShell 脚本执行策略配置命令	修改当前用户的 PowerShell 脚本执行权限，将策略设置为 `RemoteSigned`
`Set-ExecutionPolicy`	PowerShell 内置安全策略管理 Cmdlet	专门用于修改 PowerShell 的脚本执行策略，是该功能的核心指令
`RemoteSigned`	PowerShell 中等安全级别执行策略	允许本地创建的脚本直接运行，仅对网络下载的脚本要求可信数字签名
`-Scope CurrentUser`	执行策略作用域参数	将策略生效范围限定为「当前登录用户」，无需管理员权限即可执行
环境限制（仅 PowerShell 可执行）	PowerShell 专属安全机制依赖	该命令依赖 PowerShell 运行时引擎、专属注册表配置路径和脚本校验逻辑

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

命令	全称 / 说明	核心作用
`Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass`	PowerShell 临时会话执行策略配置命令	为当前 PowerShell 会话设置无限制执行策略，完全绕过脚本安全检查，且仅对当前会话生效Microsoft Learn
`Set-ExecutionPolicy`	PowerShell 内置安全策略管理 Cmdlet	专门用于修改 PowerShell 脚本执行策略的核心指令，属于 PowerShell 安全机制专属命令
`-Scope Process`	执行策略作用域参数（进程级）	限定策略仅对当前 PowerShell 会话生效，配置存储于环境变量 `env:USERPROFILE\.openclaw\openclaw.json" \| Select-String '"token"'`

将获取到的token填入到里面就可以了

2.10 完美访问

http://127.0.0.1:18789/chat?session=agent%3Amain%3Amainhttp://127.0.0.1:18789/chat?session=agent%3Amain%3Amain

3. 附录-命令的详细解释

3.1 常用命令

命令	核心功能	适用场景	关键参数 / 示例
`openclaw onboard`	交互式引导设置，完成网关、工作区、认证和频道配置	首次安装使用，快速完成初始化	`openclaw onboard` （默认），无需额外参数
`openclaw setup`	创建基线配置、工作区和会话文件夹，初始化基础环境	手动初始化系统，适合高级用户	`openclaw setup` （基础初始化）
`openclaw configure`	交互式配置模型、网关、频道、插件、技能和健康检查	修改系统配置，调整运行参数	`openclaw configure` （进入配置向导）
`openclaw status`	检查网关、频道、模型和最近会话状态	日常系统监控，快速排查连接问题	`openclaw status` （显示完整状态）
`openclaw doctor`	诊断并修复配置、服务、插件和频道常见问题	系统故障排查，自动修复错误	`openclaw doctor --fix` （自动修复），`openclaw doctor --deep`（深度诊断）
`openclaw gateway`	运行、检查和查询 OpenClaw 网关服务（核心进程）	网关管理，启动 / 停止 / 监控核心服务	`openclaw gateway run --force` （强制启动），`openclaw --dev gateway`（开发模式）
`openclaw channels`	添加、删除、登录和检查消息频道	管理聊天平台连接（如 Telegram）	`openclaw channels add` （添加频道），`openclaw channels status`（查看状态）
`openclaw models`	列出、扫描和设置模型提供商	管理 AI 模型配置，检查认证状态	`openclaw models status` （查看模型健康）
`openclaw chat` /`tui`	打开本地终端 UI，连接到网关进行聊天	日常交互，通过终端使用 AI 功能	`openclaw chat` （本地聊天），`openclaw tui`（终端 UI）
`openclaw update`	更新 OpenClaw 并检查更新频道状态	系统升级，获取最新功能和修复	`openclaw update check` （检查更新），`openclaw update apply`（应用更新）

3.2其他命令

命令	核心功能	适用场景	关键参数 / 示例
`acp`	运行和管理 ACP 支持的编码智能体	代码生成、调试和优化场景	`openclaw acp run --task "编写Python脚本"`
`agent`	通过网关运行一个智能体轮次	单次智能体任务执行	`openclaw agent --to +15555550123 --message "运行摘要"`
`agents`	管理隔离的智能体（工作区、认证、路由）	多智能体环境管理，隔离不同任务	`openclaw agents create --name "数据分析助手"`
`approvals`	管理执行审批（网关或节点主机）	安全管控，审批敏感操作	`openclaw approvals list` （查看审批列表）
`backup`	创建和验证 OpenClaw 状态的本地备份档案	数据备份与恢复，防止数据丢失	`openclaw backup create --path "D:\backup"`
`capability` /`infer`	运行提供商功能命令（模型、媒体、搜索等）	直接调用 AI 能力，无需完整智能体	`openclaw infer --model gpt-4 --prompt "解释量子计算"`
`clawbot`	传统 clawbot 命令别名	兼容旧版操作习惯	`openclaw clawbot legacy-command`
`commitments`	列出和管理推断的后续承诺	任务跟踪，管理智能体承诺事项	`openclaw commitments list`
`completion`	生成 shell 补全脚本	提升命令行使用效率，自动补全	`openclaw completion powershell` （生成 PowerShell 补全）
`config`	非交互式配置助手（get/set/unset 等）	脚本化配置管理，批量修改参数	`openclaw config set gateway.port 19000`
`crestodian`	打开交互式设置和修复助手	系统维护，解决复杂配置问题	`openclaw crestodian`
`cron`	调度和检查网关后台作业	定时任务管理，自动化执行操作	`openclaw cron add --command "backup" --schedule "daily"`
`daemon`	管理网关服务（传统别名）	兼容旧版命令，同 gateway	`openclaw daemon start`
`dashboard`	用当前令牌打开控制 UI	图形化管理，通过浏览器操作	`openclaw dashboard`
`devices`	设备配对 + 令牌管理	多设备连接，管理认证令牌	`openclaw devices pair`
`directory`	查找联系人 / 群组 ID（自身、同伴、群组）	消息发送，获取目标 ID	`openclaw directory search --name "John"`
`dns`	DNS 助手，用于广域发现（Tailscale + CoreDNS）	网络配置，多节点发现	`openclaw dns setup`
`docs`	搜索实时 OpenClaw 文档	快速查询帮助，获取官方指南	`openclaw docs search "gateway"`
`exec-policy`	显示或同步请求的执行策略与主机审批	安全策略管理，控制执行权限	`openclaw exec-policy sync`
`health`	从运行的网关获取详细健康信息	系统监控，深度健康检查	`openclaw health`
`hooks`	管理内部智能体钩子	自定义智能体行为，添加扩展功能	`openclaw hooks add --name "custom-hook"`
`logs`	本地或通过 RPC 跟踪网关日志	故障排查，查看系统运行记录	`openclaw logs --tail 100` （查看最后 100 行）
`mcp`	管理 OpenClaw MCP 配置和频道桥	多频道管理，消息桥接	`openclaw mcp setup`
`memory`	搜索、检查和重新索引内存文件	记忆管理，优化上下文存储	`openclaw memory search "重要信息"`
`message`	发送、读取和管理频道消息	直接消息操作，无需智能体	`openclaw message send --channel telegram --target @mychat --message "Hi"`
`migrate`	从其他智能体系统导入状态	数据迁移，整合旧系统数据	`openclaw migrate import --source "old-agent-data"`
`node`	运行和管理无头节点主机服务	分布式部署，扩展计算能力	`openclaw node start`
`nodes`	配对节点并通过网关运行节点主机命令	节点集群管理，协调多节点	`openclaw nodes pair`
`pairing`	安全 DM 配对（批准入站请求）	设备连接，安全配对验证	`openclaw pairing approve`
`plugins`	安装、启用、禁用和检查插件	扩展功能，管理第三方插件	`openclaw plugins install meeting-notes`
`proxy`	运行 OpenClaw 调试代理并检查捕获的流量	调试网络请求，排查通信问题	`openclaw proxy start`
`qr`	生成移动配对 QR / 设置码	移动设备连接，快速配对	`openclaw qr`
`reset`	重置本地配置 / 状态（保留 CLI 安装）	系统重置，解决严重配置错误	`openclaw reset`
`sandbox`	管理智能体隔离的沙箱容器	安全执行，隔离危险操作	`openclaw sandbox create`
`secrets`	审计、应用和重新加载 SecretRef 支持的凭据	凭据管理，安全存储敏感信息	`openclaw secrets audit`
`security`	安全工具和本地配置审计	系统安全检查，漏洞扫描	`openclaw security audit`
`sessions`	列出存储的对话会话	会话管理，查看历史对话	`openclaw sessions list`
`skills`	列出、检查和安装智能体技能	智能体能力扩展，添加新技能	`openclaw skills install "数据分析"`
`system`	系统事件、心跳和状态	系统监控，查看运行状态	`openclaw system events`
`tasks`	检查持久化后台任务和流程	任务管理，监控长期运行任务	`openclaw tasks list`
`terminal`	打开本地终端 UI（tui –local 别名）	日常交互，同 chat/tui	`openclaw terminal`
`uninstall`	卸载网关服务 + 本地数据（保留 CLI）	系统清理，卸载核心服务	`openclaw uninstall`
`webhooks`	Webhook 助手和集成	外部系统集成，接收 Webhook 事件	`openclaw webhooks setup`

4. 参考链接

链接名称	链接地址	用途说明
OpenClaw 官方文档（首页）	https://docs.openclaw.ai	OpenClaw 完整官方文档入口，包含安装、配置、使用全流程指南，是本教程的核心参考来源
OpenClaw CLI 命令官方参考	https://docs.openclaw.ai/cli	OpenClaw 所有 CLI 命令的详细说明文档，包含参数、示例和使用场景，对应教程中的命令部分
OpenClaw 官方一键安装脚本	https://openclaw.ai/install.ps1	教程中使用的 `iwr -useb https://openclaw.ai/install.ps1 \| iex` 命令的官方脚本地址
Node.js 官方下载与文档	https://nodejs.org/zh-cn/download/	教程中 Node.js 安装步骤的官方参考，包含不同平台的安装包和版本说明
node-gyp 官方 Windows 安装指南	https://github.com/nodejs/node-gyp#on-windows	教程中安装 Node.js 原生模块依赖（Python、VS Build Tools）的官方参考文档
PowerShell 执行策略官方文档	https://learn.microsoft.com/zh-cn/powershell/module/microsoft.powershell.security/set-executionpolicy	教程中 `Set-ExecutionPolicy` 命令的官方说明，解释执行策略的作用与参数