OpenClaw与QQ频道完美对接，操作简单一步到位

星哥玩云
0 阅读4分钟

OpenClaw与QQ频道完美对接，操作简单一步到位

大家好，我是星哥，最近在Win11下养了一只龙虾，需要接入qq，它能接管电脑操作、执行各类指令，而接入QQ频道后，我们无需切换应用，在熟悉的QQ界面就能直接操控OpenClaw，实现“聊天框里办大事”的便捷体验。

本文将手把手教你完成OpenClaw添加QQ频道的全流程，从前期准备到实操配置，再到故障排查，全程干货无冗余，新手也能轻松上手。

img

一、前置条件

  • • 已安装并正常运行 OpenClaw（本地 / 服务器均可）
  • • 已完成实名认证的 QQ 账号（个人 / 企业）

首先确认你的OpenClaw已成功部署，且版本为最新（旧版本可能不支持QQ频道插件）。部署环境需满足：Windows（建议安装WSL2，原生Windows兼容性较差）、macOS 10.15+或Linux（推荐Ubuntu）；同时已安装Node.js ≥ 22（核心依赖），可通过终端输入“node -v”查看版本是否达标。

若未部署OpenClaw，可先通过官方脚本一键安装（新手首选）：


    
    
    
  macOS/Linux：curl -fsSL https://openclaw.ai/install.sh | bash
Windows（WSL2内）：iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后，输入“openclaw --version”，显示版本号即部署成功。

二、步骤 1：在 QQ 开放平台创建机器人

    1. 访问 QQ 开放平台：q.qq.com/ 或专属入口 q.qq.com/qqbot/openc…
    1. 扫码登录 → 完成实名认证（个人 / 企业）
    1. 进入「机器人管理」→ 点击「创建机器人」，填写名称、头像等信息
    1. 记录 AppID 和 AppSecret（AppSecret 仅显示一次，务必保存）
    1. 开启「私聊 / 群聊 / 频道」权限，将你的服务器公网 IP 加入 IP 白名单

官方指南

img

1.创建机器人-图

img

2.记录APPID和AppSecret

img

三、步骤 2：在 OpenClaw 配置 QQ 频道（命令行）

1. 安装 QQ Bot 插件

    
    
    
  openclaw plugins install @sliverp/qqbot@latest
2. 添加 QQ 通道

    
    
    
  openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"
  • • --channel qqbot：固定频道类型
  • • --token：格式为 AppID:AppSecret
3. 重启网关使配置生效

    
    
    
  openclaw gateway restart

img

验证

可以在你的qq开放平台，点击扫描聊天即可

img

完成之后问小龙虾：

img

四、步骤 3：WebUI 可视化配置（可选）

如果不用命令行，可以在后台操作。

    1. 访问 OpenClaw WebUI（默认 http:// 服务器 IP:18789）
    1. 进入「应用管理」→「Channel 配置」
    1. 选择「QQ」，填入 AppID、AppSecret → 点击「添加并应用」
    1. 重启服务

img

五、步骤 4：验证与使用

    1. 检查服务状态：
    
    
    
    
  openclaw status

    确保状态为

    
    
    
    
  running/active
    1. 在 QQ 中添加机器人为好友，或拉入群 / 频道
    1. 发送消息测试，正常回复即配置成功

六、常用命令速查（高效管理QQ频道）

后续若需修改、删除QQ频道配置，或管理插件，可直接使用以下命令，无需重复操作全流程：


    
    
    
  # 查看已配置的所有频道
openclaw channels list

# 删除QQ频道配置
openclaw channels remove qqbot

# 更新QQ频道token（更换AppID或AppSecret时使用）
openclaw channels add --channel qqbot --token "新的AppID:新的AppSecret"

# 查看QQ机器人插件状态
openclaw plugins status

# 禁用/启用QQ机器人插件
openclaw plugins disable qqbot
openclaw plugins enable qqbot

五、总结

到这里，OpenClaw 接入 QQ 频道的完整流程就全部讲完了。

对比，飞书、企业微信、钉钉的方式，QQ频道是最简单最省事的。

OpenClaw添加QQ频道的核心的是“插件适配+密钥配置”，全程无需复杂的技术操作，只要按照步骤准备好环境、安装插件、获取密钥并配置，就能实现QQ频道与OpenClaw的无缝对接。作为一款“能执行、可扩展”的开源AI智能体，接入QQ频道后，我们可以更便捷地通过QQ下达指令，让OpenClaw帮我们处理重复任务、执行脚本、管理文件等，真正发挥其“数字员工”的价值。

若你在操作过程中遇到其他未提及的问题，可留言补充，或查看OpenClaw官方社区的相关教程，也可通过“openclaw doctor”命令进行环境诊断，快速定位问题所在。

avatar
文章
阅读
粉丝