作者: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 配置与联动) |