🐧 OpenClaw QQ机器人教程

导读：QQ群里的AI机器人是最接地气的AI应用。本教程教你用OpenClaw搭建一个功能强大的QQ机器人——能聊天、能搜索、能定时提醒，还能管理群。

📋 功能介绍

OpenClaw QQ集成的核心能力：

• 群聊对话 - @机器人即可触发AI对话
• 私聊交互 - 支持一对一私聊场景
• 定时提醒 - 基于Cron的提醒功能（"5分钟后提醒我开会"）
• 消息推送 - 主动向群/用户推送消息
• 多群管理 - 一个Agent服务多个QQ群
• 富文本支持 - 图片、文件、表情包等多媒体消息

🔧 配置步骤

Step 1: 准备QQ机器人

1. 前往 QQ开放平台 注册机器人
2. 创建应用，获取AppID和Token
3. 配置机器人权限（群消息、私聊等）
4. 发布机器人到目标QQ群

# QQ机器人配置信息
AppID: 123456789
Token: your_bot_token
AppSecret: your_app_secret

# 机器人能力
- 群聊@消息响应
- 私聊消息响应
- 定时消息推送
- 文件/图片发送

Step 2: OpenClaw配置

# ~/.openclaw/config.yaml
channels:
  qqbot:
    enabled: true
    app_id: "123456789"
    token: "your_bot_token"
    app_secret: "your_app_secret"
    # 触发方式：@mention 或 keyword
    trigger: "@mention"
    # 忽略的群
    ignore_groups: []

# 环境变量方式
export QQBOT_APP_ID="123456789"
export QQBOT_TOKEN="your_bot_token"

Step 3: 使用提醒功能

# 在QQ群中使用
@妙趣AI 5分钟后提醒我开会
@妙趣AI 每天早上9点提醒我看日报
@妙趣AI 帮我设置一个明天下午3点的提醒

# 通过OpenClaw CLI
openclaw remind add \
  --channel qqbot \
  --target "group_openid" \
  --content "开会提醒" \
  --time "5m"

# Cron定时提醒
openclaw cron add \
  --name "daily-reminder" \
  --schedule "0 9 * * *" \
  --task "发送每日提醒到QQ群"

Step 4: 消息推送

# 推送消息到QQ群
openclaw message send \
  --channel qqbot \
  --target "group_openid" \
  --message "📰 今日AI日报已更新！"

# 推送到私聊
openclaw message send \
  --channel qqbot \
  --target "user_openid" \
  --message "你有一条新通知"

# 发送图片
openclaw message send \
  --channel qqbot \
  --msg-type image \
  --media "/path/to/image.png"

💡 最佳实践

# 提醒功能的底层实现
# OpenClaw会自动将提醒转为Cron任务
{
  "action": "add",
  "content": "喝水提醒",
  "time": "1h",
  "to": "qqbot:group:group_openid"
}

# 查看所有提醒
{
  "action": "list"
}

# 删除提醒
{
  "action": "remove",
  "jobId": "job_id_from_list"
}

🚨 常见问题

• Q: 机器人回复太慢？ - 检查网络延迟，或使用更快的LLM模型
• Q: 能否发送表情包？ - QQ Bot API支持发送表情，需要表情ID
• Q: 如何限制机器人只在特定群活跃？ - 配置ignore_groups白名单
• Q: 支持哪些消息类型？ - 文本、图片、文件、富文本、Markdown

📊 QQ Bot vs 其他平台

特性	QQ Bot	飞书	企业微信
用户基数	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐
开发门槛	⭐⭐⭐	⭐⭐	⭐⭐⭐
API丰富度	⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐
企业场景	⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐
个人场景	⭐⭐⭐⭐⭐	⭐⭐	⭐⭐

🔗 相关链接