自托管 Chatwoot 如何接入 AI：方案选择与配置教程

先选择适合你的 AI 接入方式

截至 2026 年 10 月 15 日，Chatwoot 官方自托管价格页列明：Community Edition 不含 Captain AI，Premium Support 和 Enterprise 包含。决定接入前，请以官方页面的最新说明为准。

• 使用 Captain：如果 Chatwoot 原生 AI 的功能和付费自托管套餐适合你的团队，可以直接选择。启用前应确认当前套餐和数据处理说明。
• 连接外部 AI 服务：通过 Agent Bot 接入 GPT KeFu 等托管服务，继续使用现有 Chatwoot 收件箱。Chatwoot 仍由你自托管，但 AI 服务在外部运行，不属于全本地部署。
• 自建 Agent Bot：自己编写回复逻辑，或连接自动化工作流。Chatwoot 提供 Webhook 和消息 API；机器人、知识来源和转人工规则由你维护。

• Chatwoot 自托管套餐与 Captain 使用条件
• Chatwoot 官方 Agent Bot 接入说明

1. 准备实例与收件箱信息

在 GPT KeFu 创建 Chatwoot 项目。打开 Chatwoot 的目标收件箱设置，复制浏览器地址；接入页支持从该地址提取 Base URL、Account ID 和 Inbox ID，也可以手动填写。

Base URL 填 Chatwoot 的 HTTPS 站点地址，不带 /app 路径。Account ID 是 /app/accounts/ 后面的数字，Inbox ID 是 /settings/inboxes/ 后面的数字。在 Chatwoot Profile Settings 中复制管理员的个人 Access Token，不要把 Bot Access Token 填入此处。

2. 创建 Bot 并保存签名密钥

在 Chatwoot Settings → Bots 新建或编辑 Agent Bot，复制它的 Webhook Secret，填入 GPT KeFu 的 Agent Bot 签名密钥栏。这个密钥用于回调签名，与 API Access Token 不同。

新建 Bot 如果要求先填 URL，可临时使用一个由你控制的公开 HTTPS 地址，此时先不要绑定 Inbox。复制生成的密钥，在 GPT KeFu 保存连接后，即可获得专属回调地址。保存连接不会直接开启 AI 回复。

3. 替换回调地址并绑定 Inbox

复制 GPT KeFu 显示的 Agent Bot Webhook URL，将 Chatwoot 中临时填写的 outgoing URL 替换为这个完整地址。随后在目标收件箱的 Bot Configuration 中选择该 Bot 并保存。

签名密钥必须来自同一个 Bot。本次接入可保持账号级 Webhook 关闭，Agent Bot 已提供会话状态事件；之后如需配置账号级 Webhook，应使用它自己的地址和密钥。

4. 验证连接后启用 AI

1. 点击检查连接，确认 GPT KeFu 能通过保存的凭据访问 Chatwoot API。
2. 向绑定的 Inbox 发送一条新的访客消息，回到接入页查看签名回调验证状态，必要时再次检查连接。
3. API 连接和真实回调都验证通过后，启用 AI 回复。
4. 再发送一条新的访客消息，并在 Chatwoot 中确认收到 AI 回复。此前用于验证的消息不会自动补发回复。

按失败步骤排查

• API 检查失败：核对 HTTPS 地址、管理员 Token、Account ID 和 Inbox ID，确认代理或防火墙没有阻断服务端访问。
• 回调一直待验证：确认 Bot 绑定了正确 Inbox，且已替换成最终回调地址；用新的访客消息测试，不要用人工客服回复代替。
• 签名验证失败：重新复制同一个 Agent Bot 的 Webhook Secret，并确认实例支持签名回调，不要通过关闭签名检查绕过问题。
• 连接正常但不回复：确认 AI 已启用，检查项目套餐、模型设置，以及人工回复后是否仍处于暂停期间。