把您的 Xboard 面板接入 ReplyTower

对应插件版本 v1.4.2 / 最后核对 2026-08-10 English | 简体中文 —— ja / zh-TW 版本等到这两个市场有服务商签约时再出。

大约 10 分钟，不改面板任何代码，也不需要服务器权限。

本指南只讲聊天小组件，不包含工单对接，也不在这里承诺工单功能。小组件在 Xboard 默认主题上已验证；换成其他主题可能不显示。

D3 —— 全程要在两个网站之间来回四次。下面每一步都会先写清楚在哪个站操作。

§0 —— 开始之前需要准备什么

所在站点：两边都要

  • 一套原版 Xboard 面板，以及它的管理员登录
  • Xboard ≥ 2.0.0、PHP ≥ 8.2。请您自己确认 —— Xboard 不会强制校验插件声明的最低版本， 老面板照样能装上，然后出各种奇怪问题
  • 面板要能从公网用真实域名访问
  • 大约 10 分钟
  • 注册后可能会先让您填 OpenAI key：如果后台把您带到 Connect AI backend（连接 AI 后端） 页面，先把它完成——包括 §3 在内的其他页面之后才会开放。如果没有这个提示， 不填 key 也能先用起来，自带 key 是可选项（见 §6）

D1 —— 用户和工单一直留在您的面板，会话和知识库放在 ReplyTower，只有模型调用会发往 OpenAI。

§1 —— 注册 ReplyTower 账户

所在站点：replytower.com

打开 replytower.com/register，填邮箱和至少 8 位密码。没有邀请码，不用验证邮箱， 提交后直接登录。后面的步骤请您用账户所有者登录；agent 角色看不到 §3 的配对卡片。

replytower.com/register 的注册表单

§2 —— 在 Xboard 里安装插件

所在站点：您的 Xboard 后台

  1. 下载 https://github.com/zytakeshi/replytower-xboard-plugin/releases/latest —— 附件名为 ai-support-<version>.zip（例如 ai-support-1.4.2.zip），不要解压
  2. Xboard 后台 → 插件管理 → 上传插件 → 选这个 .zip
  3. 先安装，再启用

如果上传被拒绝

这几条是 Xboard 自己弹出的提示，原样对照您屏幕上的文字：

  • 插件包大小不能超过10MB —— 官方发布的 zip 只有 0.2 MB 左右，会撞到这条通常是 自己手动打包的
  • 插件包必须是zip格式 / 无效的文件类型 —— 传成了 .tar.gz、文件夹，或者被本机重新 压过的 zip。请直接上传下载下来的文件，不要解压再压（macOS 尤其会改文件类型）
  • 请选择插件包文件 —— 表单没带文件就提交了
  • Plugin is already up to date —— 升级时 Xboard 会拒绝版本号不比现有版本更高的包。 请下载当前发布版。不要为了重装同一版本去卸载插件——卸载会把插件保存的配对凭据 一起删掉，之后得重新配对。确实需要原版本重装的话，先联系我们

Xboard 插件管理里安装前的 ai_support 卡片

安装并启用之后的同一张 ai_support 插件卡片

§3 —— 在 ReplyTower 生成 connect URL

所在站点：replytower.com

服务商后台 → Settings（设置） → **Xboard Pairing（Xboard 配对）**卡片 → Generate Connect URL（生成连接地址） → Copy（复制）。

按下生成之前，有两件事要先知道：

  • 有效期 30 分钟。建议您要粘贴的时候再生成，不要提前
  • 一次性的，配对成功后自动作废。它不是密码，不用保存

服务商后台 Settings 里的 Xboard Pairing 配对卡片

§4 —— 粘贴到插件里并保存

所在站点：您的 Xboard 后台

插件管理 → ai_support → 配置对话框 → 粘贴到 ReplyTower Connect URL（连接地址） → Save（保存）。只有这一个字段是关键的，另外两个 Auto-Mount Widget（自动挂载小组件）、Panel nginx upload limit (MB)（面板 nginx 上传上限，MB） 保持默认即可。

按下保存的那一刻不会发生任何事。请保持登录状态，随便打开一个后台页面 —— 配对是在 那一次页面加载时完成的。

必须以管理员身份登录。已登出的浏览器标签页不会完成配对，这是设计如此。

D2 —— 保存只是把地址存下来，真正触发配对的是下一次带管理员身份的后台页面加载。

已填好 Connect URL 的 ai_support 插件配置对话框

§5 —— 确认接入成功

