🔍 Crypto Scam Detector v2.0

面向 OpenClaw 的数据库优先型加密货币骗局检测工具

基于本地 SQLite 数据库，结合后台从 Etherscan 同步的数据，对加密货币地址进行钓鱼、蜜罐、抽毯子（rug pull）、庞氏骗局等风险分析。用户执行检测时零外部 API 调用 = 即时返回结果！

✨ v2.0 新增特性

🚀 主要架构升级

• ✅ 数据库优先设计 — 所有检测均查询本地 SQLite 数据库
• ✅ 即时响应 — 检测过程无 API 延迟（<5ms）
• ✅ 无速率限制 — 用户检测永不触达 Etherscan API
• ✅ 后台同步工作进程 — 独立进程从 Etherscan 拉取数据
• ✅ 交易消息分析 — 解码并分析十六进制交易数据（hex data）
• ✅ 自动入队机制 — 未知地址自动加入同步队列
• ✅ 深度扫描能力 — 在交易数据中识别可疑关键词

🔍 增强型检测能力

现已捕获旧版本遗漏的多种骗局：

• ✅ 引用 “Lazarus Vanguard” 黑客组织的相关内容
• ✅ 提及 “Orbit Bridge Hacker” 的交易信息
• ✅ 私钥钓鱼尝试
• ✅ 漏洞利用招募类消息
• ✅ 以及其他更多风险类型…

📦 包含内容

crypto-scam-detector/
├── SKILL.md                    # 当前文档
├── DATABASE_ARCHITECTURE.md    # 技术文档
├── database.py                 # SQLite 数据库层
├── crypto_check_db.py          # 纯数据库检测器（即时响应）
├── sync_worker.py              # 后台 Etherscan 同步工作进程
├── secure_key_manager.py       # 加密存储 API 密钥
├── install.sh                  # 自动安装脚本
├── setup.sh                    # API 密钥配置向导
├── check_address.sh            # 便捷脚本（如需则自动同步）
├── requirements.txt            # Python 依赖列表
└── venv/                       # 虚拟环境（安装时自动创建）

🚀 快速开始

1. 安装

cd ~/.openclaw/workspace/skills/crypto-scam-detector
bash install.sh

2. 配置 Etherscan API 密钥（可选，但强烈推荐）

选项 A：交互式配置（加密存储）

./setup.sh
# 按照向导提示加密您的 API 密钥

选项 B：环境变量方式

export ETHERSCAN_API_KEY="your_key_here"

免费获取 API 密钥：https://etherscan.io/myapikey

3. 检查地址

# 检查地址（即时响应，仅访问数据库）
python3 crypto_check_db.py 0x1234567890abcdef1234567890abcdef12345678

4. 运行后台同步工作进程

手动模式：

python3 sync_worker.py
# 持续运行，处理同步队列

批处理模式：

python3 sync_worker.py --max-jobs 20
# 处理 20 个地址后退出

Cron 定时任务（推荐）：

# 添加至 crontab
*/10 * * * * cd ~/.openclaw/workspace/skills/crypto-scam-detector && source venv/bin/activate && ETHERSCAN_API_KEY="key" python3 sync_worker.py --max-jobs 30

💡 工作原理

架构流程图

用户检查地址
       ↓
┌──────────────────┐
│ crypto_check_db  │ ← 仅查询本地数据库
└────────┬─────────┘   （不发起任何外部 API 调用）
         │
         ↓
┌──────────────────────┐
│ 本地 SQLite 数据库   │
│ ~/.config/crypto-    │
│  scam-detector/      │
│                      │
│ • 地址信息           │
│ • 交易记录           │
│ • 风险评分           │
│ • 骗局标识符         │
│ • 同步队列           │
└────────▲─────────────┘
         │
         │ 后台同步
         │
┌────────┴─────────────┐
│ sync_worker.py       │ ← 从 Etherscan 拉取数据
│                      │   （使用您的 API 密钥）
│ • 读取同步队列       │
│ • 调用 Etherscan API │
│ • 解码交易数据       │
│ • 分析交易消息       │
│ • 写入数据库         │
└──────────────────────┘

用户操作流程

1. 检查地址： python3 crypto_check_db.py 0x...
2. 若地址已在数据库中： 即时返回完整分析结果
3. 若地址不在数据库中：
   • 返回 “unknown” 状态
   • 自动加入同步队列
   • 显示提示： “⏳ 几分钟后再次检查”
4. 后台工作进程完成同步（下一次 cron 执行或手动触发）
5. 再次检查： 即可获得完整分析结果

🔍 检测能力

支持识别的骗局类型

风险评分机制

评分算法因子：

• 可疑交易数量（每笔 +25 分，上限 +50）
• 账户年龄（新地址 +10）
• 余额模式（高余额 + 可疑交易 = +20）
• 合约验证状态（未验证合约 +30）

风险等级划分：

• 0–19: ✅ 低风险
• 20–49: ℹ️ 中风险
• 50–79: ⚠️ 高风险
• 80–100: 🚨 极高风险

📋 命令参考

检查地址

# 人类可读格式输出
python3 crypto_check_db.py 0x...

# JSON 格式输出
python3 crypto_check_db.py 0x... --json

同步工作进程

# 将地址加入同步队列
python3 sync_worker.py --add-address 0x...

# 启动工作进程（持续运行）
python3 sync_worker.py

# 处理 N 个地址后停止
python3 sync_worker.py --max-jobs 20

