linux中从零开始,将OpenClaw 接入 QQ 机器人

优质文章学习记录

— 6 min read
linux中从零开始,将OpenClaw 接入 QQ 机器人

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 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 机器人

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

访问 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 测试对话功能

  1. 打开 QQ，使用创建的机器人账号
  2. 向机器人发送消息

确认能够收到 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. 开发自定义技能
Could not load content