用手机远程控制AI团队Cabinet Telegram网关实现全解析【免费下载链接】cabinetAI-first knowledge base and startup OS项目地址: https://gitcode.com/gh_mirrors/cabinet3/cabinetCabinet 是一个开源的 AI-first 知识库与创业操作系统startup OS它在你自己的机器上运行一支 AI 智能体团队。而它的Telegram 网关Telegram Gateway把任意一个 Telegram 机器人变成你的手机遥控器发一条消息Cabinet 里的智能体立刻开工/search一下本地知识库的搜索结果就回到你手机里。本文带你完整看懂这个网关的工作原理、三步启用方法、全部手机命令和安全设计让你第一次接触也能轻松上手 从AI 找你到你控 AI两个方向的 Telegram 连接Cabinet 对 Telegram 的支持分为两个方向这也是理解网关的关键出站Outbound由 mcps/mcp-telegram/ 提供的 MCP 服务器让智能体主动发消息到 Telegram——发送、编辑、贴表情、读取机器人入群后的新消息。入站Inbound本次的主角Telegram 网关让你从手机反向驱动Cabinet——运行智能体、搜索知识库、切换工作区房间能力与在 Cabinet 应用内操作完全一致。两个方向共用同一个机器人网关独占getUpdates长轮询通道Telegram 规定每个机器人只允许一个消费者出站功能则不受影响。完整设计决策记录在 docs/TELEGRAM_REMOTE_CONTROL_PRD.md。Telegram 网关如何工作它就住在本地守护进程里网关不是独立服务而是运行在 Cabinet 本地守护进程daemon内部的一个模块随守护进程启动见 server/cabinet-daemon.ts 中的initTelegramGateway调用也因此能直接访问守护进程的实时搜索索引和房间/智能体数据/search无需任何额外开销。核心代码都在 server/telegram/ 目录下各司其职文件职责gateway.ts生命周期管理长轮询循环、离线积压消息快进、多实例防冲突router.ts安全闸门 命令/文本路由、回复格式化bot-api.ts薄封装的 Telegram Bot API 客户端收发消息、编辑、下载文件config.ts读取.cabinet.env并校验isGatewayEnabled()决定是否启用session-store.ts每会话的内存状态当前对话指针、活跃房间、队列、暂存附件parse.ts / format.tsslug解析、MarkdownV2 渲染与 4096 字符安全分块一条消息的旅程是长轮询收到消息后依次通过安全闸门仅私聊 → 白名单 → 限流详见下文路由分发普通文本/slug触发智能体运行/开头的走对应命令第一条消息通过startConversationRun新建对话后续消息用continueConversationRun继续同一对话与 App 里的对话记录完全同源slug是一次性侧边对话不会污染主对话线程下一条普通消息自动回到编排智能体。三步启用 Telegram 远程网关好消息是整个过程不需要写代码也不需要重启任何服务。第 1 步拿到机器人 Token。通过 Telegram 的 BotFather 创建一个机器人复制它的 Bot Token。第 2 步配置允许名单。在.cabinet.env中填入也可以在设置 → 集成Integrations→ Telegram页面里填写效果相同TELEGRAM_BOT_TOKEN你的机器人Token TELEGRAM_ALLOWED_USERS你的数字用户ID 你的数字 ID 可以通过给 userinfobot 发条消息获取。注意这里要的是数字 ID不是用户名。第 3 步完事。网关自带对.cabinet.env的文件监听文件一改动就自动重新校验并热启/热停网关——在 UI 里连接 Telegram 后立即生效无需重启守护进程。启用条件见 config.ts 中的isGatewayEnabled()Bot Token 存在且允许名单非空缺一不可这是刻意的 fail-closed 设计。两个可选配置环境变量作用TELEGRAM_DEFAULT_AGENT指定默认编排智能体不设时自动挑选优先canDispatch的智能体再退回 editorTELEGRAM_CHAT_ID可选地进一步限定网关只响应某一个聊天手机命令速查表你能让 AI 团队做什么发送内容效果普通文字直接交给编排智能体执行回复实时流式推回手机editor 帮我…这条消息一次性指定某个智能体处理/agents可查看所有可用 slug/search 关键词直接查本地知识库返回带 ✅ 标记的 Top 5 命中不消耗智能体运行/room·/room slug查看 / 切换当前聊天驱动的 Cabinet 房间/agents列出当前房间的智能体清单及各自的 slug/verbose切换详细模式实时显示工具调用与推理过程/model·/model claude-code max查看 / 按聊天切换运行时、模型与推理强度/new·/status·/stop开新对话 · 查看当前运行状态 · 取消运行中的任务/help·/start命令清单 · 个性化欢迎引导文件 / 图片自动存入当前房间并附加到你下一条文字消息的任务上 流式回复手机上的正在输入…体验Telegram 本身没有 token 级流网关的解法是编辑同一条消息收到消息后先发 thinking…占位符同时循环刷新正在输入提示然后网关自己轮询会话输出把增量结果节流≥1.5 秒一次地编辑进占位消息超过 4096 字符时在 Markdown 实体安全边界处分块续写。最终回复以 MarkdownV2 渲染加粗、代码块、链接转义失败时自动降级为纯文本保证消息永远能送达。默认是简洁模式只显示最终答案发/verbose就能围观智能体 正在读 budget.md这类过程细节。安全模型默认只认白名单远程控制意味着谁给机器人发消息谁就能在你的机器上运行智能体所以网关的安全设计相当保守 白名单 fail-closed不在TELEGRAM_ALLOWED_USERS里的发送者收到一条拒绝回复即被丢弃永远不执行仅私聊群聊消息一律忽略限流每用户滚动 60 秒最多 10 条超出得到慢一点的软提示并发控制每个聊天至多 1 个运行中任务 1 条排队绝不并行跑智能体防抢注网关通过owner.json标记声明对机器人的占有第二个守护进程实例会自动让路避免两个网关抢同一条消息流离线积压快进守护进程停机期间积压超过约 5 分钟的旧消息启动时直接丢弃而不自动执行防止醒来先跑一堆过期命令会话状态仅存内存守护进程重启后每个聊天重置为全新对话——这是有意的设计避免跨重启的不一致状态。常见边界情况怎么处理slug写错不存在的智能体会自动回退到编排智能体并附一行说明任务跑很久Telegram 触发的运行没有墙钟超时与应用内行为一致随时/stop取消队列已满已有一条排队时再发新消息会被礼貌地丢弃并提示文件过大Bot API 约 20 MB 的上限超出会收到友好拒绝Token 失效启动时getMe校验失败网关安静地保持关闭并记录日志不会拖垮守护进程。小结Cabinet 的 Telegram 网关用同一个机器人、双向能力的设计把 AI 团队的控制权装进了你的口袋零新进程、零新网络面、配置热生效安全默认锁死在白名单之内。如果你想体验只需一个 Bot Token 和你的数字 ID三步之后手机上的 Telegram 就是你的 AI 指挥中心了 ⚡ 更多设计细节可查阅 docs/TELEGRAM_REMOTE_CONTROL_PRD.md实现源码见 server/telegram/。【免费下载链接】cabinetAI-first knowledge base and startup OS项目地址: https://gitcode.com/gh_mirrors/cabinet3/cabinet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考