OpenClaw 安装、初始化配置与卸载完整指南
本文的基础环境为Debian Linux 13.5，需要你具备基本的Linux知识，可安装在服务器环境或者WSL环境中，建议先去了解相关知识。安装完成Debian后首先是环境准备及不同网络环境安装流程：
一、安装 Debian 系统基础工具
在开始安装 OpenClaw 之前，先更新系统软件包并安装必要的基础工具。
# 更新并升级系统软件包
apt update && apt upgrade -y
# 安装基础工具
apt install -y git curl tar二、国际互联网环境安装 OpenClaw
适用于可以直连 GitHub、npm 等境外服务的网络环境。
2.1、安装 nvm、Node.js 与 npm
访问 https://nodejs.org/en/download，选择 Get Node.js v24.15.0 for Linux using nvm with npm，按以下步骤执行：
# 下载并安装 nvm（Node 版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
# 无需重启 Shell，直接在当前会话中加载 nvm
\. "$HOME/.nvm/nvm.sh"
# 安装 Node.js v24
nvm install 242.2、安装 OpenClaw
使用 npm 全局安装openclaw最新版：
npm install -g openclaw@latest --verbose三、国内互联网环境安装 OpenClaw
适用于无法稳定访问境外服务的国内网络环境，使用镜像源替代官方源。
3.1、从 Gitee 镜像安装 nvm
# 从 Gitee 镜像克隆 nvm，解决国内访问 GitHub 的网络问题
git clone https://gitee.com/mirrors/nvm.git ~/.nvm
# 将 nvm 加载配置写入 .bashrc，使其在每次新终端中自动生效
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
# 无需重启 Shell，在当前会话中立即加载 nvm
\. "$HOME/.nvm/nvm.sh"3.2、使用淘宝镜像源安装 Node.js
# 指定淘宝 Node.js 镜像源
echo 'export NVM_NODEJS_ORG_MIRROR=https://mirrors.aliyun.com/nodejs-release/' >> ~/.bashrc
source ~/.bashrc
# 安装 Node.js 最新长久支持版lts，也可以选择稳定最新版stable
nvm install --lts3.3、使用淘宝镜像源安装 OpenClaw
# 将 npm 仓库切换为淘宝镜像源
npm config set registry https://registry.npmmirror.com
# 安装 OpenClaw
npm install -g openclaw@latest --verbose四、OpenClaw初始化问题逐项说明
安装完成后，执行以下命令启动守护进程并进入交互式初始化向导：
openclaw onboard --install-daemon4.1、初始化问题逐项说明
以下按向导顺序列出各问题的推荐选项与说明：
| 步骤 | 问题 | 推荐选项 | 说明 |
|---|---|---|---|
| 1 | 确认个人使用模式 | yes + 回车 | 确认以个人模式使用，多用户共享需额外加固 |
| 2 | Setup mode | QuickStart (recommended) + 回车 | 快速本地配置，后续可通过 openclaw configure 修改 |
| 3 | Model/auth provider | DeepSeek | Token 费用最低，推荐首选 |
| 4 | DeepSeek API Key | 填入申请的 Key | 前往 https://platform.deepseek.com/sign_in 注册并申请 |
| 5 | Default model | deepseek/deepseek-v4-flash（Keep current） | 费用最低，支持纯文本任务 |
| 6 | Select channel | Feishu/Lark（飞书） | 国内推荐飞书，权限高、连接方便 |
| 7 | How to connect Feishu | Scan a QR code to create a bot automatically | 扫码自动创建机器人 |
| 8 | Feishu domain | Feishu (feishu.cn) - China | 打开飞书扫描二维码，为机器人命名 |
| 9 | Group chat policy | Disabled - don't respond in groups | 仅私聊响应，不加入群聊 |
| 10 | Search provider | Skip for now | 后续可让机器人自行安装所需搜索工具 |
| 11 | Configure skills now? | No | 后续可让机器人自行管理技能 |
| 12 | Enable hooks? | 空格 + 回车跳过 | 后续可让机器人自行管理 Hook |
| 13 | Gateway service | Restart | 重启整个服务 |
| 14 | How to hatch your agent | Hatch in Terminal (recommended) | 必须执行，在终端唤醒并初始化机器人，否则飞书端也无法正常启动 |
4.2、完成初始化
终端孵化界面启动后，进行简单的初始对话，然后输入 /exit 退出终端交互模式。此后即可在飞书端继续与机器人对话。
注意：终端窗口响应速度较慢，建议切换到飞书端使用，体验更流畅。
五、OpenClaw 完整卸载命令清单
5.1、卸载 OpenClaw 服务本体
openclaw uninstall --all卸完提示 “CLI still installed” 是正常的，下一步处理。
5.2、卸载 openclaw-cli
# 确认 npm 全局包列表（可选）
npm list -g
# 卸载 openclaw-cli
npm uninstall -g openclaw5.3、卸载 Node.js 和 nvm
# 查看已安装的 Node.js 版本
nvm list
# 退出当前激活版本（必须，否则 nvm 拒绝卸载）
nvm deactivate
# 卸载 Node.js（按实际情况选一条）
nvm uninstall --lts
# nvm uninstall 24 # 如果安装时指定的具体版本号
# 删除 nvm 本体
rm -rf ~/.nvm5.4、清理 .bashrc 里的环境变量
# 删除 NVM_DIR 相关两行（两套路线都有）
sed -i '/NVM_DIR/d' ~/.bashrc
# 删除阿里云镜像源那行（国内镜像路线才有，国际线路可跳过）
sed -i '/NVM_NODEJS_ORG_MIRROR/d' ~/.bashrc
# 让改动立即生效
source ~/.bashrc也可以用
vi ~/.bashrc或nano ~/.bashrc手动找到对应行删除。
5.5、验证卸载完成
openclaw --version
nvm --version
node --version三条全部报 command not found 即为卸载干净。