# 配置 所有配置都通过一个 `.env` 文件在仓库根目录中完成。复制 `.env.example` 即可开始： ```bash cp .env.example .env ``` *** ## 必需变量 这些必须设置，否则机器人将拒绝启动。 ### DISCORD\_TOKEN 来自开发者门户的你的 Discord 机器人令牌。 ```env DISCORD_TOKEN=your_bot_token_here ``` ### LOG\_CHANNEL\_ID 记录所有警告添加 / 编辑 / 删除操作的频道 ID。 ```env LOG_CHANNEL_ID=123456789012345678 ``` ### STAFF\_ROLE\_ID 使用 `/verbal` 命令所需的最低角色。拥有此角色或在服务器层级中更高角色的成员都可获得访问权限。 ```env STAFF_ROLE_ID=123456789012345678 ``` *** ## 可选变量 ### EMBED\_COLOR 所有机器人嵌入消息中使用的强调色。接受十六进制格式，可带或不带 `0x` 前缀。 ```env EMBED_COLOR=0x007FFF # 或 EMBED_COLOR=007FFF ``` 默认值为 `0x007FFF` （蓝色），如果未设置。 *** ## Auttaja / Supabase 只有当你想使用 `/auttaja` 命令时才需要这些变量。机器人无需它们也能启动，但整个 Auttaja cog 将不可用。 ### SUPABASE\_URL 你的 Supabase 项目 URL。 ```env SUPABASE_URL=https://xxxxxxxxxxxxxxxxxxxx.supabase.co ``` ### SUPABASE\_KEY 一个 Supabase **服务角色** 密钥（不是 anon 密钥）。服务角色密钥会绕过行级安全，并且读取和写入惩罚记录时需要它。 ```env SUPABASE_KEY=your_supabase_service_role_key_here ``` > 请妥善保管此密钥。它拥有对你的 Supabase 项目的完全访问权限。 *** ## 完整的 .env 示例 ```env # 必需 DISCORD_TOKEN=your_bot_token_here LOG_CHANNEL_ID=123456789012345678 STAFF_ROLE_ID=987654321098765432 # 可选 EMBED_COLOR=0x007FFF # 可选 — Auttaja 集成 SUPABASE_URL=https://xxxxxxxxxxxxxxxxxxxx.supabase.co SUPABASE_KEY=your_supabase_service_role_key_here ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.vigila.augystudios.com/zh/zi-tuo-guan/configuration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.