一、安装前准备

1.1 推荐配置
操作系统：Windows10/11
内存： ≥4GB
硬盘空间 ≥20GB
1.2 必装基础软件
（1）Node.js 22+（核心运行环境）
官网：https://nodejs.org/
安装时勾选 “Add to PATH”
验证安装：
node -v # 输出 v22.x.x 说明成功
npm -v # 输出对应版本号
（2）开启 WSL2（推荐，兼容性最好）
管理员PowerShell执行
wsl --install
如WSL有问题，windows设置启用或关闭windows功能，按下图勾选启用或关闭windows功能

（3）解锁PowerShell执行权限
管理员PowerShell
Set-ExecutionPolicy Bypass -Scope Process -Force
或
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

二、安装

1.PowerShell一键安装（官方和国内2选1）
1）官方脚本（需联网）
iwr -useb https://openclaw.ai/install.ps1 | iex
2）国内镜像脚本（网络受限时用）
iwr -useb https://clawd.org.cn/install.ps1 | iex
2.进入配置界面
1）安装成功后，会自动执行openclaw onboard进入配置界面。全程英文，需看清楚主要含义，并且通过方向↑ ↓ ← → 键选择所述选项后，敲回车键执行。
如果不小心关掉窗口，可重新以管理员方式打开powershell后，输入：
openclaw onboard --flow quickstart 进行配置
告知使用openclaw可能有的一些风险提示。默认是绿色>在No前面，需通过← 移到Yes，然后回车。
2）选择需要使用的AI模型
在Model/auth provide界面列举模型供选择。通过↑ 或↓选择自己所使用的模型(选择模型前需具备所选择模型的API 账号和key，可以事先在能访问的模型平台上注册，并查到所注册账号对应的API 账号 & key并记录下来。
这里本人用的百炼模型

3）看清提示选择和输入API账号和key
在弹窗的界面上输入API账号和key，若登录功能会有成功的提示，进入选择channel配置。本人是使用QQ作为沟通的channel，腾讯提供了统一龙虾创建APP id。
打开网址：https://q.qq.com

4）进入Skill选择阶段
此处也先不选择Skill，待安装完成后在UI界面上选择Skill。选择跳过此步。
5）开始安装并启动网关
选择完成回车就开始安装配置并启动网关，会自动新开一个Powershell窗口执行，任其执行，若有提示需看明白是什么样情况。
6）浏览器自动打开控制台
openclaw自动调用浏览器打开控制台界面。后面可以通过http://127.0.0.1:18789/访问和配置。
后期如启动报错 disconnected (1008): unauthorized: gateway token mismatch
重新打开带Token的 Dashboard URL
如果你是通过浏览器的旧标签页或直接访问 http://127.0.0.1:18789/ 打开的 Dashboard，那么浏览器不会携带当前有效的 Token。
修复步骤：
PowerShell中输入openclaw dashboard自动打开浏览器，读取配置文件 ~/.openclaw/openclaw.json中token
常用命令参考
openclaw onboard 重新进入配置向导
openclaw status 查看运行状态
openclaw health 健康检查(在控制面板的右 上角也有显示)
openclaw gateway start 启动服务
openclaw gateway stop 停止服务
openclaw gateway restart 重启服务
openclaw update 更新到最新版本
openclaw doctor 诊断异常
openclaw uninstall 卸载openclaw

三、OpenClaw 卸载

如何彻底卸载OpenClaw
彻底卸载OpenClaw需要清除其主程序、相关组件及配置文件。‌
1.使用自带命令卸载核心组件‌
打开终端（Windows命令提示符或PowerShell，Mac的终端）。
输入命令：openclaw uninstall --all --yes。此命令将‌自动卸载网关服务、本地数据库、配置文件等所有相关数据‌。‌‌
‌2.删除命令行工具（CLI）‌
完成上一步后，继续在终端输入命令：npm uninstall -g openclaw，以移除其命令行外壳。‌‌
3.后续操作建议‌
执行完上述操作后，‌重启电脑‌以确保所有后台进程关闭。‌‌
如果曾在OpenClaw中绑定过API密钥，‌强烈建议立即前往对应官网（如百炼等）作废旧密钥并生成新密钥‌，以防泄露的密钥被继续利用。‌‌
QQ中机器人也可以删除，仍然在QQ开放平台删除即可