> ## Documentation Index
> Fetch the complete documentation index at: https://docs-d0.donutbrowser.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 故障排查

> D0 bot 的大多数问题重启一下就能解决。这一页列出常见问题和处理方法。

## Bot 在 Telegram 上不回复

**现象：** 你在 Telegram 给 bot 发消息，但它不回。

**常见原因与解决办法：**

### 1. 先看 bot 是否在线

进入 **D0 看板** 查看 bot 状态：

* **Online（绿色）** —— bot 应该是正常的，试试重启（见下）。
* **Hibernated（黄色）** —— bot 在休眠。点 **Wake Up**，或者直接在 Telegram 发条消息 —— bot 会在 1–2 分钟内自动恢复。
* **Error（红色）** —— 出了问题，点 **Restart** 修复。

### 2. 重启 bot

如果 bot 显示 Online 但就是不回复：

1. 进入 D0 看板
2. 点 **Restart** 按钮
3. 等大约 30 秒
4. 再去 Telegram 发条消息试试

重启是解决大多数问题最快的办法，**不会删除你的任何数据或设置**。

### 3. 检查 Telegram 授权

确认绑定到 bot 的 Telegram 账号就是你正在用的那个：

* bot 只回应绑定账号发来的消息
* 如果你在初次设置时连错了 Telegram 账号，需要到看板设置里重新绑定

## 开通卡住

**现象：** 初次设置时，开通进度卡在某一步。

**解决办法：**

1. **再等一会** —— 开通最长可能需要 3 分钟
2. **刷新页面** —— 进度不会丢，页面会显示当前状态
3. **卡了超过 3 分钟** —— 点 **Retry** 按钮

## Bot 显示 Error 状态

**现象：** 看板显示 bot 处于 Error 状态。

**解决办法：**

1. 在看板上点 **Restart** 按钮
2. 等大约 30 秒完成重启
3. 如果重试 2–3 次后仍然报错，等几分钟再试

<Tip>
  大多数错误是临时的，重启就能自愈。如果问题反复出现，看看看板上显示的具体错误信息。
</Tip>

## 登录不上

**现象：** 无法登录 D0 看板。

**解决办法：**

1. 确认用的是注册时那个 Google 账号
2. 清一下浏览器 cookie 和缓存
3. 换个浏览器或用无痕模式
4. 检查是否有浏览器插件拦截了登录弹窗

## Telegram 连接问题

**现象：** 初次设置时连接 Telegram 报错。

**解决办法：**

| 问题                   | 怎么办                                                                     |
| -------------------- | ----------------------------------------------------------------------- |
| 「Connection failed」  | 点 **Retry Connection** 生成新的授权链接                                         |
| 「Connection expired」 | Telegram 授权链接过期了，点 **Retry Connection** 拿一个新的                           |
| 已连接但检测不到             | 确认你在 Telegram 那个页面点了 **Authorize**。如果没授权就关掉了页面，重新点 **Connect Telegram** |

<Tip>
  **自定义 Bot Token**
  如果你用的是 Dedicated 套餐并使用自定义 Telegram bot token：一旦 token 在 BotFather 里被吊销，你的 bot 就会停止工作。请新建一个 bot token，并在 看板 → Settings → Bot 里更新。
</Tip>

## 回复很慢

**现象：** bot 要很久才回复。

以下情况会导致变慢：

* bot 之前处于休眠、正在自动恢复（第一条消息要 1–2 分钟）
* bot 正在分析复杂数据（比如一张细节丰富的图表）
* 正在同时查询多个数据源（比如一份完整的代币分析）
* AI 正在处理一个复杂问题

大多数回复应该在 5–15 秒内到达，图表分析可能需要最多 30 秒。

## 求助

如果以上办法都不管用：

1. 记下看板上的 **错误信息**（如果有）
2. 记下你的 **bot 用户名**（例如 @my\_trading\_bot）
3. 通过 D0 看板或 Donut 社区渠道联系支持

我们通常在几小时内回复。