Linux 从零开始：将 OpenClaw 接入 QQ 机器人
本文提供完整的 OpenClaw 安装和 QQ 机器人接入指南，适用于 Debian 12 系统，模型使用华为云提供MAAS
📋 目录
🚀 系统准备
环境要求
- 操作系统：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 EOFapt update
图 1.1：APT 镜像源配置完成
1.3 安装 Node.js
OpenClaw 基于 Node.js 开发，需要安装 Node.js 24：
# 安装 curl（如果未安装）aptinstallcurl-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 install24# 启用 pnpm corepack enablepnpm# 验证安装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 机器人
- 使用 QQ 扫码登录
- 创建机器人应用
访问 QQ 机器人注册页面：
https://q.qq.com/qqbot/openclaw/login.html
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 测试对话功能
- 打开 QQ，使用创建的机器人账号
- 向机器人发送消息
确认能够收到 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 机器人。现在可以开始使用智能助手功能了。
下一步建议：
- 探索 OpenClaw 的其他功能
- 配置定时任务和提醒
- 集成其他服务和 API
- 开发自定义技能
