# Guild有币却没Discord角色：核组合条件、Claim与Bot层级

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/guild-requirement-logic-discord-claim-role-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

用原Guild角色配置区分满足要求与奖励交付，避免靠重签钱包或改旧规则排错。

## 使用工具
- [Guild.xyz](https://lianxiaozhi.com/tools/guild-xyz) · [官方入口](https://guild.xyz/)

## 前置条件
- 准备已有脱敏社区/账户定位、规则配置、验证/Claim结果及同一时点角色记录；不包含密钥、OAuth token或签名。

## 1. 先定位Guild角色和Discord奖励

Requirements是资格，Roles是Guild分组，Rewards是交付。保留原社区、Guild role、Discord server及目标role，不把同名Discord角色当同一个Guild角色。

从已有Editor→角色→Requirements/Rewards资料核对配置，缺原资料保留未知。

核对结果：原Guild角色和Discord目标角色各自定位。
依据：[Guild：Requirements、Roles、Rewards层次](https://docs.guild.xyz/guild/how-guild-works.md)
依据：[Guild：Discord bot权限和角色层级](https://docs.guild.xyz/guild/how-to-add-discord.md)

## 2. 把Token Balance输入和比较符保留下来

Token Balance核原Chain、Token address、Balance条件；Greater than与Greater than or equal to对恰好阈值结论不同，Range也需原边界。币名或资产USD总值不代替链和合约。

原截图缺比较符/时点/地址就标未知，不假设另一条链持同名币也满足。官方界面按币数量条件，不自行补最小单位换算。

核对结果：链、合约、原币量条件及比较符明确。
依据：[Guild：Token Balance链、合约及比较符](https://docs.guild.xyz/guild/how-to-setup-requirements/token-balance.md)

## 3. 计算ALL、1或X-of-Y及排除条件

Should meet ALL是AND，Should meet 1是OR，Should meet X out of Y是指定数量；Should not satisfy排除满足该条要求的成员。先列每条原结果，再按原组合解释，不能只看一条持币成功。

未连接所需账户会显示Connect Discord/Twitter/wallet等，不代表原持币失败；缺身份材料保留未知。已有角色后来被增条件，官方提醒可能使原成员失去访问，应核原配置变化时点。

核对结果：原组合、排除和未连接身份三种情况分别判断。
依据：[Guild：ALL/1/X-of-Y及排除条件](https://docs.guild.xyz/guild/how-to-setup-requirements.md)
依据：[Guild：Requirements、Roles、Rewards层次](https://docs.guild.xyz/guild/how-guild-works.md)

## 4. 资格合格后再核Claim与奖励等待

当前Discord Role Reward页写符合资格后点击Claim才接收角色；奖励看见不等已Claim，总览“自动奖励”不代替具体方法。按原Claim记录区分未请求与待分配。

官方说可能因Discord rate limits约1–2分钟并显示估计timer，这是一般描述，不是每次固定时限或成功保证；缺分配结果保留未知，不重复请求。

核对结果：资格、原Claim和实际授角色为三个阶段。
依据：[Guild：Claim与Discord奖励分配等待](https://docs.guild.xyz/guild/how-to-setup-rewards/discord-role.md)

## 5. 从原Bot配置定位交付层问题

目标服务器必须有Guild bot和Manage Roles，bot role需高于其要授予的角色；官方How to add Discord另推荐Manage Server/Create Invite，不能把推荐等同本任务全部必须项。

核已有权限和层级材料，缺项保留未知。Most requirements持续同步，失去资格可移除角色；缺原验证和实际Discord结果不宣称恢复访问。

核对结果：Bot存在、Manage Roles、目标层级及最终授予各有材料或未知。
依据：[Guild：Discord bot权限和角色层级](https://docs.guild.xyz/guild/how-to-add-discord.md)
依据：[Guild：Claim与Discord奖励分配等待](https://docs.guild.xyz/guild/how-to-setup-rewards/discord-role.md)
依据：[Guild：ALL/1/X-of-Y及排除条件](https://docs.guild.xyz/guild/how-to-setup-requirements.md)

## 常见错误
- 一条Token Balance合格不能代替整个Guild组合，Guild角色不能代替Discord实授。
- 文档同步/等待估计不等本人当前资格或恢复成功。

## 完成检查
- 得到原资格、规则与角色交付结果的对照；官方方法已核，实际账户资格与角色授予未验证。

## 相关知识
- [钱包签消息与签交易有什么区别？不付 Gas 的签名也要读内容](https://lianxiaozhi.com/learn/wallet-message-vs-transaction)

## 官方依据
- [Guild：Requirements、Roles、Rewards层次](https://docs.guild.xyz/guild/how-guild-works.md)
- [Guild：Discord bot权限和角色层级](https://docs.guild.xyz/guild/how-to-add-discord.md)
- [Guild：Token Balance链、合约及比较符](https://docs.guild.xyz/guild/how-to-setup-requirements/token-balance.md)
- [Guild：ALL/1/X-of-Y及排除条件](https://docs.guild.xyz/guild/how-to-setup-requirements.md)
- [Guild：Claim与Discord奖励分配等待](https://docs.guild.xyz/guild/how-to-setup-rewards/discord-role.md)