所在站点：先 replytower.com，再回您的 Xboard

  1. 后台 → Settings → Panel connection（面板连接）：能看到 ReplyTower 这边是否已记录 您的面板，以及配对时记录的插件版本（之后升级插件不会自动刷新这个数字）和配对时间。 只需要后台登录
  2. 用普通用户身份登录您面板的前台，右下角应该出现聊天气泡
  3. 问它一个您知道答案的问题。能答到点上，说明整条链路都通了

如果您有服务器权限（可选）： php artisan ai-support:smoke-test 会跑 4 项检查， 每项打印 [PASS]/[FAIL]，最后一行是 Results: N passed, M failed。这一步不是必须的， 第 1–3 步才是我们支持的路径。

普通用户登录面板前台后出现的聊天气泡

后台 Settings 里 Panel connection 显示已连接

§6 —— 让它真正好用（可选）

所在站点：replytower.com

  • Import Knowledge Base（导入知识库）（在 Settings 里）。配对时已经自动导入过一次， 面板文档有变动时再跑一次。不导入的话，它答得出通用问题，但答不出您自己的套餐和价格
  • 用您自己的 OpenAI key（Connect AI backend / 连接 AI 后端）。可选，也是隐私上的答案： key 加密存储，您的会话不会走我们的模型账户。请用 api.openai.com 的 key
  • 邀请团队成员，转人工的会话在网页收件箱里处理
  • 琥珀色提示条提示缺订阅时，请开通订阅。在平台要求订阅的配置下，开通之前 您客户那边的 AI 是不回复的——这是正常设计，不是故障

后台顶部那条琥珀色提示条会告诉您还缺什么，以它为准。

§7 —— 排查

ReplyTower 返回的提示是英文原文，下面每行先给原文，再解释。

您看到的说明怎么处理
保存了地址，什么都没发生配对发生在下一次后台页面加载，不是保存时保持登录，打开任意后台页面，等几秒，再刷新前台
打开后台页面了还是没反应那次页面加载不是带管理员身份的请求先登录 Xboard 后台，再打开后台页面。这条请您先查
callback_url resolves to a disallowed address; private and loopback targets require an operator allowlist, and link-local, reserved, multicast, unspecified, and metadata targets are blocked面板报给我们的地址是内网、局域网或回环地址，ReplyTower 根本连不上在 Xboard 系统设置里把 Site URL 设成真实公网地址，再保存一次插件配置
callback_url host does not resolve: <host> 或 callback_url must use http/https面板算不出一个可用的公网地址，常见于反代改写了 Host 头明确设置 Site URL，面板挂在特殊反代后面时这是标准解法
<reason> This attempt did not consume the connect URL: fix the panel address and save the plugin configuration again, or generate a new URL if this one has expired or was already used.ReplyTower 检查了您的面板地址并拒绝了改好地址再保存一次。这次没有消耗您的 connect URL
Too many pairing attempts with an unreachable panel address. Generate a new connect URL in ReplyTower and try again. 或 <reason> This was the last attempt allowed for this connect URL: fix the panel address, then generate a new connect URL in ReplyTower.同一个 connect URL 上用错地址重试了 10 次，这个 URL 已经用完了先把面板地址改对，然后再生成新的 connect URL
Invalid or expired connect tokenURL 超过 30 分钟，或者已经被用过重新生成一个，尽快粘贴
Vendor panel type is already <type>（例如 already whmcs）这个 ReplyTower 账户已经绑定了另一种面板连接器，没法再和 Xboard 配对联系我们更换账户的连接器类型——重试或者重新生成 URL 都没有用
Connect token store unavailable是我们这边的故障，不是您的问题；但我们无法确认您的 connect URL 处于什么状态等几分钟后用同一个 URL 再保存一次。如果这时看到 Invalid or expired connect token，就重新生成一个
Vendor account is not active您的 ReplyTower 账户不在正常状态在后台确认账户状态，或者找我们
气泡一直不出现，也没有任何报错还没配对成功；或 Auto-Mount Widget 关着；或主题没有可注入的位置先看 §5 第 1 步，再看开关，最后换回 Xboard 自带主题试试
会回答，但都是没什么用的通用回答AI 服务那边临时出了问题，或者当前 key 上没有所配置的那个模型过一分钟再试。持续出现的话，在后台 AI 设置里换成您的 key 实际支持的模型
答得都对，但从不提您自己的套餐和价格知识库是空的，或者没索引Settings → Import Knowledge Base，再到知识库页面看有没有文档

还是没搞定

先在 replytower.com 登录，再打开 /help 右下角的聊天气泡问一下。登录状态下， 它能查到 ReplyTower 这边记录到的配对状态；没登录的话，它只能讲解步骤。

还是解决不了的话，请发邮件到 info@replytower.com，我们会尽快回复。