消息桥接
消息桥接
将 Claude 对话桥接到 Telegram、Discord、飞书和 QQ。
消息桥接
消息桥接让你从手机上的即时通讯应用与 Claude 对话。在桌面上启动 CodePilot，配置好 Bot 后，你可以通过 Telegram、Discord、飞书或 QQ 随时随地与 Claude 交互。
支持的平台
| 平台 | 特点 |
|---|---|
| Telegram | 长轮询模式，支持流式预览、权限按钮、丰富的 Markdown 渲染 |
| Discord | WebSocket 模式，支持流式预览、频道/私聊双模式 |
| 飞书 / Lark | WebSocket 模式，支持国内/国际版切换、群组策略控制 |
| REST API 模式，支持图片发送、私聊桥接 |
工作原理
手机 IM → Bot 收到消息 → CodePilot 转发给 Claude → Claude 回复 → Bot 发回 IM- 你在消息平台上向 Bot 发送消息
- CodePilot 的 Bridge 服务接收消息并转发给 Claude
- Claude 处理请求后生成回复
- 回复通过 Bot 发回你的消息平台
- 如果 Claude 需要权限确认（如写文件），会在 IM 中发送确认按钮
基本设置
开启桥接
- 点击侧边栏的 桥接
- 在桥接总览页面打开 桥接主开关
- 分别启用你需要的渠道（Telegram / Discord / 飞书 / QQ）
- 进入各渠道页面配置 Bot 凭据
- 点击 启动 按钮
桥接全局设置
在桥接总览页面可以配置：
- 默认工作目录 — 新对话的默认项目路径
- 默认模型 — 桥接对话使用的模型
- 默认服务商 — 桥接对话使用的 API 服务商
- 自动启动 — CodePilot 启动时自动开启桥接服务
桥接状态
桥接页面实时显示：
- 主服务状态（已连接 / 已断开）
- 各渠道适配器状态
- 活跃的会话绑定数量
- 最后一条消息时间
斜杠命令
在 IM 中可以使用斜杠命令控制 CodePilot：
| 命令 | 参数 | 说明 |
|---|---|---|
/new | [路径] | 新建对话，可指定工作目录 |
/bind | <会话ID> | 绑定当前 IM 聊天到已有的 CodePilot 对话 |
/cwd | /path/to/dir | 切换当前对话的工作目录 |
/mode | plan|code|ask | 切换对话模式 |
/status | — | 查看当前对话状态（ID、工作目录、模式、模型） |
/sessions | — | 列出当前渠道最近的对话（最多 10 个） |
/stop | — | 中止当前正在运行的任务 |
/help | — | 查看可用命令 |
使用建议
- 保持 CodePilot 运行 — 桥接依赖桌面端作为中转，关闭后 Bot 无法响应
- 系统托盘模式 — 最小化到系统托盘，桥接保持活跃不占桌面空间
- 私聊优先 — 建议在私聊中使用，群聊中可能被其他消息干扰
- 权限确认 — Claude 需要执行敏感操作时会在 IM 中发送确认按钮，注意及时处理