Telegram 桥接

通过 Telegram Bot 与 Claude 对话。支持流式消息预览、权限确认按钮和丰富的 Markdown 渲染。

创建 Telegram Bot

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot
3. 按提示输入 Bot 名称（显示名）和用户名（以 _bot 结尾）
4. BotFather 会返回一个 Bot Token，格式类似 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
5. 复制 Token 备用

在 CodePilot 中配置

1. 点击侧边栏 桥接，切换到 Telegram 页面
2. 在 Bot 凭据 区域粘贴 Bot Token
3. 点击 测试连接 验证 Token 是否有效
4. 验证成功后，点击 自动检测 Chat ID：
   • 先在 Telegram 中向你的 Bot 发一条任意消息
   • 然后点击检测按钮，CodePilot 会自动获取你的 Chat ID
5. （可选）在 允许的用户 中填写允许使用 Bot 的 Telegram 用户 ID，多个用逗号分隔。留空则不限制。
6. 点击 保存

启用桥接

1. 回到桥接总览页面
2. 确保 Telegram 渠道开关已打开
3. 确保桥接主开关已开启
4. 点击 启动

现在在 Telegram 中向 Bot 发送消息，你就能收到 Claude 的回复了。

流式预览

Telegram 桥接支持流式消息预览 — Claude 生成回复时，Bot 会实时更新消息内容，让你不用等完整回复就能看到进展。

流式预览的参数可以在高级设置中调整：

• 最小更新字符数 — 累积至少多少新字符后才更新消息（默认 20）
• 最小更新间隔 — 两次更新之间的最短间隔（默认 700ms）
• 最大消息长度 — 预览消息的最大长度（默认 3900 字符）

消息格式

Telegram 桥接会将 Claude 的 Markdown 回复转换为 Telegram HTML 格式：

• 代码块 → <pre> 带语言标注
• 粗体、斜体 → HTML 标签
• 链接 → 可点击链接
• 超长消息自动分片（每片最大 4096 字符）

如果 HTML 渲染失败，会自动降级为纯文本发送。

权限处理

当 Claude 需要执行敏感操作时，Bot 会发送一条带有内联按钮的消息：

• 允许 — 允许本次操作
• 允许本次会话 — 本次会话内同类操作自动允许
• 拒绝 — 拒绝操作

故障排除

Bot 没有响应

1. 确认 CodePilot 桥接服务已启动（桥接页面显示"已连接"）
2. 确认 Telegram 渠道开关已打开
3. 确认 Bot Token 正确（重新测试连接）
4. 如果设置了允许用户列表，确认你的用户 ID 在列表中

收到错误消息

• API 额度不足 — 检查 API 密钥余额
• 模型不可用 — 检查桥接默认服务商和模型配置
• 权限超时 — Claude 等待权限确认超时，重新发送消息