在自己的机器接待客户。

使用自己的 Telegram Bot、飞书机器人和翻译服务。无需注册渡桥，无需公网域名。

Go 独立运行方式已提供

使用 standalone 启动。当前仍需自己的 PostgreSQL 保存接待与去重状态；Docker Compose 可一起运行程序和数据库。

需要跨天回复、主动联系客户？

个人账号版通过自己的 Telegram 业务账号发送，已有客户仍在飞书 Thread 回复。首版独立自部署，登录会话留在部署机器。

你的机器
+---------------------------------------+
| Go 转发程序 + 本地配置 + PostgreSQL    |
|   +-- 主动连接飞书（长连接）           |
|   +-- 主动获取 Telegram 消息（长轮询） |
|   +-- 调用你配置的翻译服务             |
+---------------------------------------+
渡桥 SaaS 不参与；运行机器需要能访问两端。

1. 准备自己的机器人

准备专用 Telegram Bot，并开启聊天管理能力。在自己的飞书组织创建企业自建应用、开启机器人和消息权限。

不要让独立程序与 SaaS 同时使用同一个 Telegram Bot。程序发现已有回调会停止轮询，避免抢收消息。

2. 填写本地配置

使用发布包中的 .env.standalone.example，复制为 .env.standalone。填写自己的机器人凭据、翻译服务和数据库配置。密钥留在自己的机器。

./duqiao keygen

将生成结果保存为 BRIDGE_ENCRYPTION_KEY；已有数据时不能换掉这个密钥。

3. 连接飞书

填写 App ID 和 App Secret 后启动发现工具：

./duqiao discover-feishu --env-file .env.standalone

显示连接成功后，在飞书「事件与回调 → 事件配置」选择「使用长连接接收事件」，保存，开通消息与附件权限并发布。

将机器人加入客服群，在群里 @它发送一句话。工具只输出群和客服编号，不发送消息。将编号填回配置，再按 Ctrl+C 停止发现工具。

不需要填写 Encrypt Key、Verification Token 或公网回调地址。

4. 授权 Telegram 并启动

由接待账号本人在 Telegram 中关联自己的 Bot，选择允许管理的私聊，并允许回复。先开放自己的测试聊天。

配置 BRIDGE_POLICY=ru 自动接待俄语新客户，或 all 接待授权范围内全部客户。核对配置后设 BRIDGE_ENABLED=true。

./duqiao standalone --env-file .env.standalone

如果使用仓库提供的 Docker Compose：

docker compose --env-file .env.standalone -f compose.standalone.yaml up -d --build --wait

本机状态入口：127.0.0.1:18787/status。无需微信登录或商家注册。

5. 用自己的测试账号试聊

俄语来信 -> 飞书中文 -> 客服话题内回复 -> Telegram 译文
    |
同一客户继续发 VIN、图片、文件 -> 分别核对两端
    |
重启程序 -> 原有接待状态与话题保留

连接成功表示通道在线，实际收发仍取决于授权、权限和发布。已接待客户后续消息不再受首次语言规则限制。

当前独立版不自动迁移旧 Python 数据或提供文件夹接管。备份自己的 PostgreSQL 与原加密密钥。

希望我们负责部署和维护？

使用渡桥托管服务，商家自建飞书应用也推荐长连接，只填 App ID 和密钥即可开始接入。

回到渡桥工作台 →