Guild 的权限设置逻辑可以用一句话概括:你设定条件,Guild 自动发角色,条件失效时自动收回。它不需要你手动审批每个人,也不需要你写脚本去同步 Discord 身份组。核心机制建立在三个东西上:要求(Requirements)、角色(Roles)、奖励(Rewards)。你真正要花心思的地方,是搞清楚"条件失效"在什么情况下会触发回收,以及哪些操作会让现有成员瞬间失去权限。
条件:AND、OR 和排除规则
在 Guild 的 Editor 里创建角色后,点击"Add requirements"就能添加条件。条件类型覆盖链上活动(持有特定代币或 NFT、在某个合约交互过)、社交证明(关注 X、持有 Discord 角色、验证邮箱)、Guild 内部活动(积分达到某个数值、拥有另一个 Guild 角色),以及时间条件(在某个日期前拥有 Discord 角色、最近 7 天在 Base 上有交易)。
条件之间的逻辑关系有三种:满足全部(AND)、满足任意一个(OR)、满足其中 X 个。默认通常是 AND,如果你希望"持有代币或者关注 X 都能获得角色",就切换到"Should meet 1"。
还有一个容易被忽略的开关:"Should not satisfy"。它的作用是排除满足某个条件的人。举例来说,你想给活跃用户发角色,但不想让机器人或小号混进来,可以加一条"Should not satisfy: 持有某个已知机器人地址的 NFT"。这个排除规则和普通条件是叠加生效的,不是二选一。
条件设置完成后,成员在 Guild 页面点击 Verify,Guild 会检查他们是否满足。大多数条件会持续同步,不是一次性检查。这意味着如果你的条件涉及"最近 30 天有交互",而成员在第 31 天没有新的交互,角色会被自动收回。
同步:自动发,自动收,但有延迟
Guild 的设计目标就是"不用手动管理"。成员满足条件后,对应的 Guild 角色自动生效,关联的奖励(比如 Discord 身份组、积分)随之发放。成员不再满足条件时,角色和奖励自动撤销。
Discord 身份组的同步不是即时的。官方文档说明,角色分配是自动的,但由于 Discord 的速率限制,可能需要 1–2 分钟,繁忙时段成员会看到一个预估计时器。如果你的社区在活动期间大量成员同时验证,延迟会更明显。这不是 Guild 的问题,是 Discord API 的约束。
Discord 身份组同步有一个必须满足的前置条件:Guild 机器人必须在你的 Discord 服务器里,并且拥有"管理角色"权限。此外,机器人自身的角色位置必须高于它需要分配的那些角色。如果你把 Guild 机器人的角色拖到了成员角色下面,它就没有权限给任何人发角色,同步会静默失败。这是设置时最常见的配置错误。
回收:条件失效和手动移除是两条路
自动回收发生在条件不再满足时。比如你设的条件是"持有 500 个代币",成员卖到 499 个,角色和 Discord 身份组会被撤销。Guild 文档没有给出同步频率的具体秒数,但"大多数要求持续同步"的表述意味着,回收不是等某个固定周期,而是在成员下次触发验证或后台检查时生效。如果你的社区对权限时效性要求很高(比如付费订阅制),需要把"Guild 的同步延迟"和"Discord 的分配延迟"叠加考虑。
手动移除走的是另一条路,而且效果更彻底。在 Guild 的 Members 页面,管理员可以把成员从 Guild 中移除。移除后,该成员的角色被撤销,并从成员列表中消失。注意这是 Guild 层面的移除,它切断了该成员与你的 Guild 的所有关联,不只是某一个角色。如果你只想撤销某个特定角色的奖励,应该通过修改或删除该角色的奖励来实现,而不是移除成员。
这里有一个操作上的提醒:不要给现有角色添加新条件。Guild 文档明确警告,如果你给一个成员已经持有的角色增加新要求,现有成员很可能不满足新要求,会全部失去该角色。正确的做法是创建一个新角色,设置好条件后让成员重新验证,或者在修改前通知成员。
给你的判断
如果你是第一次设置 Guild,从 2–5 个基础角色开始就够了。把"加入 Discord"和"关注 X"放在首页作为入门角色,然后在单独的页面里创建代币持有者或活跃贡献者的角色。先用"View page as a visitor"预览一遍验证流程,确认条件判断符合预期再正式发布。
如果你在做付费订阅或代币门控,特别注意 Discord 机器人的角色层级。先把 Guild 机器人拖到所有需要分配的成员角色上方,再开始配置奖励。否则你会看到"设置成功"但成员拿不到身份组,排查起来很浪费时间。
如果你担心误收回,在设置条件时把时间窗口设得宽一些,或者用"Should meet 1"让成员有多个满足条件的路径。条件越严格,误伤合法成员的概率越高,而 Guild 的自动回收不会给你"确认一下再撤"的机会。
参考资料
- Guild Docs·How Guild works,页面发布或更新日期:2025-09-22;核查日期:2026-10-21。
- Guild Docs·How to setup requirements,页面发布或更新日期:2025-06-15;核查日期:2026-10-21。
- Guild Docs·Add Guild roles,页面发布或更新日期:2025-08-12;核查日期:2026-10-21。
- Guild Docs·Discord role,页面发布或更新日期:页面未标明更新日期;核查日期:2026-10-21。
- Guild.Host·Elevate Your Community | Members,页面发布或更新日期:页面未标明更新日期;核查日期:2026-10-21。



