鉴于很多朋友都有安装与卸载OpenClaw的需求，这里将官方资料整理并呈现给大家，力求简洁明了能帮助到更多有需求的人，另外不建议因跟风而使用OpenClaw，至于原因嘛，可以参考我之前关于OpenClaw用法与风险文章，有兴趣可以看一下。

本文所有操作步骤均整理自 OpenClaw 官方文档，覆盖 Windows、macOS 两大主流系统的标准安装与完整卸载流程，新手可直接照着操作，全程无冗余步骤。但需要注意的是，CLI相关操作有一定误操作导致关键数据丢失的风险，如果可以的话建议直接查阅官方的开发文档或者找专业人士帮助安装或卸载，切勿在一知半懂的情况下擅自操作，若出现问题概不负责，另外，实际操作中还可能出现各种各样意料之外的问题，欢迎补充和交流，旨在为每一个热爱互联网的人提供必要的帮助。

前置系统要求

一、Windows 平台操作指南

（一）安装流程

1. 新手首选：官方一键安装（99% 用户推荐）

这是官方推荐的最简方式，脚本自动完成环境检测、依赖安装、程序部署与初始化引导，全程无需手动配置。

操作步骤：

• 按下Win+S搜索PowerShell，右键选择「以管理员身份运行」（避免权限不足导致安装失败）

• 复制下方官方命令，粘贴到 PowerShell 窗口中，按下回车执行

powershell

iwr-useb https://openclaw.ai/install.ps1 | iex

• 等待脚本执行完成，按照终端内的引导完成首次配置即可。

脚本流程：自动检测并安装缺失的 Node.js 环境 → 全局安装 OpenClaw CLI → 启动初始化配置向导

2. 进阶备用：npm 全局安装（适合已有 Node 环境的用户）

若你已提前安装好 Node.js 22 及以上版本，可直接通过 npm 快速安装：

• 以管理员身份打开 PowerShell，执行以下命令完成安装

powershell

npm install -g openclaw@latest

• 安装完成后，执行初始化配置向导

powershell

openclaw onboard --install-daemon

安装成功验证

• 执行以下官方健康检查命令，无报错即代表安装成功：

powershell

openclaw doctor

# 运行 openclaw gateway status 网关服务专属状态检查

# 运行 openclaw dashboard 打开Control UI,若能加载表明gateway网关已准备就绪可正常使用

（二）卸载流程

1. 推荐：官方一键卸载

一键完成服务停止、程序移除与基础配置清理，操作最简单：

• 以管理员身份打开 PowerShell，执行以下命令

powershell

openclaw uninstall

• 按照终端提示确认卸载即可。

如需无交互彻底卸载（自动化），可执行以下命令，自动清理所有相关文件与服务：

powershell

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

#npx 使用这个:npx -y openclaw unnistall --all --yes --non-interactive

2. 兜底方案：手动彻底卸载（清理残留）

若一键卸载异常，可按以下步骤手动完成全量清理：

• 停止 OpenClaw 网关服务

powershell

openclaw gateway stop

• 卸载网关开机自启服务

powershell

openclaw gateway uninstall

• 删除本地配置、缓存与工作区文件

powershell

Remove-Item -Force -Recurse $HOME\.openclaw

• 移除全局 CLI 程序

powershell

npm rm -g openclaw

# 若使用pnpm安装，执行：pnpm remove -g openclaw

• 最后打开「任务计划程序」，删除名为OpenClaw Gateway的计划任务，完成彻底清理。

二、macOS 平台操作指南

（一）安装流程

1. 新手首选：官方一键安装（99% 用户推荐）

官方原生适配的一键脚本，自动处理所有环境与部署步骤，全程无需手动配置。

操作步骤：

• 按下Command+空格搜索「终端」并打开

• 复制下方官方命令，粘贴到终端中，按下回车执行

bash

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

• 等待脚本执行完成，按照终端引导完成首次配置即可。

脚本流程：自动检测并安装缺失的 Node.js 环境 → 全局安装 OpenClaw CLI → 启动初始化配置向导

2. 进阶备用：npm 全局安装（适合已有 Node 环境的用户）

若你已提前安装 Node.js 22 及以上版本，可直接通过 npm 快速安装：

• 打开终端，执行以下命令完成安装

bash

npm install -g openclaw@latest

• 安装完成后，执行初始化配置向导

bash

