Linux 部署 OpenClaw 并接入 QQ 机器人
介绍在 Debian 12 系统上从零部署 OpenClaw 框架并接入 QQ 机器人的完整流程。步骤包括配置 APT 镜像源、安装 Node.js 环境、使用脚本一键安装 OpenClaw、配置华为云 MaaS 模型服务,以及通过插件集成 QQ 机器人账号。最后验证服务状态及对话功能,支持 Telegram、Discord 等多渠道扩展。

介绍在 Debian 12 系统上从零部署 OpenClaw 框架并接入 QQ 机器人的完整流程。步骤包括配置 APT 镜像源、安装 Node.js 环境、使用脚本一键安装 OpenClaw、配置华为云 MaaS 模型服务,以及通过插件集成 QQ 机器人账号。最后验证服务状态及对话功能,支持 Telegram、Discord 等多渠道扩展。

本文提供完整的 OpenClaw 安装和 QQ 机器人接入指南,适用于 Debian 12 系统,模型使用华为云 MaaS。
如需通过 SSH 远程管理,可配置 root 密码登录:
vi /etc/ssh/sshd_config
修改以下配置:
PasswordAuthentication yes
PermitRootLogin yes
重启 SSH 服务:
systemctl restart sshd
使用国内镜像源加速软件下载:
# 方法一:使用自动化脚本
bash <(curl -sSL https://linuxmirrors.cn/main.sh)
# 方法二:手动配置清华源
cat > /etc/apt/sources.list <<EOF
deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
deb-src http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
deb-src http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
deb-src http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
deb https://security.debian.org/debian-security bookworm-security main contrib non-free non-free-firmware
deb-src https://security.debian.org/debian-security bookworm-security main contrib non-free non-free-firmware
EOF
apt update

图 1.1:APT 镜像源配置完成
OpenClaw 基于 Node.js 开发,需要安装 Node.js 24:
# 安装 curl(如果未安装)
apt install curl -y
# 安装 nvm(Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# 加载 nvm
. "$HOME/.nvm/nvm.sh"
# 安装 Node.js 24
nvm install 24
# 启用 pnpm
corepack enable pnpm
# 验证安装
node -v

图 1.2:Node.js 安装成功
使用官方安装脚本:
curl -fsSL https://openclaw.ai/install.sh | bash

图 2.1:OpenClaw 安装过程

图 2.2:选择 YES

图 2.3:快速引导
选择 AI 模型提供商,这里以华为云 MaaS 为例:

图 2.4:查看模型提供商

图 2.5:选择模型提供商

图 2.6:填入 API
在初始配置阶段,可以暂时跳过频道设置,后续再配置 QQ 机器人:

图 2.7:跳过频道配置

图 2.8:安装过程

图 2.9:安装过程

图 2.10:服务管理界面
访问 QQ 机器人注册页面:
https://q.qq.com/qqbot/openclaw/login.html
创建成功后,保存以下重要信息:
| 字段 | 说明 | 注意事项 |
|---|---|---|
| AppID | 机器人的唯一标识符 | 长期有效 |
| AppSecret | 机器人调用 API 的密钥 | 只会显示一次,请立即保存 |

图 3.1:QQ 机器人凭证信息
在 OpenClaw 中安装 QQ 机器人插件:
openclaw plugins install @tencent-connect/openclaw-qqbot@latest
使用获取的 AppID 和 AppSecret 添加频道:
openclaw channels add --channel qqbot --token "AppID:AppSecret"
注意:将 AppID:AppSecret 替换为实际的凭证,格式为 AppID:AppSecret。
使配置生效:
systemctl --user restart openclaw-gateway.service

图 3.2:QQ 机器人插件安装成功
确认能够收到 OpenClaw 的回复

图 4.1:QQ 机器人对话测试成功
检查 OpenClaw 服务运行状态:
systemctl --user status openclaw-gateway.service
除了 QQ 机器人,OpenClaw 还支持:
安装扩展技能:
openclaw plugins install <插件名称>
编辑配置文件:
vi ~/.openclaw/config.yaml
恭喜!你已经成功在 Linux 系统上安装 OpenClaw 并接入 QQ 机器人。现在可以开始使用智能助手功能了。
后续建议:

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online