Linux 系统安装 OpenClaw 并接入 QQ 机器人
介绍在 Debian 12 Linux 系统上安装 OpenClaw 并接入 QQ 机器人的步骤。包括环境准备(SSH、APT 源、Node.js)、OpenClaw 安装、AI 模型配置(华为云 MaaS)、QQ 机器人插件安装及凭证设置。最后通过服务状态检查与对话测试验证功能。

介绍在 Debian 12 Linux 系统上安装 OpenClaw 并接入 QQ 机器人的步骤。包括环境准备(SSH、APT 源、Node.js)、OpenClaw 安装、AI 模型配置(华为云 MaaS)、QQ 机器人插件安装及凭证设置。最后通过服务状态检查与对话测试验证功能。

如需通过 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 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 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 20:
# 安装 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
source "$HOME/.nvm/nvm.sh"
# 安装 Node.js 20
nvm install 20
# 启用 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

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online