将 DotCraft 接入 Telegram
使用 BotFather token 把 Telegram Bot 接入 DotCraft。DotCraft 通过 long polling 接收消息，因此不需要公网 webhook URL。
快速设置
- 打开 Telegram，并与
@BotFather开始聊天。 - 发送
/newbot，按 BotFather 提示完成创建。 - 复制 bot token。
- 在 DotCraft Desktop 打开目标 workspace。
- 打开 Channels，选择 Telegram。
- 粘贴 bot token。
- 保存渠道并启用。
- 给 Telegram Bot 发送一条消息。
polling 启动后，Desktop 中的 Telegram 渠道应显示为 connected。
平台设置细节
Telegram 的平台设置主要在 BotFather 中完成：
- 如果希望 Bot 资料更完整，使用
/setdescription、/setabouttext和/setuserpic。 - 如果需要 DotCraft 在群里回复，将 Bot 加入群聊。
- 检查 BotFather 中的群聊 privacy mode。
启用 Telegram privacy mode 时，Bot 可能只会收到命令、回复以及明确提到它的消息。如果需要 DotCraft 看到所有群消息，请在 BotFather 中调整 Bot privacy 设置。
测试连接
- 在 Bot 私聊中发送
hello。 - 确认 DotCraft 回复。
- 发送
/help，确认命令已注册。 - 发送
/new，再发送一条消息，确认它开启新的会话。 - 在群聊中，如果启用了 privacy mode，请 @ 或回复 Bot。
设置后可用能力
- Telegram 将私聊或群聊消息投递给 Bot 后，这些消息可以触发 DotCraft 回合。
/new会开启新的 DotCraft 会话。/help会显示可用命令。- 审批和用户输入请求会尽量使用 Telegram inline buttons。
- 文件和图片投递可通过渠道投递工具使用。
- 同一个 bot token 同一时间只能被一个 long-polling 进程使用。
独立适配器
只有在不由 Desktop 管理渠道进程时，才需要自己运行 Telegram 适配器。
bash
cd sdk/typescript
npm run build --workspace @dotcraft/channel-telegram
npx dotcraft-channel-telegram --workspace /path/to/workspace独立 WebSocket 适配器注册方式见共享的 渠道配置参考。
参考
Telegram 的 JSON 示例、ExternalChannels 注册方式和字段表见 渠道配置参考。