OpenClaw 安装 & 卸载教程（2026 最新）

文档基于 OpenClaw 官方安装脚本和实测经验整理，覆盖 Windows / macOS / Linux 全平台。

一、安装前准备

系统要求

Windows 用户注意事项

安装前建议关闭以下安全软件（否则可能被误拦截）：

• 360 安全卫士 / 杀毒
• 火绒安全
• 腾讯电脑管家
• Windows Defender 实时防护（临时关闭）
• 解压工具用 WinRAR 或 7-Zip，不要用系统自带解压

二、Windows 安装

方式一：官方安装包（新手推荐）

适合：零基础用户，不想敲命令。

1. 打开浏览器，访问 **https://qclaw.qq.com**（腾讯版官网）或 https://openclaw.ai
2. 点击页面 “Windows” 按钮，自动识别下载安装包
3. 找到下载的 .exe 安装包，双击启动安装向导
4. 勾选”我已阅读并同意《软件许可及服务协议》”
5. 选择安装路径（建议 D:\OpenClaw 或 E:\AI\OpenClaw，路径不要有中文、空格、特殊符号）
6. 点击”安装”，等待 1~2 分钟
7. 点击”完成”，桌面出现 QClaw 图标

⚠️ 安装过程中若弹出”Windows 已保护你的电脑”，点”更多信息” → “仍要运行”。

方式二：PowerShell 一键命令（推荐）

适合：有基础用户，最快速。

以管理员身份打开 PowerShell（开始菜单搜索 PowerShell → 右键 → 以管理员身份运行），执行：

# 设置脚本执行策略（首次需要）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 一键安装（自动检测并安装 Node.js）
iwr -useb https://openclaw.ai/install.ps1 | iex

等待脚本自动完成 Node.js 检测 / 安装和 OpenClaw 配置。

方式三：npm / pnpm 安装 CLI

适合：已有 Node.js 环境的开发者。

# npm
npm install -g openclaw

# pnpm（更快）
pnpm add -g openclaw

# bun
bun add -g openclaw

安装完成后初始化：

openclaw gateway install
openclaw gateway start

三、macOS 安装

方式一：Shell 一键命令

打开终端，执行：

curl -fsSL https://openclaw.ai/install.sh | bash

方式二：Homebrew

brew install openclaw

方式三：npm / pnpm

npm install -g openclaw
# 或
pnpm add -g openclaw

四、Linux / WSL2 安装

Shell 一键命令

curl -fsSL https://openclaw.ai/install.sh | bash

npm 安装

# 先确保 Node.js >= v22
node -v   # 如低于 22，先安装：curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs

npm install -g openclaw
openclaw gateway install
openclaw gateway start

Docker 方式（Linux）

docker pull openclaw/openclaw

docker run -d --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/home/app/.openclaw \
  openclaw/openclaw

五、验证安装成功

安装完成后，访问浏览器地址：

http://localhost:18789

若显示 OpenClaw 界面，说明 Gateway 已在线。

命令行验证：

openclaw --version
openclaw gateway status

六、首次配置向导

启动后按向导完成：

1. 选择 Yes 确认风险提示
2. 配置 API Key（Claude / OpenAI / 阿里百炼等）
3. 选择安装的 Skill（可选）
4. 开始使用

七、常用管理命令

openclaw gateway start    # 启动网关
openclaw gateway stop     # 停止网关
openclaw gateway restart  # 重启网关
openclaw gateway status   # 查看状态
openclaw gateway update   # 更新 OpenClaw
openclaw --version        # 查看版本
openclaw help             # 查看所有命令

八、卸载 OpenClaw

⚠️ 卸载前请确认不再需要任何配置、数据和记忆文件。如需备份，先执行备份。

8.1 官方一键卸载（推荐首选）

以管理员身份打开 PowerShell，执行：

openclaw uninstall --all --yes --non-interactive

执行成功输出：

Stopped Scheduled Task: OpenClaw Gateway
Removed task script: C:\Users\xxx\.openclaw\gateway.cmd
Removed ~\.openclaw
CLI still installed. Remove via npm/pnpm if desired.

若 CLI 命令已损坏，改用：

npx -y openclaw uninstall --all --yes --non-interactive

8.2 npm/pnpm 卸载 CLI 工具

# npm
npm uninstall -g openclaw

# pnpm
pnpm remove -g openclaw

# bun
bun remove -g openclaw

8.3 手动彻底清理（当官方命令失效时）

Windows 手动清理步骤

第一步：停止所有后台进程 打开任务管理器 → 详细信息 → 找到 node.exe → 全部结束任务。

第二步：删除计划任务 搜索”任务计划程序” → 左侧”任务计划程序库” → 找到 OpenClaw Gateway → 右键删除。

第三步：删除安装目录

C:\Program Files\OpenClaw          # 或你自定义的安装路径
C:\Program Files (x86)\OpenClaw

第四步：清理用户数据目录（重要！）

C:\Users\<你的用户名>\.openclaw

直接删除整个 .openclaw 文件夹。

第五步：清理 AppData 残留

C:\Users\<你的用户名>\AppData\Local\OpenClaw
C:\Users\<你的用户名>\AppData\Roaming\OpenClaw

在文件资源管理器的地址栏直接粘贴路径即可找到。

第六步：清理文档目录

C:\Users\<你的用户名>\Documents\OpenClaw

第七步：清理注册表（谨慎操作）

⚠️ 操作注册表前先备份：按 Win+R 输入 regedit → 文件 → 导出，保存一份。

按 Win+R 输入 regedit，在注册表编辑器中删除以下路径（如果存在）：

HKEY_CURRENT_USER\Software\OpenClaw
HKEY_LOCAL_MACHINE\SOFTWARE\OpenClaw

第八步：清理临时文件

按 Win+R 输入 %temp%，在临时文件夹中删除所有含 OpenClaw 的文件。

第九步：重启电脑

macOS 手动清理

# 停止后台服务
launchctl unload ~/Library/LaunchAgents/openclaw.plist

# 删除 Launch Agent
rm -f ~/Library/LaunchAgents/openclaw.plist

# 删除配置目录
rm -rf ~/.openclaw

# 卸载 CLI
npm uninstall -g openclaw
# 或
pnpm remove -g openclaw

Linux 手动清理

# 停止服务
systemctl --user stop openclaw-gateway
systemctl --user disable openclaw-gateway

# 删除配置目录
rm -rf ~/.openclaw

# 删除 systemd 服务（若通过 systemd 安装）
rm -f ~/.config/systemd/user/openclaw-gateway.service

# 卸载 CLI
npm uninstall -g openclaw
# 或
sudo rm -f $(which openclaw)

九、卸载验证清单

确认以下全部不存在：

# 检查命令是否还在
Get-Command openclaw        # 无输出 = 卸载成功

# 检查后台进程
Get-Process node -ErrorAction SilentlyContinue   # 若有，检查是否 OpenClaw 相关

# 检查端口是否释放
netstat -ano | findstr 18789   # 无输出 = 端口已释放

# 检查数据目录
Test-Path "$env:USERPROFILE\.openclaw"   # False = 已删除
Test-Path "$env:LOCALAPPDATA\OpenClaw"   # False = 已删除

十、常见问题

📌 关注公众号《秋雨》，获取更多生态前沿技术分享。