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

# 自定义机器人

> 以您自己的机器人名字、头像和个人资料运行 Vetox。Max 和 Black 的附加项。

Vetox 的每项功能都在 **您的** 机器人账户下运行 —— 您的名字、您的头像、您的状态。

<Info>
  在 **Max** 和 **Black** 上作为附加项提供：**Max+** 和 **Black+**。价格请参见 [服务器高级会员](/zh-CN/premium/overview)。
</Info>

<Warning>
  **自定义机器人不授予 AI 访问权。** 它是与您等级分离的独立标志，AI 仅按等级限制。**Max+ 没有 AI。** 只有 Black 和 Black+ 有。
</Warning>

## 会发生什么变化

|                  | 效果                                     |
| ---------------- | -------------------------------------- |
| **名字、头像、横幅**     | 您机器人自有的                                |
| **描述**           | 最长 400 字符                              |
| **状态**           | Playing、Watching、Listening 或 Competing |
| **斜杠命令**         | 注册到您自己的应用程序上                           |
| **公共 Vetox 机器人** | **在该服务器中沉默** —— 它停止响应，因此两者永不同时回复       |

<Note>
  Discord 不允许机器人使用普通的自定义状态。您的状态必须是四种活动类型之一。
</Note>

<Note>
  身份更新是叠加式的。清空某个字段会保留之前的值而非移除 —— 请直接设置替换值。
</Note>

## 每个机器人一个服务器

<Warning>
  一个自定义机器人服务于 **一个服务器**。启动时它会离开被添加到的其他任何服务器。

  请不要在多个社区中使用同一个机器人应用。
</Warning>

## 设置

<Steps>
  <Step title="创建 Discord 应用程序">
    在 Discord 开发者门户中创建一个应用程序并为其添加机器人。
  </Step>

  <Step title="启用特权 intent">
    **Server Members**、**Presence** 和 **Message Content** 全部必需。缺少它们机器人无法启动。
  </Step>

  <Step title="复制令牌并提交">
    粘贴到仪表盘中。Vetox 会先向 Discord 验证再接受。

    <Warning>
      **令牌只能写入。** 提交后您无法再从 Vetox 读取。请先自行保存一份副本 —— 如果丢失，您必须在开发者门户中重新生成并提交新的。
    </Warning>
  </Step>

  <Step title="邀请您的机器人到您的服务器">
    使用您自己应用程序的邀请链接，附上 Vetox 需要的权限。
  </Step>

  <Step title="等待它上线">
    它会在片刻内启动。之后公共 Vetox 机器人会在该服务器中停止响应。
  </Step>
</Steps>

<Note>
  您的令牌静态加密。Vetox 会验证格式、确认它属于机器人账户、检查应用程序，并核实三个必需 intent 后再接受。
</Note>

## 转移到另一个服务器

移动自定义机器人是两步确认，请求在 **30 分钟** 后过期。

<Warning>
  转移一旦确认为最终结果。机器人会离开旧服务器，公共 Vetox 机器人在旧服务器中恢复。
</Warning>

## 停用

停用会停止机器人并 **清除已存储的令牌**。您的品牌设置和审计日志会保留。

要重新启用，请再次提交令牌。

## 如果崩溃

一分钟内崩溃三次的机器人会被自动停止以保护平台。请修复原因 —— 通常是被撤销的令牌或缺失的 intent —— 然后重新启用。

## 疑难解答

<AccordionGroup>
  <Accordion title="机器人无法上线">
    三个特权 intent 都必须在开发者门户中启用：Server Members、Presence 和 Message Content。这是最常见的原因。
  </Accordion>

  <Accordion title="两个机器人都在回复所有消息">
    公共机器人仅在自定义机器人服务的服务器中沉默。如果您看到两个都在回复，可能自定义机器人未启动 —— 请检查仪表盘中的状态。
  </Accordion>

  <Accordion title="我丢了令牌">
    Vetox 无法向您显示。请在开发者门户中重新生成并提交新的。
  </Accordion>

  <Accordion title="我的机器人自己离开了一个服务器">
    这是预期行为 —— 自定义机器人服务于一个服务器，启动时会离开其他服务器。
  </Accordion>

  <Accordion title="我是 Max+ 会员但 AI 被锁定">
    没错。自定义机器人不是等级变更；AI 需要 Black。
  </Accordion>

  <Accordion title="我更改了头像但仍显示旧的">
    Discord 会激进地缓存机器人头像。请给它一些时间再重新提交。
  </Accordion>
</AccordionGroup>

<Card title="管理机器人" icon="gauge" horizontal href="/zh-CN/account/manage-bots">
  配置此项的仪表盘页面。
</Card>