Windows 上本地部署 OpenClaw 保姆级教程

作者:billy

版权声明:著作权归作者所有,商业转载请联系作者获得授权,非商业转载请注明出处

前言

2026年春节以来,一款名为 OpenClaw 的开源AI助手突然爆火全网,无论是在推特、抖音等社交平台,都能刷到它的相关分享。这款工具并非传统意义上的聊天式AI,更像是为大模型装上了"手脚",打破了AI只能输出文字的局限,能够真正实现读写文件、运行命令、控制浏览器、发送邮件、整理日程等实操性任务。

其核心亮点尤为突出,坚持本地运行、数据不上云的原则,从根源上保障隐私安全,同时秉持MIT开源免费理念,支持飞书、Telegram 等多聊天平台接入,搭配17000+可扩展技能插件,灵活适配各类使用场景。OpenClaw 原名 Clawdbot、Moltbot,于2026年1月正式定名,还被社区亲切戏称为"养龙虾"。

博主也一直在关注并且倒腾配置,这里分享一下在 Windows 上本地部署 OpenClaw 的流程。

安装流程

1. 下载 NVM 安装包

NVM(Node Version Manager)是一款高效的 Node.js 版本管理工具

访问 NVM for Windows 官方仓库:下载链接(国内用户可通过GitHub镜像加速访问)

这里下载的是最新的 1.2.2 版本,安装时需要选择 NVM 的安装路径,以及选择 Node.js 快捷方式路径




2. 用 NVM 安装 Node.js(适配 OpenClaw)

OpenClaw 要求 Node.js 版本需 ≥ v22.0.0,这里选择 22.x.x 的 LTS 版本,是目前兼容性比较好的选择

1)配置 NVM 国内镜像,下载加速

复制代码
nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

2)安装 22.22.1 版本的 Node.js,并设为全局默认版本

复制代码
nvm install 22.22.1
nvm use 22.22.1

3)安装 pnpm

复制代码
# 安装 pnpm
npm install -g pnpm

# 配置 pnpm 国内镜像
pnpm config set registry https://registry.npmmirror.com/

# 验证 pnpm
pnpm -v
3. 安装 git

之所以要安装 Git,是因为有很多资源需要通过 Git 来下载

在 Git 官方下载:下载链接

下载安装完验证一下

4. 安装 openclaw

1)以管理员身份运行 Windows PowerShell

2)执行安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex

openclaw 的源代码这里也分享一下:openclaw

5. 配置 openclaw (核心操作)

1)风险提示 -> 选 yes

2)安装模式 -> 选择快速安装

3)配置处理 -> 使用存在的数据

4)模型选择 -> 优先用 Kimi / 千问 等国内可访问的模型,替换自己的 API Key

  • Kimi Code API 订阅密钥获取:
  • 登录月之暗面官网:官网链接(国内版,无需翻墙)
  • 进入 API 控制台
  • 在控制台左侧菜单找到「API 密钥管理」→「新建 API 密钥」
  • 弹出密钥串后,务必立即复制保存(仅显示一次)

5)选择默认模型 -> 保持当前模型

6)选择 openclaw 的通讯软件 -> Skip for now,后面再配置

7)选择搜索引擎 -> Skip for now,后面再配置

8)安装 skills -> no,后面再配置

9)是否安装下列功能 -> 全部选中安装

10)选择打开方式 -> 通过网页端打开

6. openclaw 命令

复制代码
# 查看帮助
openclaw --h

