Files
AstrBot/docs/zh/platform/vocechat.md
T
Soulter fc33b3eb68 docs: transfer AstrBotDevs/AstrBot-docs to AstrBotDevs/AstrBot (#5960)
* docs: transfer AstrBotDevs/AstrBot-docs to AstrBotDevs/AstrBot
* refactor: reorder imports and improve type hints in sync_docs_to_wiki.py and upload_doc_images_to_r2.py
* feat: add GitHub Actions workflow to sync wiki with documentation

Co-authored-by: Soulter <37870767+Soulter@users.noreply.github.com>
Co-authored-by: anka-afk <110004162+anka-afk@users.noreply.github.com>
Co-authored-by: zouyonghe <62183434+zouyonghe@users.noreply.github.com>
Co-authored-by: shuiping233 <49360196+shuiping233@users.noreply.github.com>
Co-authored-by: LIghtJUNction <106986785+LIghtJUNction@users.noreply.github.com>
Co-authored-by: Sjshi763 <179909421+Sjshi763@users.noreply.github.com>
Co-authored-by: xiewoc <70128845+xiewoc@users.noreply.github.com>
Co-authored-by: QingFeng-awa <151742581+QingFeng-awa@users.noreply.github.com>
Co-authored-by: PaloMiku <96452465+PaloMiku@users.noreply.github.com>
Co-authored-by: shangxueink <138397030+shangxueink@users.noreply.github.com>
Co-authored-by: IGCrystal-A <244300990+IGCrystal-A@users.noreply.github.com>
Co-authored-by: RC-CHN <67079377+RC-CHN@users.noreply.github.com>
Co-authored-by: MC090610 <113341105+MC090610@users.noreply.github.com>
Co-authored-by: Waterwzy <196913419+Waterwzy@users.noreply.github.com>
Co-authored-by: Lanhuace-Wan <186303160+Lanhuace-Wan@users.noreply.github.com>
Co-authored-by: LiAlH4qwq <61769640+LiAlH4qwq@users.noreply.github.com>
Co-authored-by: HSOS6 <209910899+HSOS6@users.noreply.github.com>
Co-authored-by: th-dd <162813557+th-dd@users.noreply.github.com>
Co-authored-by: miaoxutao123 <81676466+miaoxutao123@users.noreply.github.com>
Co-authored-by: nuomicici <143102889+nuomicici@users.noreply.github.com>
Co-authored-by: nasyt233 <210103278+nasyt233@users.noreply.github.com>
Co-authored-by: jlugjb <7426462+jlugjb@users.noreply.github.com>
Co-authored-by: Raven95676 <176760093+Raven95676@users.noreply.github.com>
Co-authored-by: Futureppo <180109455+Futureppo@users.noreply.github.com>
Co-authored-by: MliKiowa <61873808+MliKiowa@users.noreply.github.com>
Co-authored-by: Fridemn <150212937+Fridemn@users.noreply.github.com>
Co-authored-by: BakaCookie520 <138355736+BakaCookie520@users.noreply.github.com>
Co-authored-by: YumeYuka <125112916+YumeYuka@users.noreply.github.com>
Co-authored-by: xming521 <32786500+xming521@users.noreply.github.com>
Co-authored-by: ywh555hhh <121592812+ywh555hhh@users.noreply.github.com>
Co-authored-by: stevessr <89645372+stevessr@users.noreply.github.com>
Co-authored-by: roeseth <41995115+roeseth@users.noreply.github.com>
Co-authored-by: ikun-1145141 <265925499+ikun-1145141@users.noreply.github.com>
Co-authored-by: evpeople <54983536+evpeople@users.noreply.github.com>
Co-authored-by: Yue-bin <60509781+Yue-bin@users.noreply.github.com>
Co-authored-by: W1ndys <109416673+W1ndys@users.noreply.github.com>
Co-authored-by: TheFurina <218887821+TheFurina@users.noreply.github.com>
Co-authored-by: Seayon <12275933+Seayon@users.noreply.github.com>
Co-authored-by: OnlyblackTea <38585636+OnlyblackTea@users.noreply.github.com>
Co-authored-by: ocetars <74854972+ocetars@users.noreply.github.com>
Co-authored-by: railgun19457 <117180744+railgun19457@users.noreply.github.com>
Co-authored-by: JunieXD <107397009+JunieXD@users.noreply.github.com>
Co-authored-by: advent259141 <197440256+advent259141@users.noreply.github.com>
Co-authored-by: Doge2077 <91442300+Doge2077@users.noreply.github.com>
Co-authored-by: Bocity <23430545+Bocity@users.noreply.github.com>
Co-authored-by: Aurora-xk <192227833+Aurora-xk@users.noreply.github.com>
2026-03-09 23:38:21 +08:00

3.0 KiB

接入 VoceChat

Tip

AstrBot 未自带这个适配器,需要安装 astrbot_plugin_vocechat 插件。该插件由 HikariFroya 开发 ❤️如果您觉得有帮助,请支持开发者,给该仓库点一个 Star。

Warning

这个适配器目前不由 AstrBot 官方维护,因此稳定性未知。

部署 VoceChat

VoceChat 是一个开源的支持多平台、搭建简单的即时通讯平台。

请在 VoceChat 官方网站查看部署方式。

安装 astrbot_plugin_vocechat 插件

进入 AstrBot 仪表盘的插件市场,搜索 astrbot_plugin_vocechat,点击安装。

image

安装完成后,前往 机器人+ 创建机器人 → 选择 VoceChat(若选项缺失,尝试重启 AstrBot 或检查插件安装状态)。

在弹出的配置对话框中点击 启用

配置

  • vocechat_server_url (必填): 您的 VoceChat 服务器的完整 URL 地址。例如: http://localhost:3009https://your.vocechat.domain。请确保末尾没有 /
  • api_key (必填): 您在 VoceChat 后台为该机器人账号生成的 API Key。
  • webhook_path (建议保留默认或自定义): AstrBot 用于接收 VoceChat 推送消息的 Webhook 路径。例如: /vocechat_webhook。您需要在 VoceChat 机器人设置中填写的 Webhook URL 将是 http://<你的AstrBot可访问地址>:<webhook_port><webhook_path>
  • webhook_listen_host (通常为 0.0.0.0): AstrBot Webhook 服务器监听的IP地址。0.0.0.0 表示监听所有可用的网络接口。
  • webhook_port (必填): AstrBot Webhook 服务器监听的端口号。例如: 8080。请确保此端口未被其他应用占用,并且如果您的 AstrBot 服务器在防火墙后,此端口需要被允许访问。
  • get_user_nickname_from_api (布尔值, 默认: true): 是否尝试通过 VoceChat API 获取用户昵称。如果为 false,将使用 VoceChatUser_UID 作为默认昵称。
  • send_plain_as_markdown (布尔值, 默认: false): 如果为 true,发送纯文本消息时会使用 Markdown 格式(可能会影响部分纯文本的显示,但能更好地支持一些特殊字符)。通常建议保持 false,除非有特定需求。
  • default_bot_self_uid (必填): 您要连接的这个 VoceChat 机器人账号在 VoceChat 中的用户 ID (UID)。

全部配置好后,点击右下角的保存按钮。然后前往 VoceChat 中测试。

问题提交

如有疑问,请提交 issue 至插件仓库 以及 AstrBot 仓库

如果您觉得有帮助,请支持开发者,给 astrbot_plugin_vocechat 仓库点一个 Star。