Linux 系统安装 OpenClaw 并接入 QQ 机器人

Linux 系统安装 OpenClaw 并接入 QQ 机器人 | 极客日志

Linux 系统安装 OpenClaw 并接入 QQ 机器人

系统准备

环境要求

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

SSH 配置（可选）

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

vi /etc/ssh/sshd_config

修改以下配置：

PasswordAuthentication yes
PermitRootLogin yes

重启 SSH 服务：

systemctl restart sshd

配置 APT 镜像源

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

# 方法一：使用自动化脚本
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 镜像源配置完成]

安装 Node.js

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

安装 OpenClaw

一键安装

使用官方安装脚本：

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

[图 2.1：OpenClaw 安装过程]

[图 2.2：选择 YES]

[图 2.3：快速引导]

配置 AI 模型

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

[图 2.4：查看模型提供商]

[图 2.5：选择模型提供商]

[图 2.6：填入 API]

跳过频道配置

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

[图 2.7：跳过频道配置]

[图 2.8：安装过程]

[图 2.9：安装过程]

[图 2.10：服务管理界面]

配置 QQ 机器人

注册 QQ 机器人

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

访问 QQ 机器人注册页面：

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

获取凭证信息

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

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

[图 3.1：QQ 机器人凭证信息]

安装 QQ 机器人插件

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

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

添加 QQ 机器人频道

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

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

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

重启 OpenClaw 服务

使配置生效：

systemctl --user restart openclaw-gateway.service

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

测试与验证

测试对话功能

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

确认能够收到 OpenClaw 的回复

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

验证服务状态

检查 OpenClaw 服务运行状态：

systemctl --user status openclaw-gateway.service

扩展功能

配置其他频道

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

Telegram
Discord
Slack
Web 界面

添加技能模块

安装扩展技能：

openclaw plugins install <插件名称>

自定义配置

编辑配置文件：

vi ~/.openclaw/config.yaml

Linux 系统安装 OpenClaw 并接入 QQ 机器人