tg-bot-binding

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Telegram Bot Binding Guide

Telegram Bot绑定指南

When the user asks about Telegram Bot binding, setup, connection, verification, or any related topic, provide them with the following guide. Always respond in the user's language.

当用户询问Telegram Bot绑定、设置、连接、验证或任何相关话题时，请为他们提供以下指南。始终使用用户的语言回复。

Overview

概述

Starchild allows you to connect your own Telegram Bot so you can interact with your AI agent directly in Telegram. The binding process involves 3 main steps:

Create a Bot on Telegram
Add the Bot Token in Starchild Dashboard
Verify ownership in Telegram

Starchild允许您连接自己的Telegram Bot，以便直接在Telegram中与AI agent交互。绑定流程包含3个主要步骤：

在Telegram上创建Bot
在Starchild控制台中添加Bot Token
在Telegram中验证所有权

Step-by-Step Binding Process

分步绑定流程

Step 1: Create a Telegram Bot via BotFather

步骤1：通过BotFather创建Telegram Bot

Open Telegram and search for @BotFather (the official Telegram bot for creating bots).
Send
```
/newbot
```
to BotFather.
Follow the prompts:
- Enter a display name for your bot (e.g., "My Starchild Agent").
- Enter a username for your bot (must end in
```
bot
```
  , e.g.,
```
my_starchild_bot
```
  ).
BotFather will reply with your Bot Token — a string like
```
123456789:ABCdefGHIjklMNOpqrsTUVwxyz
```
. Copy this token and keep it safe. Do not share it publicly.

打开Telegram并搜索**@BotFather**（Telegram官方的机器人创建工具）。
向BotFather发送
```
/newbot
```
。
按照提示操作：
- 为您的机器人输入显示名称（例如：“My Starchild Agent”）。
- 为您的机器人输入用户名（必须以
```
bot
```
  结尾，例如：
```
my_starchild_bot
```
  ）。
BotFather会回复您的Bot Token——一串类似
```
123456789:ABCdefGHIjklMNOpqrsTUVwxyz
```
的字符串。复制此令牌并妥善保管，请勿公开分享。

Step 2: Add the Bot Token in Starchild Dashboard

步骤2：在Starchild控制台中添加Bot Token

Go to the Starchild Dashboard (web interface).
Click your avatar at the bottom-left corner of the page.
In the Account Management popup, find the Telegram Bot section.
Paste your Bot Token and submit.
The system will:
- Verify the token with Telegram's API (calling
```
getMe
```
  ).
- Generate a 6-digit verification code (valid for 5 minutes).
- Set the bot status to "pending".
You will see the verification code displayed on the dashboard. Copy this code.

访问Starchild控制台（网页界面）。
点击页面左下角的头像。
在账户管理弹窗中，找到Telegram Bot板块。
粘贴您的Bot Token并提交。
系统将：
- 通过Telegram API验证令牌（调用
```
getMe
```
  接口）。
- 生成一个6位验证码（有效期5分钟）。
- 将机器人状态设置为**“pending”**。
您会在控制台上看到验证码显示。复制此验证码。

Step 3: Verify Bot Ownership in Telegram

步骤3：在Telegram中验证机器人所有权

You have two ways to verify:

您有两种验证方式：

Option A: Deep Link (Recommended)

选项A：深度链接（推荐）

Click the verification link provided on the dashboard. It will open your bot in Telegram and automatically submit the verification code. The link format is:

https://t.me/<your_bot_username>?start=verify_<CODE>

点击控制台提供的验证链接，它将在Telegram中打开您的机器人并自动提交验证码。链接格式如下：

https://t.me/<your_bot_username>?start=verify_<CODE>

Option B: Manual Verification

选项B：手动验证

Open your bot in Telegram (search for
```
@<your_bot_username>
```
).
Send
```
/start
```
— the bot will prompt you to enter the verification code.
Type the 6-digit code and send it.

在Telegram中打开您的机器人（搜索
```
@<your_bot_username>
```
）。
发送
```
/start
```
——机器人会提示您输入验证码。
输入6位验证码并发送。

Step 4: Done!

步骤4：完成！

Once verified, the bot status changes to "active" briefly, then automatically transitions to "running" — meaning your bot is live and ready. You can start chatting with your AI agent through Telegram. Send

/start

to see the welcome message and available commands.

验证通过后，机器人状态会短暂变为**“active”，随后自动切换为“running”**——这意味着您的机器人已上线并准备就绪。您可以开始通过Telegram与AI agent聊天。发送

/start

查看欢迎消息和可用命令。

Bot Status Reference

机器人状态参考

Status	Meaning
`pending`	Bot token added, awaiting ownership verification
`active`	Ownership verified, transitioning to running
`running`	Bot is live and ready to use
`deleted`	Bot has been removed by the user

