Ubuntu 24.04 本地部署 openclaw qq接入

下面将指导您完成QQ机器人插件的安装与配置。整个过程清晰简单，请按步骤操作即可。

安装QQBot插件

首先，请确保您的OpenClaw环境已就绪。若尚未注册账号，请先完成注册，具体步骤可查阅官方文档。

接下来，执行核心安装命令：

openclaw plugins install @sliverp/qqbot@latest

安装完成后，需要为插件添加通信通道，请在此命令中替换为您的真实QQ机器人凭证：

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

执行成功后，重启网关服务以使配置生效：

openclaw gateway restart

测试插件运行状态

重启后，如何验证插件是否成功运行？最直接的方法是查看实时日志。

打开终端，运行以下命令以持续跟踪系统动态：

openclaw logs --follow

若一切正常，您将在日志中看到QQBot插件的相关启动信息。您可通过下方截图对比确认运行状态。

处理日志中的常见提示

查看日志时，可能会遇到如下安全提示：

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）后给出的安全建议，旨在确保只有受信任的插件会被加载。

处理方法如下：首先，编辑OpenClaw的配置文件：

vim openclaw.json

在配置文件中，找到或添加 "plugins" 字段，并按如下示例进行配置：

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

保存配置并退出编辑器后，再次重启网关服务，该提示便会消失：

openclaw gateway restart

至此，QQ机器人插件已成功安装并完成基础配置。接下来，您可以开始配置机器人的具体交互逻辑了。