OpenClaw +QQ机器人助手

OpenClaw 适用于任何操作系统的 AI 智能体 Gateway 网关,支持 WhatsApp、Telegram、Discord、iMessage 等。 发送消息,随时随地获取智能体响应。通过插件可添加 Mattermost 等更多渠道。

1. 搭建 OpenClaw

可参考官方文档 ,按需选择适合的安装方式。

如果服务器上安装了1Panel,可以直接从应用商店安装

2. 接入 QQ

1. 申请 QQ 机器人

  • 打开 QQ 开放平台,注册登录,然后创建 QQ 机器人。地址: https://q.qq.com
  • 创建完成后,进入机器人的开发管理页面,找到 AppID 和 AppSecret,复制保存好,等会要用。
  • 还要把你云服务器的 公网 IP 添加到 IP 白名单里,然后保存。
  • 在沙箱配置里给你的 QQ 账号(或者 QQ 群)添加访问机器人的权限:

2. 给 OpenClaw 绑定 QQ 机器人

  • 安装 qqbot 插件 https://github.com/BytePioneer-AI/openclaw-china
    • 远程登录到云服务器上,执行命令来安装 @openclaw-china/qqbot 插件。
    • openclaw plugins install @openclaw-china/qqbot
    • 安装插件成功后,配置QQ 机器人参数,用之前保存的 id 和 secret :
      openclaw config set channels.qqbot.enabled true
      openclaw config set channels.qqbot.appId your-app-id
      openclaw config set channels.qqbot.clientSecret your-app-secret
      openclaw config set channels.qqbot.markdownSupport false
      
    • 需要的话,还可以申请 Markdown 模板能力
    • 重启网关服务 openclaw gateway restart

3. 访问Openclaw 的webUI页面

通常地址为 IP:18789 或者 地址?token=你的token

1. 配置大模型

Config>Models

或者修改配置文件: ~/.openclaw/openclaw.json

命令如

# 把模型指定为 DeepSeek 提供商的 deepseek-chat
openclaw models set deepseek/deepseek-chat
# 重启 Gateway 服务
openclaw gateway restart
# 验证
openclaw models status

2. 定义身份

可以在Chat会话中直接使用提示提定义身份和功能,它会自动去更新文件

或者UI页面 Agents>Files

3. 文件说明

agents.defaults.workspace 内,OpenClaw 期望以下用户可编辑的文件:

  • AGENTS.md — 操作指令 + “记忆”
  • SOUL.md — 人设、边界、语气
  • TOOLS.md — 用户维护的工具说明(例如 imsgsag、约定)
  • BOOTSTRAP.md — 一次性首次运行仪式(完成后删除)
  • IDENTITY.md — 智能体名称/风格/表情
  • USER.md — 用户档案 + 偏好称呼