状态	含义
`pending`	已添加Bot令牌，等待所有权验证
`active`	所有权已验证，正在切换至运行状态
`running`	机器人已上线并可使用
`deleted`	机器人已被用户移除

Troubleshooting

问题排查

"Verification code expired"

“验证码已过期”

The verification code is valid for 5 minutes. If it expires:

Go back to the Dashboard and click "Refresh Code" to generate a new one.
Then verify again in Telegram with the new code.

验证码有效期为5分钟。如果过期：

返回控制台并点击**“Refresh Code”**生成新的验证码。
然后在Telegram中使用新验证码重新验证。

"Too many failed attempts"

“失败尝试次数过多”

After 5 incorrect attempts, the verification code is invalidated for security:

Go to the Dashboard, delete the bot, and add it again to get a fresh code.

经过5次错误尝试后，验证码会因安全原因失效：

前往控制台，删除机器人，然后重新添加以获取新的验证码。

"Bot token is already registered by another user"

“Bot令牌已被其他用户注册”

Each Bot Token can only be bound to one Starchild account. If you see this error:

Make sure you're using a new, unused bot token.
If you previously used this token, the old binding may still exist. Create a new bot via @BotFather.

每个Bot令牌只能绑定到一个Starchild账户。如果看到此错误：

确保您使用的是全新、未使用过的Bot令牌。
如果您之前使用过此令牌，旧绑定可能仍然存在。请通过@BotFather创建新的机器人。

"You already have an active bot"

“您已有一个活跃的机器人”

Each account can only have one active bot at a time:

To switch bots, first delete the current bot from the Dashboard, then add the new one.
Note: After deleting a bot, there is a 1-hour cooldown before you can add a new one.

每个账户同一时间只能拥有一个活跃机器人：

如需切换机器人，请先从控制台删除当前机器人，再添加新的机器人。
注意：删除机器人后，有1小时的冷却期，之后才能添加新的机器人。

"Cooldown active — Please wait before adding a new bot"

“冷却期已激活——请等待后再添加新机器人”

After deleting a bot, you must wait 1 hour before adding a new one. The dashboard will show the cooldown expiration time.

删除机器人后，您必须等待1小时才能添加新的机器人。控制台会显示冷却期结束时间。

Bot is not responding in Telegram

机器人在Telegram中无响应

Check the bot status on the Dashboard — it should be "running".
If the status is "pending", complete the verification step.
Try sending
```
/start
```
to the bot.
If the issue persists, try deleting and re-adding the bot (after the 1-hour cooldown).

检查控制台中的机器人状态——应为**“running”**。
如果状态为**“pending”**，请完成验证步骤。
尝试向机器人发送
```
/start
```
。
如果问题仍存在，尝试删除并重新添加机器人（需等待1小时冷却期）。

Quick Reference

快速参考

Action	Where
Create a new Telegram bot	Telegram → @BotFather → `/newbot`
Add bot token	Starchild Dashboard → bottom-left avatar → Account Management → Telegram Bot
Verify ownership	Telegram → Your bot → enter verification code
Refresh verification code	Starchild Dashboard → Account Management → Telegram Bot → "Refresh Code"
Delete bot	Starchild Dashboard → Account Management → Telegram Bot → "Delete Bot"
Check bot status	Starchild Dashboard → Account Management → Telegram Bot

操作	位置
创建新的Telegram机器人	Telegram → @BotFather → `/newbot`
添加Bot令牌	Starchild控制台 → 左下角头像 → 账户管理 → Telegram Bot
验证所有权	Telegram → 您的机器人 → 输入验证码
刷新验证码	Starchild控制台 → 账户管理 → Telegram Bot → “Refresh Code”
删除机器人	Starchild控制台 → 账户管理 → Telegram Bot → “Delete Bot”
查看机器人状态	Starchild控制台 → 账户管理 → Telegram Bot

Important Notes

重要提示

Security: Your Bot Token is encrypted (AES-256) before storage. It is never exposed in API responses.
One bot per account: You can only have one active Telegram bot at a time.
Cooldown: After deleting a bot, wait 1 hour before adding a new one.
Rate limits: Adding a bot and refreshing codes are limited to 3 requests per minute.
Verification attempts: You have 5 attempts to enter the correct code before it's invalidated.

安全性：您的Bot令牌在存储前会被加密（AES-256），绝不会在API响应中暴露。
单账户单机器人：您同一时间只能拥有一个活跃的Telegram机器人。
冷却期：删除机器人后，需等待1小时才能添加新的机器人。
请求限制：添加机器人和刷新验证码的请求限制为每分钟3次。
验证尝试次数：您有5次输入正确验证码的机会，之后验证码会失效。