Clawvif

基于 OpenClaw 架构的 Web3 行情分析与市场情报 AI Agent

"Vif"（法语：敏锐、迅捷）— 敏锐的数据嗅觉 + 多源信号聚合

特性

• 📡 Telegram 监听 — Bot API 实时监听群组/频道消息，自动提取 alpha call 和合约地址
• 📊 情绪雷达 — 聚合 Twitter/Telegram/Discord 社媒情绪信号
• 🐋 鲸鱼追踪 — 大额异动检测、地址行为画像、积累/派发模式识别
• 🔗 链上监控 — 实时追踪大额转账、新流动性池、聪明钱活动（可选启用）
• 🔔 告警分发 — 多级别告警推送，去重、批量、历史查询
• 📋 审计日志 — 所有操作不可篡改记录

架构

┌──────────────────────────────────────────────────────────────┐
│                     OpenClaw Gateway                          │
│  Telegram / Discord / WebChat / CLI                          │
└──────────────────────────────┬───────────────────────────────┘
                               │
                               ▼
┌──────────────────────────────────────────────────────────────┐
│               Clawvif Agent Runtime (推理引擎)                 │
│            ReAct Reasoning Loop (OpenClaw)                    │
│      Reason → Act (call tool/skill) → Observe → Repeat      │
└──────────────────────────────┬───────────────────────────────┘
                               │
                               ▼
┌──────────────────────────────────────────────────────────────┐
│                  Clawvif Skills & Tools                        │
│  ┌──────────────┐ ┌──────────────┐ ┌───────────────────┐    │
│  │ Intel Skills  │ │ TG Skills    │ │ Infra Skills      │    │
│  │• sentiment-  │ │• tg-group-   │ │• audit-logger     │    │
│  │  radar       │ │  scanner     │ │• alert-dispatcher │    │
│  │• onchain-    │ │• tg-listener │ │                   │    │
│  │  monitor     │ │              │ │                   │    │
│  │• whale-      │ │              │ │                   │    │
│  │  tracker     │ │              │ │                   │    │
│  └──────────────┘ └──────────────┘ └───────────────────┘    │
└──────────────────────────────────────────────────────────────┘

快速开始

前置要求

• Node.js 22+
• pnpm
• OpenClaw (npm install -g openclaw@latest)

安装

# 1. 克隆仓库
git clone https://github.com/luka2chat/clawvif.git
cd clawvif

# 2. 安装依赖
pnpm install

# 3. 配置环境变量
cp .env.example .env
# 编辑 .env 填入 Bot Token

# 4. 启动
openclaw gateway start

Telegram Bot 配置

1. 在 Telegram 找 @BotFather，发送 /newbot，按提示创建 bot
2. 复制 bot token 到 .env 的 TG_BOT_TOKEN=
3. 把 bot 拉进你想监听的群组/频道，设为管理员

插件启动后会自动连接 Telegram 并开始监听消息。

命令

信息查询

| 命令 | 说明 | |------|------| | 情绪 BTC / sentiment BTC | 代币情绪分析 | | 聪明钱 / whales | 近期鲸鱼动态 | | 日报 / daily | 当日市场摘要 |

Telegram 监听

| 命令 | 说明 | |------|------| | TG 监听状态 | 查看监听服务状态 | | 启动 TG 监听 | 手动启动监听 | | 停止 TG 监听 | 停止监听 |

系统管理

| 命令 | 说明 | |------|------| | 监控 0x... 标签:XXX | 添加监控地址 | | 状态 / status | 系统健康检查 |

开发

pnpm install          # 安装依赖
pnpm build            # 构建插件
pnpm test             # 运行测试
pnpm typecheck        # 类型检查
pnpm lint             # 代码检查
pnpm dev              # 开发模式 (watch)

License

MIT