openclaw onboard --install-daemon

安装成功验证

• 执行以下官方健康检查命令，无报错即代表安装成功：

bash

openclaw doctor

# 运行 openclaw gateway status 网关服务专属状态检查

# 运行 openclaw dashboard 打开Control UI,若能加载表明gateway网关已准备就绪可正常使用

（二）卸载流程

1. 推荐：官方一键卸载

一键完成服务停止、程序移除与基础清理，操作最简：

• 打开终端，执行以下命令

bash

openclaw uninstall

• 按照终端提示确认卸载即可。

如需无交互彻底卸载（自动化)，可执行以下命令，自动清理所有相关文件与服务：

bash

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

# npx 使用这个: npx -y openclaw unnistall --all --yes --non-interactive

2. 兜底方案：手动彻底卸载（清理残留）

若一键卸载异常，可按以下步骤手动完成全量清理：

• 停止 OpenClaw 网关服务

bash

openclaw gateway stop

• 卸载网关开机自启服务

bash

openclaw gateway uninstall

• 删除本地配置、缓存与工作区文件

bash

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

• 移除全局 CLI 程序

bash

npm rm -g openclaw

# 若使用pnpm安装，执行：pnpm remove -g openclaw

# 若使用bun安装，执行：bun remove -g openclaw

• 清理开机自启残留文件

bash

rm -rf  ~/Library/LaunchAgents/ai.openclaw.gateway.plist

若你安装了 OpenClaw 桌面应用，执行以下命令删除：

bash

rm -rf /Applications/OpenClaw.app

三、常见问题 & 注意事项

1. Windows PowerShell 执行策略报错

若提示「无法加载文件 因为在此系统上禁止运行脚本」，先执行以下命令修改执行策略，按提示输入 “ Y ” 确认，再重新执行安装命令：

powershell

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

2. 安装完成后提示「找不到 openclaw 命令」

关闭当前终端 / PowerShell，重新打开一个新的窗口再执行命令即可（系统需要刷新 PATH 环境变量）。

3. 网络问题导致安装失败

请确保网络可正常访问 GitHub 与 npm 官方源，可尝试切换网络后重新执行安装命令。

4. 卸载OpenClaw时可选择删除工作区，即，移除智能体文件，命令为：

rm -rf ~/.openclaw/workspace

5. 使用官方“一键安装”命令，如curl -fsSL https://openclaw.ai/install.sh | bash ，会进到一个安装引导的流程，需要进行大模型的选择，可根据实际需要选择：

1. 欢迎界面会看到以下文本，按 “Enter”（Mac为 “return” 下同）继续：

• OpenAI (GPT-4)

• Dashscope (通义千问)   <--国内使用选国产大模型会更方便
• Anthropic (Claude)
• Google (Gemini)
• Skip for now (跳过）

• WhatsApp 
• Telegram 
• Discord 
• Slack 

• WeChat

• QQ 
• Skip for now

• Yes (recommended) 

• No 

• AI Provider: Dashscope (qwen-max) 
• Workspace: ~/.openclaw/workspace 
• Gateway: Running (port 18789) 
• Channels: None (add later with `openclaw channels add`) 

• Chat: openclaw agent --message "Hello" 
• Send message: openclaw message send --to xxx --message "Hi" 

•  Add channel: openclaw channels add 

•  View docs: openclaw docs 

OpenClaw官方权威链接

各平台 API Key 获取操作指南

一、通义千问（Dashscope）

• 访问官方控制台地址：dashscope.console.aliyun.com/
• 登录阿里云账号，无账号可先完成注册
• 点击页面左侧菜单栏的 API Key 管理
• 点击 创建新的 API Key 按钮
• 复制生成的密钥（固定以 sk- 开头）
• 将复制的 Key 粘贴至对应使用向导中即可

二、OpenAI

• 访问官方平台地址：platform.openai.com/
• 完成账号登录或新用户注册
• 点击页面左侧菜单栏的 API Keys
• 点击 Create new secret key 按钮
• 复制生成的密钥（以 sk-proj- 或 sk- 开头）

• 访问官方控制台地址：console.anthropic.com/
• 完成账号登录或新用户注册
• 点击页面中的 Get API keys
• 点击 Create key 按钮
• 复制生成的密钥（固定以 sk-ant- 开头）

最后的最后......

如果有软件或者小程序开发需求的朋友，记得联系我们哟～