TG Bot 手册

通道 A Telegram Bot 的命令、鉴权、后端接线与本地运行说明

3 min read2026-10-26

telegramteloxidechannel-a

角色

apps/tg-bot（包名 sharpside-tg-bot）是通道 A 的 Telegram 命令面：绑定账户、创建/管理跟随、查询交易者与绩效。

日常跟单的主入口是 Web（见创建与管理跟随）。Bot 用命令创建并尝试启动跟随。启动前须在网页完成 Session 授权。

运维细节见仓库 docs/RUNBOOK_TG_BOT.md。

主要命令

命令	后端	作用
`/start`	`POST /auth/tg`（account）	绑定 TG 用户与账户，换 JWT。带推荐码时绕过本地缓存再绑一次
`/follow`	`POST /follows`，随后 `PATCH /follows/:id` `{active:true}`	创建 `channel=tg` 的固定金额跟随，并立刻尝试启动
`/resume`	`PATCH /follows/:id` `{active:true}`	再次启动。没有 `/pause`
`/follows`	`GET /follows`（follow）	列出跟随（不是 `/me/follows`）
`/unfollow`	`DELETE /follows/:id`	取消跟随
`/traders` `/perf`	venue-hub	浏览交易者与绩效
`/setamount`	进程内	默认跟单金额（重启丢失）。最低 5 pUSD
`/invite`	`GET /me/affiliate`	返回 Web 与 TG 推广链接

/follow 启动失败时：

wallet_choice_required 或 execution_unavailable：跟随已创建但未启动，提示打开网页「设置 → 委托」签一次授权。签完前没有充值地址。
现金低于开始门槛（50 pUSD）：提示充值后用 /resume <id>。

暂停跟随请到 Web 我的跟随。Bot 不提供 /pause。

/ask 与 /aitrader 已关闭，不再提供这些功能。见已下架的能力。

鉴权与拓扑

Bot 直连 account / follow / venue-hub（配置 ACCOUNT_URL / FOLLOW_URL / VENUE_HUB_URL），不经 gateway，也不连 copier。余额和成交历史在 Web 上看。Web 走 gateway 时路径带 /api/account 等前缀；Bot 调用服务根路径即可。

鉴权：X-TG-Bot-Secret 调 account POST /auth/tg 换 JWT，本地缓存；遇 401 自动重换。

开户边界

Bot 不能代替网页上的 Session 签名。须在委托管理用自己的钱包签一次授权。签完之前没有充值地址。

运行

export TG_BOT_TOKEN=...
export TG_BOT_SECRET=...   # 与 account 侧一致
export ACCOUNT_URL=http://127.0.0.1:8084
export FOLLOW_URL=http://127.0.0.1:8082
export VENUE_HUB_URL=http://127.0.0.1:8081
cargo run -p sharpside-tg-bot
# 或：./target/debug/sharpside-tg-bot

无 TG_BOT_TOKEN 时进程应优雅退出（exit 0）。本机若无法访问 api.telegram.org，可用 curl 等价流程验证后端契约（见仓库 docs/RUNBOOK_TG_BOT.md）。列表契约请测 GET $FOLLOW_URL/follows，勿用 /me/follows。

Polymarket 联调

影子模式