Ubuntu 24.04 本地部署 openclaw qq接入

在本文中，我们将详细介绍如何在OpenClaw平台上安装和配置QQ机器人插件。这个过程清晰明了，只需按照以下步骤操作即可顺利完成。

1 如何安装QQBot插件

首先，请确保你的OpenClaw系统已正确部署并可以正常运行。若你尚未拥有账号，请访问官方文档完成账户注册与系统初始化。

接下来，在系统的终端或命令行工具中，执行以下核心安装指令：

openclaw plugins install @sliverp/qqbot@latest

安装完成后，需要为QQ机器人插件建立一个专属的通信通道。这一步需要你提供从QQ开放平台获取的机器人验证信息：

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

命令成功执行后，为了使所有配置更改生效，必须重启OpenClaw的网关服务：

openclaw gateway restart

2 验证插件安装状态

重启网关后，如何确认QQ机器人插件已成功加载并运行呢？最有效的方法是实时监控系统日志。

打开一个新的终端窗口，运行以下日志跟踪命令，该命令将持续输出系统的运行状态和插件活动信息：

openclaw logs --follow

如果配置无误，你将在滚动日志中看到与“QQBot”插件相关的成功启动记录。为帮助你更准确地识别成功状态，可参考下方提供的运行状态截图进行比对。

3 解读日志与解决常见配置问题

在查看日志过程中，你可能会遇到如下格式的警告信息：

openclaw logs --follow warn plugins {"subsystem":"plugins"} [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: qqbot (/home/llh/.openclaw/extensions/qqbot/index.ts). Set plugins.allow to explicit trusted ids

请不要担心，这并非错误，而是一个安全特性提示。系统检测到你安装了非官方的第三方插件（qqbot），并建议你将其ID明确加入信任列表，以防止未来其他未知插件被自动加载，从而提升系统安全性。

解决方法非常简单，只需编辑OpenClaw的主配置文件：

vim openclaw.json

在配置文件中，定位或新增 "plugins" 配置节，并按照以下示例添加配置，将“qqbot”加入允许列表：

"plugins": {
  "allow": ["qqbot"],
  "entries": {
    "qqbot": {
      "enabled": true
    }
  }
}

配置文件修改保存后，再次重启网关服务以使新的安全策略生效：

openclaw gateway restart

至此，QQ机器人插件的安装、配置与基础调试全部完成。插件已处于就绪状态，接下来你可以根据需求，深入配置机器人的对话逻辑、指令集和群组管理功能了。