将 DotCraft 接入 Telegram
用 BotFather 签发的 token 把 Telegram Bot 接成 DotCraft 的一个渠道。不需要公网 URL。
快速设置
打开 Telegram，并与
@BotFather开始聊天。发送
/newbot，按 BotFather 提示完成创建。复制 bot token。
在 DotCraft Desktop 打开目标 workspace。
打开 Channels，选择 Telegram，然后选择 Connect。
粘贴 bot token，然后检查可选代理和超时设置。
保存渠道并启用。
给 Telegram Bot 发送一条消息。
连上 Telegram 后，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列出可用命令。workspace 中定义的斜杠命令也会出现在 Telegram 命令菜单里。- 审批和用户输入请求会尽量使用 Telegram inline buttons。
- 文件和图片投递可通过渠道投递工具使用。
- 同一个 bot token 同一时间只能给一个 DotCraft 实例使用。
独立适配器
只有在不由 Desktop 管理渠道进程时，才需要自己运行 Telegram 适配器。
bash
cd sdk/typescript
npm run build --workspace @dotcraft/channel-telegram
npx dotcraft-channel-telegram --workspace /path/to/workspace独立适配器的 ExternalChannels 注册形态见渠道配置参考。