> ## 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 添加到你的服务器

> 邀请 Vetox，正确放置其身份组，并在几分钟内完成首次设置。

<Steps>
  <Step title="邀请机器人">
    <Card title="将 Vetox 添加到 Discord" icon="discord" horizontal href="https://discord.com/oauth2/authorize?client_id=707333425685856316&permissions=8&integration_type=0&scope=bot">
      打开 Discord 的授权界面。
    </Card>

    你需要在要添加机器人的服务器中拥有 **管理服务器** 权限。从下拉列表中选择你的服务器并确认。

    邀请链接请求 **管理员** 权限。Vetox 覆盖审核、身份组、频道、Webhook 和表情，一项权限即可涵盖所有内容，无需逐项授予。如果你更倾向于更精细的权限，可在邀请后在 **服务器设置 → 身份组** 中编辑 Vetox 身份组——你删除权限的功能将停止工作。
  </Step>

  <Step title="将 Vetox 身份组上移">
    前往 **服务器设置 → 身份组**，将 **Vetox** 拖到列表靠近顶部的位置。

    Discord 不允许任何机器人对最高身份组 **高于** 机器人自身身份组的成员执行操作。如果 Vetox 位于你的管理员身份组之下，它无法封禁、禁言或为其分配身份组——而且这种失败看起来像 bug 而不是权限问题。这是最常见的设置错误。
  </Step>

  <Step title="打开仪表板">
    前往 [vetox.io/dashboard](https://vetox.io/dashboard) 并使用 Discord 登录。你的服务器会自动出现。选择你刚刚添加了 Vetox 的服务器。
  </Step>

  <Step title="启用你需要的功能">
    打开 **设置** 页面。每项功能都在那里列出并有独立的开关，**大多数默认关闭**。只有在这里启用后才会生效。

    参见 [服务器设置](/zh-CN/server-management/setup)。
  </Step>

  <Step title="配置你启用的功能">
    每个已启用的功能都会在侧边栏中获得独立页面。逐一处理你启用的功能——每个选项都在本站有文档说明。
  </Step>
</Steps>

<Warning>
  将 Vetox 身份组放得太低是"机器人不工作"最常见的原因。Discord 会默默拒绝针对高于机器人排名的成员的操作。
</Warning>

## 首先应设置什么

你不需要配置所有内容。对于新服务器，合理的顺序是：

<CardGroup cols={2}>
  <Card title="1. 日志" icon="scroll" href="/zh-CN/moderation/logs">
    免费，并在你需要查找之前就记录下所发生的事情。
  </Card>

  <Card title="2. Auto-Mod" icon="filter" href="/zh-CN/moderation/auto-mod">
    免费。启用与你社区问题相符的规则。
  </Card>

  <Card title="3. Welcomer" icon="door-open" href="/zh-CN/utility/welcomer">
    欢迎新成员，让服务器从第一分钟就充满活力。
  </Card>

  <Card title="4. Leveling" icon="chart-line" href="/zh-CN/engagement/leveling">
    奖励活跃度，让成员有回来的理由。
  </Card>
</CardGroup>

## 验证是否正常工作

在任意频道运行 `/ping`。如果 Vetox 回复，则表示已连接并正在响应。

<AccordionGroup>
  <Accordion title="命令没有显示">
    Discord 可能需要几分钟才能将命令同步到新添加的机器人。完全退出并重新打开 Discord 通常可以强制刷新。

    另外确认 Vetox 在你测试的频道中拥有 **使用应用命令** 权限。
  </Accordion>

  <Accordion title="Vetox 离线">
    查看 [vetox.io/status](https://vetox.io/status)。如果那里显示一切正常，请移除并重新邀请机器人。
  </Accordion>

  <Accordion title="命令回复我缺少权限">
    Vetox 自行检查权限，而不是依赖 Discord 的命令可见性，因此每个命令对所有人可见，但只对被允许的人生效。

    服务器所有者和拥有管理员权限的成员始终通过检查。你也可以为每个命令授予特定身份组访问权限——参见 [命令管理](/zh-CN/server-management/command-management)。
  </Accordion>
</AccordionGroup>

<Note>
  所有 Vetox 命令都是 **仅服务器可用**。它们均不在私信中工作。
</Note>

## 下一步

<CardGroup cols={2}>
  <Card title="仪表板概述" icon="gauge" href="/zh-CN/dashboard">
    仪表板如何组织，以及各部分的位置。
  </Card>

  <Card title="权限" icon="user-lock" href="/zh-CN/permissions">
    谁可以运行命令，谁可以更改设置。
  </Card>
</CardGroup>
