写在前面:安装 Openclaw,Linux 和 Mac 始终比 Windows 安装更简便,因为 Windows 要解决的环境配置问题始终比 Linux 和 Mac 要多。
一、Windows 安装 Openclaw 接入 QQ 机器人极简教程
安装 Openclaw 必备的三个基础环境是:Node.js、npm、git,使用如下命令查看是否有版本号:
node -v(显示版本号即为成功)
npm -v(显示版本号即为成功)
git -v(显示版本号即为成功)
如果提示错误,需要先解决错误问题,否则容易导致后续安装失败。配置完三个基础环境后,进入正式的安装步骤,
1.安装 openclaw,命令:npm install -g openclaw,安装完成输入:openclaw -v,如果输入版本号,如:OpenClaw 2026.3.8 (3caab92),代表安装完成。
2.配置 openclaw 功能,命令:openclaw onboard,会出现一段安全警示,并提示: I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?输入 y,进入下一步。
3.Onboarding mode 选择 QuickStart
4.Model/auth provider,我选择的是 Qwen,你也可以选择其它通用大模型,之后会自动打开浏览器注册,注册好后回到命令行。
5.Qwen OAuth complete 选择 Default model set to qwen-portal/coder-model
6.Default model 选择 Keep current (qwen-portal/coder-model)
7.Select channel (QuickStart) 这里以接入 QQ 机器人为例,因选项中无此项,所以选择跳过:Skip for now
8.Search provider 选择 Skip for now
9.Configure skills now? (recommended) 选择 No
10 Enable hooks? 选择 Skip for now
11.How do you want to hatch your bot? 选择 Open the Web UI。
至此,已经以打开 Web UI 了,地址默认是 http://127.0.0.1:18789,接下来安装 Openclaw 接入 QQ 机器人。在继续下一步之前,建议先在聊天窗口中设置机器人的名字、风格等配置。
12.继续在 Powershell 中输入:openclaw plugins install @sliverp/qqbot@latest 安装 QQ 机器人
13.打开 https://q.qq.com/qqbot/openclaw/login.html,快速注册创建 QQ 机器人
14.创建 QQ 机器人后,后台会给 3 条命令,依次在 Powershell 中输入, QQ 机器人接入 Openclaw 成功, QQ 上会多出一个机器人好友。此时,可以通过 QQ 机器人给 Openclaw 发送指令了。
二、Debian GNU/Linux 安装 Openclaw 接入 QQ 机器人极简教程
相对于 Windows 安装 Openclaw,Debian GNU/Linux 和 Mac 一样,实在是太方便了。
1.安装 git 和 curl。命令:sudo apt install git curl
2.Debian GNU/Linux 包中的 Node.js 是 20.x 的版本,需要使用下面三个命令安装最新版的。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 24
3.现在正式开始安装 Openclaw。
- 一种是用前述的命令手动一步一步安装,命令:npm install -g openclaw
- 一种是一个命令安装,一键安装命令:curl -fsSL https://openclaw.ai/install.sh | bash
4.安装完后的 Openclaw 接入 QQ 机器人的步骤同 Windows 安装。