# 卸载 openclaw
npm uninstall -g openclaw
常用场景 对应命令 中文说明
首次配置 openclaw setup 初始化本地配置与工作区
图形化配置 openclaw configure 交互式配置向导
启动控制界面 openclaw dashboard 打开 Web 控制面板
启动终端界面 openclaw tui 打开命令行可视化界面
检查服务状态 openclaw health 查看网关健康状态
日志排查 openclaw logs 实时跟踪网关日志
设备配对 openclaw pairing 安全配对设备 / 节点
更新工具 openclaw update 更新 OpenClaw 到最新版本
英文命令 中文翻译
acp * 代理控制协议工具(Agent Control Protocol 工具集)
agent 运行单次代理任务(通过网关执行单个代理轮次)
agents * 管理独立代理(工作区、身份认证、路由配置)
approvals * 管理执行审批(网关 / 节点主机端的执行权限审批)
backup * 创建并校验 OpenClaw 本地状态备份包
browser * 管理 OpenClaw 专属浏览器(Chrome/Chromium 内核)
channels * 管理已连接的聊天渠道(Telegram、Discord 等)
clawbot * 旧版 clawbot 命令别名(兼容历史版本的命令映射)
completion 生成 Shell 补全脚本(适配 bash/zsh/fish 等终端)
config * 非交互式配置助手(查询 / 设置 / 清空 / 文件 / 校验)。默认行为:启动配置向导
configure 交互式配置向导(凭证、渠道、网关、代理默认值一键配置)
cron * 通过网关调度器管理定时任务(系统级 cron 任务)
daemon * 网关服务(旧版别名,同 gateway 命令)
dashboard 使用当前令牌打开控制界面(Control UI)
devices * 设备配对 + 令牌管理(设备绑定与访问令牌配置)
directory * 查询联系人 / 群组 ID(支持聊天渠道的自身 / 对等方 / 群组 ID 查询)
dns * 广域发现 DNS 工具(基于 Tailscale + CoreDNS 的域名解析)
docs 检索 OpenClaw 在线文档
doctor 健康检查 + 快速修复(网关 / 渠道异常自动诊断与修复)
gateway * 运行 / 检查 / 查询 WebSocket 网关(核心服务启停与状态查询)
health 获取运行中网关的健康状态
help 显示命令帮助信息
hooks * 管理内部代理钩子(自定义代理执行逻辑的钩子函数)
logs 通过 RPC 跟踪网关文件日志(实时查看网关日志)
memory * 检索并重建内存文件索引(代理记忆数据的检索与索引维护)
message * 发送 / 读取 / 管理消息(聊天渠道的消息收发与管理)
models * 发现 / 扫描 / 配置模型(AI 模型的检索、检测与参数配置)
node * 运行并管理无头节点主机服务(无界面节点的启停与管理)
nodes * 管理网关所属节点配对与节点命令(节点绑定及指令下发)
onboard 交互式入网向导(网关、工作区、技能的初始化配置)
pairing * 安全私信配对(审批入站配对请求)
plugins * 管理 OpenClaw 插件与扩展
qr 生成 iOS 配对二维码 / 配置码
reset 重置本地配置 / 状态(保留 CLI 工具,仅清空配置数据)
sandbox * 管理代理隔离沙箱容器(代理运行环境的隔离容器)
secrets * 密钥运行时重载控制(敏感密钥的热更新,无需重启服务)
security * 安全工具 + 本地配置审计(安全检测与配置合规性检查)
sessions * 列出已存储的会话记录(聊天 / 任务会话的历史记录)
setup 初始化本地配置与代理工作区(首次安装的基础配置)
skills * 列出并检查可用技能(代理支持的功能 / 技能清单)
status 显示渠道健康状态与最近会话接收方
system * 系统事件、心跳、在线状态(系统级事件监控与状态同步)
tui 打开连接到网关的终端界面(命令行可视化界面)
uninstall 卸载网关服务 + 本地数据(保留 CLI 工具,仅移除核心服务)
update * 更新 OpenClaw 并检查更新渠道状态
webhooks * Webhook 助手与集成(第三方系统 Webhook 配置与联动)
相关推荐
安当加密2 小时前
指纹一按,安全上线:SLA指纹登录如何为生产线 Windows 电脑实现低成本防勒索?
windows·安全·电脑
janthinasnail2 小时前
使用Docker安装OpenClaw
docker·容器·openclaw
self-motivation2 小时前
openclaw dashboard实现分析
dashboard·lit·openclaw
Dongwoo Jeong3 小时前
OpenClaw 安装与配置教程
openclaw
猫头虎5 小时前
OpenClaw下载安装配置|Windows安装流程|macOS 安装流程|Telegram 集成使用|飞书集成使用|常见坑和注意事项保姆级教程
人工智能·windows·macos·开源·aigc·飞书·ai编程
LuDvei11 小时前
windows 中 vs code远程连接linux
linux·运维·服务器·windows
Mountain and sea12 小时前
爆肝实测|OpenClaw Windows配置全攻略(新手必看,99%避坑,附报错速解)
windows·openclaw
尘觉13 小时前
OpenClaw 入门:本地 AI 助手架构、功能与使用场景说明(2026-3月最新版)
人工智能·架构·openclaw
年少无为呀!13 小时前
OpenClaw 飞书 Skill 开发完全指南
python·机器人·飞书·助手·openclaw·skill开发