# 自定义地址间延迟时间（秒）
python3 sync_worker.py --delay 2.0

# 显示数据库统计信息
python3 sync_worker.py --stats

便捷脚本

# 检查地址，如需则自动同步
./check_address.sh 0x...
# 若地址不在数据库中，则自动同步，然后显示结果

🎯 示例输出

极高风险地址

🚨 Analysis for 0x098b716b8aaf21512996dc57eb0615e2383e2f96

Risk Score: 100/100 - CRITICAL RISK
Last Updated: 2026-02-20 07:14:32

🚨 KNOWN SCAM DETECTED!

⚙️ Smart Contract
⚠️ NOT VERIFIED on Etherscan
   Transactions: 38
   Balance: 101.802430 ETH

🚨 5 Scam Indicator(s) Detected:
   • Suspicious keyword detected: 'lazarus' (confidence: 80%)
   • Suspicious keyword detected: 'hack' (confidence: 80%)
   • Suspicious keyword detected: 'exploit' (confidence: 80%)
   • Suspicious keyword detected: 'private key' (confidence: 80%)

⚠️ 5 Suspicious Transaction(s):
   • 0x74f7fbfe5a0bd3...
     Reason: Suspicious keyword detected: 'lazarus'
     Message: "Greetings Lazarus Vanguard..."

📋 Recommendations:
  🚫 DO NOT send funds to this address
  ⚠️ This address has been flagged as high risk
  📞 Report the source that gave you this address

未知地址（尚未同步）

⏳ Analysis for 0xnew_address_not_in_db

Risk Score: 0/100 - UNKNOWN
Last Updated: N/A

⏳ Address not yet in database
   Address not in database. Added to sync queue.

📋 Recommendations:
  ⏳ This address will be analyzed soon
  🔍 Check again in a few minutes
  ⚠️ Exercise caution until analysis completes

⚙️ 配置说明

数据库位置

默认路径：~/.config/crypto-scam-detector/crypto_data.db

Etherscan API 速率限制

• 免费版： 5 次调用/秒，100,000 次调用/天
• 每个地址消耗： 4 次 API 调用（余额、交易数、交易列表、合约代码）
• 默认延迟： 地址间间隔 1.5 秒（适用于免费版）

推荐的 Cron 计划

# 每 10 分钟处理 30 个地址
*/10 * * * * cd ~/.openclaw/workspace/skills/crypto-scam-detector && source venv/bin/activate && ETHERSCAN_API_KEY="key" python3 sync_worker.py --max-jobs 30 --delay 2.0

# 日均处理约 4,320 个地址

🛡️ 安全性保障

• ✅ API 密钥加密存储 — 使用 AES-256 + PBKDF2
• ✅ 不共享第三方 — API 密钥仅发送至 Etherscan
• ✅ 本地处理 — 所有分析均在您本地设备完成
• ✅ 无遥测收集 — 零数据采集
• ✅ 开源代码 — 全面可审计

📊 数据库结构

数据表

• addresses — 地址元信息、风险评分、余额、附加字段
• transactions — 可疑交易记录（含解码后的消息）
• scam_indicators — 每个地址对应的独立风险标识
• sync_queue — 等待同步的地址队列

完整技术细节请参阅 DATABASE_ARCHITECTURE.md。

🔄 同步频率

默认行为：

• 首次检查 → 地址加入同步队列
• 工作进程处理队列（手动或定时触发）
• 后续检查 → 直接从数据库即时返回

建议配置： 通过 cron 每 5–10 分钟运行一次工作进程

💻 OpenClaw 集成

通过聊天界面调用

"Check if 0x1234... is a scam"
"Is this address safe: 0xabc..."
"Verify 0xdef... before I send ETH"

自动检测流程

当您检查一个地址时，OpenClaw 会：

1. 运行 crypto_check_db.py
2. 若地址不在数据库中 → 自动加入同步队列
3. 返回当前状态
4. 建议同步完成后再次检查

🐛 故障排查

“Address not in database”

解决方案： 等待后台工作进程同步，或手动触发：

python3 sync_worker.py --add-address 0x...
python3 sync_worker.py --max-jobs 1

“Etherscan API key not configured”

解决方案： 通过环境变量或配置向导设置 API 密钥：

./setup.sh  # 或
export ETHERSCAN_API_KEY="your_key"

速率限制错误

解决方案： 增加地址间延迟时间：

python3 sync_worker.py --delay 3.0

📈 性能指标

• ✅ 单次检测延迟： <5ms（纯数据库查询）
• ✅ 单地址同步耗时： 约 2 秒（4 次 API 调用）
• ✅ 数据库体积： 约 1KB / 地址
• ✅ 扩展能力： 支持百万级地址规模

🆚 对比：v1 vs v2

📜 许可证

MIT License — 免费且开源

🤝 支持渠道

• GitHub： https://github.com/trustclaw/crypto-scam-detector
• Issues： 报告 Bug 或提交功能请求
• ClawHub： https://clawhub.com/crypto-scam-detector
• Hackathon： NeoClaw Hackathon 2026

🏆 致谢

由 Trust Claw 团队开发，专为 NeoClaw Hackathon 2026 打造

技术栈：

• SQLite — 本地数据库
• Etherscan API — 区块链链上数据
• ChainAbuse API — 社区上报的骗局数据
• Python asyncio — 异步操作支持

🔐 保护您的加密资产安全！转账前务必验证收款地址。