AgentGetting Started
接入聊天渠道
把当前 Agent 连接到 Telegram、飞书或 QQ 等聊天渠道
接入聊天渠道
Agent 自己不保存 bot 凭据。
在 Downcity 里，聊天渠道接入分成两层：
- city 全局层：保存 channel account
- agent 项目层：绑定当前 agent 使用哪个
channelAccountId
第一步：在 city 里准备 channel account
先保证全局 channel account 已存在。
然后在项目的 downcity.json 中绑定：
{
"plugins": {
"chat": {
"channels": {
"telegram": {
"enabled": true,
"channelAccountId": "telegram-main"
}
}
}
}
}这段配置表达的是：
- 当前项目启用了 Telegram 入口
- 它要使用全局层里已经存在的
telegram-main账号
第二步：启动或重启 Agent
town agent restart如果这是你第一次给项目接通聊天渠道，重启之后建议立刻发送一条测试消息验证收发链路。
支持哪些渠道
当前文档中重点覆盖：
- Telegram
- 飞书
一个重要边界
如果 channelAccountId 指向一个不存在的全局账号，agent 无法正常使用这个渠道。
交互式 agent manager 在某些场景下会自动清理悬空绑定，但最稳妥的方式仍然是你主动确认绑定目标存在。
一个推荐的接入顺序
第一次接聊天渠道时，建议按这个顺序来：
- 先只接一个渠道
- 先把这个渠道的账号绑定跑通
- 再验证收发
- 最后再逐步加其它渠道
这样排障会简单很多。