Lazy loaded image
项目开发
🛠️（又中止）黑盒语音机器人适配器_Astrbot
Words 1008Read Time≈ 3 min
2025-8-23
2026-1-13
type
summary
status
category
tags
slug
date
password
icon
状态
子标签
标签
日期
Jan 13, 2026 08:03 AM
CONTENT
1.0中止版归档2.0方案2.1Cited
 

1.0中止版归档

Step1：搜集信息_Input

阅读

  1. Astrbot适配器开发文档：开发一个平台适配器 | AstrBot
    开发一个平台适配器 | AstrBot

    开发一个平台适配器 | AstrBot

    AstrBot

  1. 黑盒语音机器人开发文档：教程 - 黑盒语音机器人帮助文档
    教程 - 黑盒语音机器人帮助文档

    教程 - 黑盒语音机器人帮助文档

    ；
  1. 其它插件或适配器源代码
显然做适配器开发需要自己读懂各种接口参数的功能和规范才能对接，但时间精力成本有限，选择给AI做开发
前瞻：如果出现大量BUG，哪怕是最简单的语法错误，乃至函数名错乱，其实都会直接阻滞，所以就这一上午，不行就撤

工具

  1. Gemini：
    1. 版本：2.5pro
    2. deepthink，deepresearch，studio三份方案
  1. deepseek
  1. 扣子
 
 
 
 
 

Step2：处理信息_Learn

整理材料

  1. 准备相关文档链接
    1. 备选：无法读取url文档的话，只能保存一份本地文件，再上传
2. prompt：
开发一个适配器，用于接入开源项目Astrbot，适配黑盒语音平台。 Astrbot开发平台适配器的说明文档：https://docs.astrbot.app/dev/plugin-platform-adapter.html 黑盒语音机器人的开发说明文档的地址：https://s.apifox.cn/43256fe4-9a8c-4f22-949a-74a3f8b431f5 请一步一步开发，先阅读地址中项目的具体源代码，总结出规范的接口以及对接接口的方法，再做具体适配黑盒语音的适配器开发，最终生成成品代码。并附上如何将代码转换为插件，方便安装进Astrbot（已经部署成功）。
 
 

开发方案

  1. Gemini_deepthink：
‎Gemini - 开发 AstrBot 黑盒语音适配器
Created with Gemini
‎Gemini - 开发 AstrBot 黑盒语音适配器
https://g.co/gemini/share/21ebd02a28f7
‎Gemini - 开发 AstrBot 黑盒语音适配器
  1. Gemini_deepresearch：
  1. Gemini_studio：
      2. Gemini_studio
 
 

想法

  1. 虽然终止，但过程中能看到各种Agent集成器表现惊艳，比如扣子空间，真的能调用Chrome去操作然后提取所需内容，还跟我要astrbot的源码，估计在操作虚拟机的环境；比如minimax的任务执行预览窗，也很直观。Gemini感觉现在还没有类似的成品，其deep research和studio都是LLM对话层面的，没有触及MCP调用相关工具。
  1. 现在只是缺少操作的精准度和精细度
 
 
 

Step3：成果产出_Output

发布飞书版本

飞书bot
 
 
 
 

Cited

 
 
 
 
 
 
 
 
 
 
 

2.0

方案

  1. 找其它适配器源码，比如kook的
astrbot_plugin_kook_adapter
wuyan1003 • Updated Dec 8, 2025
  1. 开发：
    1. 方案一：文档当context，Gemini网页出方案，code assist执行。
    2. 方案二：重新plan，执行
    3. 方案三：按照方案，自己读黑盒开发文档：连接到黑盒语音服务 - 黑盒语音机器人帮助文档
      连接到黑盒语音服务 - 黑盒语音机器人帮助文档

      连接到黑盒语音服务 - 黑盒语音机器人帮助文档

      ，然后Gemini网页辅助，开发
  1. 开发失败
    1. 环境配置
    2. 黑盒语音的API接口：已经停滞开发很久了，websocket接收，http推送，但总跑不通
 

2.1

prompt
提供参考：astrbot项目官方适配器开发指导plan.md；reference中的kook平台的适配器插件源码；heychat平台的api说明文件heychat.openapi.json和服务端api补充说明文件seversentevents.md。
要求：开发heychat平台的适配器，用于将astrbot项目接入heychat平台；
请进行开发
清理适配器列表，防止命名冲突：

platform

一个列表，存储了 AstrBot 的消息平台适配器配置。当前，AstrBot 默认支持的消息平台适配器有 aiocqhttp、qqofficial、vchat。如果你想通过修改配置文件的方式新增消息平台适配器，可以根据需要复制下面的配置并添加到这个列表中。
由于配置较多，具体配置请参考 消息平台适配器。
 
 
 
 
 
 
 
 

Cited

您在适配器配置中只需要关心以下三个参数：
  • token: 您的机器人令牌。
  • base_url: API 的基础地址 (例如: https://chat.xiaoheihe.cn)。
  • websocket_url: WebSocket 的连接地址 (例如: wss://chat.xiaoheihe.cn/chatroom/ws/connect)。
      •  
       
docker logs -f 31aebbc4a19f
 
http://prod-cn.your-api-server.comwss://chat.xiaoheihe.cn/chatroom/ws/connect
 
 
 
 
 
 
 
 
 
 
 
上一篇
Git
下一篇
照片手办化应用
Catalog