Linux 从零开始：将 OpenClaw 接入 QQ 机器人

本文提供完整的 OpenClaw 安装和 QQ 机器人接入指南，适用于 Debian 12 系统，模型使用华为云提供MAAS

📋 目录

1. 系统准备
2. 安装 OpenClaw
3. 配置 QQ 机器人
4. 测试与验证
5. 常见问题

🚀 系统准备

环境要求

• 操作系统：Debian 12（其他 Linux 发行版类似）
• 用户权限：root 用户
• 网络：可正常访问外部网络

1.1 SSH 配置（可选）

如需通过 SSH 远程管理，可配置 root 密码登录：

vi /etc/ssh/sshd_config

修改以下配置：

PasswordAuthentication yes
PermitRootLogin yes

重启 SSH 服务：

systemctl restart sshd

1.2 配置 APT 镜像源

使用国内镜像源加速软件下载：

# 方法一：使用自动化脚本
bash <(curl -sSL https://linuxmirrors.cn/main.sh)

# 方法二：手动配置清华源
cat > /etc/apt/sources.list << EOF
# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
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 镜像源配置完成

1.3 安装 Node.js

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 安装成功

---

🔧 安装 OpenClaw

2.1 一键安装

使用官方安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

图 2.1：OpenClaw 安装过程

图 2.2：选择YES

图 2.3：快速引导

2.2 配置 AI 模型

选择 AI 模型提供商，这里以华为云 MaaS 为例：

图 2.4：查看模型提供商

图 2.5：选择模型提供商

图 2.6：填入API

2.3 跳过频道配置

在初始配置阶段，可以暂时跳过频道设置，后续再配置 QQ 机器人：

图 2.7：跳过频道配置

图 2.8：安装过程

图 2.9：安装过程

图 2.10：服务管理界面

---

🤖 配置 QQ 机器人

3.1 注册 QQ 机器人

1. 访问 QQ 机器人注册页面：

   https://q.qq.com/qqbot/openclaw/login.html
   

2. 使用 QQ 扫码登录
3. 创建机器人应用

3.2 获取凭证信息

创建成功后，保存以下重要信息：

字段	说明	注意事项
AppID	机器人的唯一标识符	长期有效
AppSecret	机器人调用 API 的密钥	只会显示一次，请立即保存

图 3.1：QQ 机器人凭证信息

3.3 安装 QQ 机器人插件

在 OpenClaw 中安装 QQ 机器人插件：

openclaw plugins install @tencent-connect/openclaw-qqbot@latest

3.4 添加 QQ 机器人频道

使用获取的 AppID 和 AppSecret 添加频道：

openclaw channels add --channel qqbot --token "AppID:AppSecret"

注意：将 AppID:AppSecret 替换为实际的凭证，格式为 AppID:AppSecret。

3.5 重启 OpenClaw 服务

使配置生效：

systemctl --user restart openclaw-gateway.service

图 3.2：QQ 机器人插件安装成功

---

🧪 测试与验证

4.1 测试对话功能

1. 打开 QQ，使用创建的机器人账号
2. 向机器人发送消息
3. 确认能够收到 OpenClaw 的回复
   

图 4.1：QQ 机器人对话测试成功

4.2 验证服务状态

检查 OpenClaw 服务运行状态：

systemctl --user status openclaw-gateway.service

---

📚 扩展功能

4.1 配置其他频道

除了 QQ 机器人，OpenClaw 还支持：

• Telegram
• Discord
• Slack
• Web 界面

4.2 添加技能模块

安装扩展技能：

openclaw plugins install <插件名称>

4.3 自定义配置

编辑配置文件：

vi ~/.openclaw/config.yaml

---

🎉 完成

恭喜！你已经成功在 Linux 系统上安装 OpenClaw 并接入 QQ 机器人。现在可以开始使用智能助手功能了。

下一步建议：

1. 探索 OpenClaw 的其他功能
2. 配置定时任务和提醒
3. 集成其他服务和 API
4. 开发自定义技能