Linux 从零开始将 OpenClaw 接入 QQ 机器人本文提供完整的 OpenClaw 安装和 QQ 机器人接入指南适用于 Debian 12 系统模型使用华为云提供MAAS 目录系统准备安装 OpenClaw配置 QQ 机器人测试与验证常见问题 系统准备环境要求操作系统Debian 12其他 Linux 发行版类似用户权限root 用户网络可正常访问外部网络1.1 SSH 配置可选如需通过 SSH 远程管理可配置 root 密码登录vi/etc/ssh/sshd_config修改以下配置PasswordAuthentication yes PermitRootLogin yes重启 SSH 服务systemctl restart sshd1.2 配置 APT 镜像源使用国内镜像源加速软件下载# 方法一使用自动化脚本bash(curl-sSLhttps://linuxmirrors.cn/main.sh)# 方法二手动配置清华源cat/etc/apt/sources.listEOF # 默认注释了源码镜像以提高 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 EOFaptupdate图 1.1APT 镜像源配置完成1.3 安装 Node.jsOpenClaw 基于 Node.js 开发需要安装 Node.js 24# 安装 curl如果未安装aptinstallcurl-y# 安装 nvmNode Version Managercurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh|bash# 加载 nvm\.$HOME/.nvm/nvm.sh# 安装 Node.js 24nvminstall24# 启用 pnpmcorepackenablepnpm# 验证安装node-v图 1.2Node.js 安装成功 安装 OpenClaw2.1 一键安装使用官方安装脚本curl-fsSLhttps://openclaw.ai/install.sh|bash图 2.1OpenClaw 安装过程图 2.2选择YES图 2.3快速引导2.2 配置 AI 模型选择 AI 模型提供商这里以华为云 MaaS 为例图 2.4查看模型提供商图 2.5选择模型提供商图 2.6填入API2.3 跳过频道配置在初始配置阶段可以暂时跳过频道设置后续再配置 QQ 机器人图 2.7跳过频道配置图 2.8安装过程图 2.9安装过程图 2.10服务管理界面 配置 QQ 机器人3.1 注册 QQ 机器人访问 QQ 机器人注册页面https://q.qq.com/qqbot/openclaw/login.html使用 QQ 扫码登录创建机器人应用3.2 获取凭证信息创建成功后保存以下重要信息字段说明注意事项AppID机器人的唯一标识符长期有效AppSecret机器人调用 API 的密钥只会显示一次请立即保存图 3.1QQ 机器人凭证信息3.3 安装 QQ 机器人插件在 OpenClaw 中安装 QQ 机器人插件openclaw pluginsinstalltencent-connect/openclaw-qqbotlatest3.4 添加 QQ 机器人频道使用获取的 AppID 和 AppSecret 添加频道openclaw channelsadd--channelqqbot--tokenAppID:AppSecret注意将AppID:AppSecret替换为实际的凭证格式为AppID:AppSecret。3.5 重启 OpenClaw 服务使配置生效systemctl--userrestart openclaw-gateway.service图 3.2QQ 机器人插件安装成功 测试与验证4.1 测试对话功能打开 QQ使用创建的机器人账号向机器人发送消息确认能够收到 OpenClaw 的回复图 4.1QQ 机器人对话测试成功4.2 验证服务状态检查 OpenClaw 服务运行状态systemctl--userstatus openclaw-gateway.service 扩展功能4.1 配置其他频道除了 QQ 机器人OpenClaw 还支持TelegramDiscordSlackWeb 界面4.2 添加技能模块安装扩展技能openclaw pluginsinstall插件名称4.3 自定义配置编辑配置文件vi~/.openclaw/config.yaml 完成恭喜你已经成功在 Linux 系统上安装 OpenClaw 并接入 QQ 机器人。现在可以开始使用智能助手功能了。下一步建议探索 OpenClaw 的其他功能配置定时任务和提醒集成其他服务和 API开发自定义技能