openclaw-basecred-sdk

openclaw-basecred-sdk 是一款专为 Web3 生态设计的链上声誉查询工具，通过集成 Ethos Network、Talent Protocol 和 Farcaster 三大身份平台，为用户提供全面、中立的声誉数据评估服务。该技能基于 @basecred/sdk 构建，采用 CLI 接口设计，能够获取可组合的原始声誉数据，包括社交可信度评分、构建者/创作者分数以及账户质量指标，适用于身份验证、信任评估和自动化声誉管理场景。

核心用法方面，用户可通过简单的命令行指令查询任意以太坊地址的声誉数据。基础命令 ./scripts/check-reputation.mjs <address> 即可返回 JSON 格式的摘要信息，包含各数据源可用性状态、原始分数和语义等级。工具支持多种输出格式（JSON、人类可读文本、完整配置文件），并提供 --full 和 --human 等选项满足不同场景需求。对于开发者，还可直接导入 ES 模块在自定义脚本中调用 checkReputation 等函数，实现深度集成。

显著优点体现在其架构设计的多个维度。首先是多源数据聚合能力，无需 API 密钥即可访问 Ethos Network 数据，同时支持通过可选密钥启用 Talent Protocol 和 Farcaster 查询，实现 graceful degradation（优雅降级）。其次是中性设计理念，工具仅返回原始分数和等级（如 Builder Score、Credibility Level），不做信任裁决或排名比较，将判断权完全交给用户。第三是完善的安全设计，采用硬编码路径加载凭证（~/.openclaw/.env），无目录遍历风险，且仅执行只读 API 访问。此外，完善的输入验证（以太坊地址正则校验）和错误处理机制确保工具在面对无效输入或网络异常时稳定运行。

潜在缺点与局限性主要包括对第三方 API 的依赖。由于数据源自外部平台，查询存在 1-3 秒的延迟，且受限于上游 API 的可用性和速率限制。此外，部分功能需要用户自行申请并配置 API 密钥（Talent Protocol 和 Neynar），增加了使用门槛。数据来源方面，尽管代码通过安全审计，但作者 teeclaw 为个人开发者（T3 来源），非官方组织维护，长期维护稳定性需持续关注。历史安全问题（v1.0.4 版本的密钥泄露事件）虽已修复，但提示用户需重视密钥管理。

适合的目标群体包括：Web3 项目方和 DAO 组织者，需要验证成员身份可信度；招聘团队，评估候选人的链上构建者声誉；DeFi 协议开发者，集成声誉数据进行风险评分；以及研究人员，分析 Web3 社交图谱和身份验证模式。任何需要自动化查询以太坊地址声誉数据，且希望保持数据中立性的场景均适用。

使用该技能可能存在的常规风险涉及网络依赖和 API 管理。工具需要访问外部网络服务，存在因网络中断或 API 服务宕机导致查询失败的风险。用户需妥善管理存储在本地环境文件中的 API 密钥，避免权限泄露（建议设置 600 文件权限并定期轮换）。此外，虽然工具本身不收集敏感数据，但查询行为会向第三方 API 暴露用户 IP 和查询的地址信息，在高度敏感场景下需考虑隐私保护。性能方面，并发查询多个数据源可能受限于最慢 API 的响应时间。