7418andClaude Opus 4.6
c67f3ef82b
- 重写 index.mdx 为真正的快速开始指南，链接服务商配置 - 新增 chat.mdx（对话模式、权限、上下文管理） - 新增 skills.mdx（技能分类、市场、本地管理） - 新增 design-agent.mdx（单张/批量图片生成、参考图、连续编辑） - 新增 gallery.mdx（素材库浏览、筛选、详情操作） - 重写 providers.mdx — CLI 环境认证 vs 手动添加、cc switch 不生效说明、 国内服务商预设、Anthropic 第三方模型映射、服务商优先级链 - 重写 mcp.mdx — 三种传输类型(stdio/SSE/HTTP)、列表+JSON 双视图 - 重写 assistant-workspace.mdx — 对齐实际设置>助理标签页 - 重写 faq.mdx — 更全面的问答覆盖 - 桥接拆分为 5 页：总览(斜杠命令、全局设置) + Telegram + Discord + 飞书 + QQ - Discord 开发者模式获取 ID 说明移入配置流程 - 飞书长连接模式启动顺序说明 - 所有 UI 按钮/菜单名称改为中文翻译（设置、服务商、技能、桥接等） - 扁平化无子页面的 folder/index.mdx → page.mdx，消除侧边栏多余展开三角 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
81 lines
2.8 KiB
Plaintext
81 lines
2.8 KiB
Plaintext
---
|
||
title: Telegram
|
||
description: 配置 Telegram Bot 桥接。
|
||
---
|
||
|
||
# Telegram 桥接
|
||
|
||
通过 Telegram Bot 与 Claude 对话。支持流式消息预览、权限确认按钮和丰富的 Markdown 渲染。
|
||
|
||
## 创建 Telegram Bot
|
||
|
||
1. 在 Telegram 中搜索 [@BotFather](https://t.me/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 等待权限确认超时，重新发送消息
|