平台接入

用 AstrBot 在 Discord、Telegram 等聊天软件里回答

您的助手在网站之外也能回答。把它添加为 OpenAI 兼容的模型提供商:可以加到 AstrBot(一个开源聊天机器人框架,支持 Discord、Telegram、Slack、微信、QQ 等),也可以加到 Dify、LobeChat 或任何使用同样 API 的工具。它在那里依据同样的网站资料作答,标准答案、角色和规则都与聊天按钮一致。

更新于 2026年10月21日

准备工作

  • 一个已在我们这里设置好、并使用付费方案(基础、普通、精英或企业)的网站。如果还没有,请用邮箱注册并输入您的网站地址。
  • 一个 API 密钥:在后台打开 聊天软件与 API,给密钥起个名字(例如“AstrBot”),然后点 创建 API 密钥。请立即复制:它只显示这一次。
  • 已运行并连接到聊天软件的 AstrBot(或其他工具)。如何安装 AstrBot 以及连接 Discord、Telegram、Slack、微信或 QQ,请看 AstrBot 自己的文档。

每个工具都会要求填写这三项:

API Base URL:  https://7x24hrs.com/v1
API Key:       sk-7x24-…
Model:         7x24hrs-assistant
示例。请把 sk-7x24-… 换成您在后台创建的密钥。

在 AstrBot 中设置

  1. 打开 AstrBot 管理面板,进入 模型提供商(Providers)。在 对话(Chat Completion)标签下,点 Provider Sources 旁边的 + 新增(Add)。
  2. 在 New model provider 中选择 OpenAI Compatible。
  3. 填一个您认得出的 ID,比如 7x24hrs。把密钥粘贴到 API Key,并把 API Base URL 设为 https://7x24hrs.com/v1。
  4. 点 Save And Fetch Models。在 Available Models 下,点 7x24hrs-assistant 旁边的 +。在弹出的窗口里,Model capabilities 下只保留勾选 Text(取消勾选 Image、Audio 和 Tool use:助手只回答文字),然后点 Save。
  5. 让机器人使用这个模型:在 配置文件(Config)里把它设为默认对话模型(也可以在 聊天(Chat)里用模型切换,只在某个对话中使用它)。
  6. 在 AstrBot 的 聊天(Chat)页面或已连接的聊天软件里问个问题。回答来自您网站的资料。

AstrBot 自带的人格和系统提示词请留空,或尽量写短:您的助手遵循您在 7x24hrs 后台设置的规则和角色,不会听从聊天软件系统提示词里的指令。

Dify、LobeChat 及其他工具

任何带有“OpenAI 兼容”或“自定义 OpenAI”提供商的工具,设置方法都一样:Base URL 填 https://7x24hrs.com/v1,再填您的 API 密钥和模型 7x24hrs-assistant。

  • Dify:在 设置 → 模型供应商中添加 OpenAI-API-compatible,填写模型名称、您的密钥,并把 Base URL 填作 API 地址,然后在应用里使用这个模型。
  • LobeChat:在设置的语言模型部分开启 OpenAI 提供商,填入密钥,把 API 代理地址设为 Base URL,再把 7x24hrs-assistant 加入模型列表。
  • 您自己的代码:用任意 OpenAI 客户端库调用 API,设置好 Base URL 和密钥即可。

在终端里试一下 API:

curl https://7x24hrs.com/v1/chat/completions \
  -H "Authorization: Bearer sk-7x24-…" \
  -H "Content-Type: application/json" \
  -d '{"model": "7x24hrs-assistant", "user": "visitor-42",
       "messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'
示例。请把 sk-7x24-… 换成您在后台创建的密钥。

加上 "stream": true 后,回答会以服务器推送事件(SSE)的形式逐段返回,与 OpenAI 的方式相同:

curl -N https://7x24hrs.com/v1/chat/completions \
  -H "Authorization: Bearer sk-7x24-…" \
  -H "Content-Type: application/json" \
  -d '{"model": "7x24hrs-assistant", "stream": true,
       "messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'
示例。请把 sk-7x24-… 换成您在后台创建的密钥。

在聊天软件里回答是怎样的

网站上的聊天按钮通过 API 的聊天软件
回答依据您的网站资料、标准答案和角色相同
没把握时如实说明,并把访客转给您如实说明,并在回答中给出您的联系地址
通知您通过邮件、Slack、Discord 或 Telegram相同,标注“来自 API / AstrBot”
亲自回复访客在您的聊天软件或后台里无法从这里回复:请用邮件回复
对话计数每位访客每次对话算一次相同,从同一份每月额度中扣除
哪些方案可以接入聊天软件?

所有付费方案:基础方案每月 $19 含 90 次对话,普通方案 $59 含 275 次,精英方案 $199 含 1,000 次,企业方案 $1,099 含 6,000 次。通过 API 的对话与聊天按钮共用同一份每月额度。免费版不包含聊天软件:在免费版上创建的密钥会暂停,直到您选择付费方案。详见价格。

怎样算一次对话?

一位访客的一次聊天,不论问了多少个问题,和聊天按钮完全一样。如果工具在每次请求中都带上 user 字段,我们就能区分不同访客;否则按对话的第一条消息来识别一次对话。

AstrBot 里的系统提示词能改变助手说的话吗?

不能。聊天软件发来的系统提示词不会被采纳。助手始终遵守您的规则:只依据您网站的资料作答,不知道就直说,不承诺您网站上没写的事。它的角色就是您在后台设置的那个。

支持图片、语音消息或工具调用吗?

暂不支持。只回答文字;消息里的图片和其他附件会被忽略,没有文字的消息会收到明确的错误提示。客户端发来的工具定义也会被忽略。

密钥泄露了怎么办?

在 聊天软件与 API 中吊销它:它会立即失效。然后创建一个新密钥,粘贴到您的工具里。密钥只以指纹形式保存,所以我们也无法再次显示某个密钥。

来源