Bot 开发者指导
DeBox 机器人 开发总览
本文是 DeBox Bot 的总览文档，覆盖从 BotMother 找到入口、创建机器人、管理配置，到基于 SDK 二次开发的完整路径。
1. 先找到 BotMother
可以通过以下 3 种方式打开 BotMother：
- 深链接：
https://m.debox.pro/user/chat?id=u7ooqdjt&start= - 地址搜索：
0xda521900ac9dfeff8a8e692bb627ff8cd80a7b28 - 从 DeBox Ai 助手入口进入
按实际操作顺序，建议优先从 Ai 助手入口开始：
1.1 通过 Ai 助手入口找到 BotMother
1.2 进入 BotMother 会话入口
1.3 查看 BotMother 指令菜单
2. 通过 BotMother 创建 Bot
在 BotMother 中按指令流程完成创建，典型步骤：
- 输入创建指令（按 BotMother 当前提示）。
- 设置 Bot 基础信息（名称、头像、简介等）。
- 创建完成后进入 Bot 管理列表。
3. Bot 管理与配置修改
创建后，先在管理页完成基础配置，再选择开发模式。
3.1 Bot 管理首页
你可以在这里：
- 查看已有 Bot 列表
- 进入单个 Bot 管理页
- 新增或 删除 Bot
3.2 单个 Bot 管理页
你可以在这里完成：
- 基础资料修改（名称、描述、头像）
- 凭证管理（
API Key，必要时App Secret） - Webhook 配置（
App Domain、Webhook URL）
4. 两种开发模式（必须先选）
DeBox Bot 提供两种收消息模式：
- Webhook 模式（平台主动推送到你的服务）
- Long Polling 模式（你的程序主动轮询
getUpdates）
两者严格互斥：
- 配置了 Webhook 后，Webhook 优先生效。
- 此时 Long Polling 将收不到或几乎收不到消息。
- 若要改回 Long Polling，先清空 Webhook 配置。
5. Webhook 模式怎么用
最小接入步骤：
- 在 Bot 管理页配置
App Domain。 - 配置
Webhook URL（公网 HTTPS 地址）。 - 服务端实现回调接口，校验请求头
X-API-KEY == Webhook Key。 - 回调处理中按业务逻辑调用 OpenAPI 回消息。
推荐参考：
6. Long Polling 模式怎么用
最小接入步骤：
- 确认平台未配置 Webhook。
- 使用 SDK 初始化 Bot（
API Key+API Secret）。 - 开启消息监听并循环处理
GetUpdates/GetUpdatesChan。 - 收到消息后调用发送接口回消息。
7. 三个 SDK 选型建议
DeBox 目前提供三套官方 SDK：
- Go SDK：
- 文档：DeBox 机器人 Go SDK
- 适合高并发后端与工程化部署。
- Nodejs SDK：
- 文档：DeBox 机器人 Nodejs SDK
- 适合 JS/TS 技术栈与快速迭代场景。
- Python SDK：
- 文档：DeBox 机器人 Python SDK
- 适合 AI 工作流、脚本化任务与数据处理场景。
8. 接口开发主文档
SDK 负责“怎么调用”，OpenAPI 负责“参数值域和响应结构”。
新开发请同时参考：
9. 推荐实施路径
- 先通过 BotMother 创建并完成基础配置。
- 小流量阶段优先用 Webhook 模式联调。
- 按团队语言栈选择 Go/Nodejs/Python SDK。
- 统一以 OpenAPI 参数定义做最终校验。