Skip to content

机器人管理

机器人管理页用于维护当前校园墙的 OneBot 协议端连接、审核群配置、自动回复和最近事件。

机器人管理

添加机器人

在“管理 / 机器人”中填写:

  • Bot QQ:协议端登录的 QQ 号。
  • 显示名:运营后台展示名称,例如“一号墙”。
  • 审核群号:用于接收新稿件、审核命令和失败通知。
  • 是否同时创建发布目标:适合大多数只有一个墙号的校园墙。

创建后页面会显示连接 URL。把这个 URL 复制到 OneBot 协议端配置中即可。

NapCat 配置建议

在 NapCat 中使用反向 WebSocket 客户端:

  1. 打开 NapCat 的网络或 WebSocket 配置。
  2. 新增反向 WebSocket 客户端。
  3. 把机器人卡片里的完整 URL 粘贴为连接地址。
  4. 确认 NapCat 登录的 QQ 等于 Campux 里的 Bot QQ。
  5. 保存并重启或重新连接协议端。

URL 中已经包含 bot_id 和连接 token。不要手动改 URL,也不要把另一个机器人卡片的 URL 复制给当前墙号。

连接识别

Campux 不通过 IP 或 QQ 号推测机器人归属,而是通过 URL 中的 bot_idtoken 识别:

text
ws://your-domain/onebot/v11/ws?bot_id=<bot-id>&token=<connection-token>

这样一个 Campux 实例可以同时接收多个 OneBot 执行端连接,并准确归属到对应租户和机器人。

自动回复

机器人可以配置两类提示:

  • 私聊非命令自动回复:用户随便发消息时,提示如何注册、重置密码或投稿。
  • 审核群非命令 at 回复:运营者 at 机器人但没有发送命令时,返回审核命令提示。

自动回复支持限速,避免用户重复发送普通消息时刷屏。命令消息不受这个限速影响。

审核群相关命令和审核群非命令 at 回复只在配置的审核群里生效。如果其他群出现类似命令,Campux 会静默忽略。

最近事件

最近事件用于判断协议端是否正常工作:

  • Bot 注册账号
  • Bot 重置密码
  • 审核命令执行
  • QZone cookies 刷新
  • OneBot 连接更新

如果机器人长时间无最近连接时间,优先检查协议端 WebSocket 地址、token 和网络连通性。