clawvif 0.2.0

package/skills/clawvif/sentiment-radar/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: sentiment-radar
+description: |
+  多源社交情绪雷达 — 聚合 X/Twitter、Telegram 群组、Discord 的加密市场情绪。
+  与 tg-group-scanner 区别：sentiment-radar 做宽泛情绪聚合，tg-group-scanner 做定向深度扫描。
+user-invocable: true
+metadata:
+  openclaw:
+    permissions:
+      - network:read
+      - filesystem:write
+    requires:
+      env:
+        - X_API_BEARER_TOKEN
+        - TG_BOT_TOKEN
+        - TG_API_ID
+        - TG_API_HASH
+---
+
+# Sentiment Radar Skill — 多源社交情绪雷达
+
+## 何时使用
+
+- 当用户想了解某代币/项目的社交情绪时，使用 `sentiment_query`
+- 当用户要求「全量扫描」「刷新情绪」时，使用 `sentiment_scan` 触发完整扫描
+
+## 可用工具
+
+### sentiment_query
+查询指定代币的情绪分数。参数：token（代币符号或 CA）、chain（可选）。返回情绪指标及近期变化。
+
+### sentiment_scan
+触发全量扫描。无参数或可选 token 过滤。对配置的数据源执行完整抓取与聚合，更新缓存。
+
+## 输出格式（与 TDD 对齐）
+
+```json
+{
+  "token": "PEPE",
+  "chain": "ethereum",
+  "sentimentScore": 0.62,
+  "sentimentDelta1h": 0.15,
+  "mentionCount1h": 342,
+  "mentionSpike": true,
+  "topKolSignals": [
+    { "kol": "@crypto_whale", "signal": "bullish", "reach": 120000 }
+  ],
+  "telegramAlphaHits": 3,
+  "extractedCa": "0x...",
+  "timestamp": "2026-03-10T08:30:00Z"
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| token | 代币符号或标识 |
+| chain | 链标识 |
+| sentimentScore | 情绪分数，-1.0（极熊）到 1.0（极牛） |
+| sentimentDelta1h | 过去 1 小时情绪变化 |
+| mentionCount1h | 过去 1 小时提及次数 |
+| mentionSpike | 是否出现提及量突增 |
+| topKolSignals | 高影响力 KOL 的信号数组 |
+| telegramAlphaHits | Telegram alpha 群中命中次数 |
+| extractedCa | 从消息中提取的合约地址（如有） |
+| timestamp | ISO8601 时间戳 |

package/skills/clawvif/sentiment-radar/references/scoring.md

@@ -0,0 +1,38 @@
+# 情绪评分算法说明
+
+## 评分范围
+- `-1.0` 极度看空 (extreme bearish)
+- `0.0` 中性 (neutral)
+- `+1.0` 极度看多 (extreme bullish)
+
+## 计算公式
+
+```
+final_score = Σ(message_sentiment × weight) / Σ(weight)
+```
+
+### 权重因子
+
+| 因子 | 说明 | 权重范围 |
+|------|------|----------|
+| KOL 历史准确率 | 该 KOL 过去 call 的胜率 | 0.1 - 2.0 |
+| 账户年龄 | 老号 > 新号 | 0.5 - 1.5 |
+| Followers 数量 | 影响力权重 | 0.1 - 1.0 |
+| 消息来源 | Alpha 群 > 公开群 > Twitter | 1.0 - 3.0 |
+
+### 异常检测
+
+当 1 小时内提及量超过过去 24 小时平均的 3 倍以上时，`mention_spike = true`。
+
+### 时间衰减
+
+消息权重随时间指数衰减：`weight *= exp(-λ × age_hours)`，其中 λ = 0.5（半衰期约 1.4 小时）。
+
+## LLM 情绪分类
+
+使用 LLM 对采样消息进行分类，输出：
+- `bullish` → +1
+- `neutral` → 0
+- `bearish` → -1
+
+每次扫描采样 最多 50 条最新消息进行分类。

package/skills/clawvif/tg-group-scanner/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: tg-group-scanner
+description: |
+  Telegram 群组深度扫描 — 扫描 alpha call 群、项目群、开发者群等。
+  与 sentiment-radar 区别：sentiment-radar 做宽泛情绪聚合，tg-group-scanner 做定向深度扫描。
+user-invocable: true
+metadata:
+  openclaw:
+    permissions:
+      - network:read
+      - filesystem:write
+    requires:
+      env:
+        - TG_API_ID
+        - TG_API_HASH
+        - TG_SESSION_STRING
+---
+
+# TG Group Scanner Skill — Telegram 群组深度扫描
+
+## 与 Sentiment Radar 的区别
+
+- **sentiment-radar**：宽泛情绪聚合，多平台（X、TG、Discord）情绪分数
+- **tg-group-scanner**：定向深度扫描，针对特定 Telegram 群组的 alpha 信号挖掘
+
+## 核心能力
+
+### 1. 自动提取合约地址（CA）
+从消息文本中提取合约地址（EVM 0x... / Solana 格式），并立即查询链上信息（持有量、流动性、创建时间等）。
+
+### 2. 首次提及（First Call）检测
+当某 CA 首次出现在 alpha 群中时触发告警。标记「首次提及」可提高信号优先级。
+
+### 3. 调用表现追踪
+记录 CA 被喊单后的价格变化，计算 call 的盈亏表现，用于评估群组/喊单者质量。
+
+### 4. 机器人信号识别
+识别 Maestro、BananaGun 等 bot 的广播格式，区分人工喊单与机器人跟单信号。
+
+## 何时使用
+
+- 当用户要求监控某 Telegram 群组时，配置该群为扫描目标
+- 当需要分析某 CA 在 alpha 群中的首次出现时间时，查询 first-call 记录
+- 当需要评估某群或某喊单者的历史表现时，查询 call 表现统计
+
+## 可用工具
+
+### tg_scanner_subscribe
+订阅 Telegram 群组进行深度扫描。参数：groupId、群类型（alpha / dev / project）。
+
+### tg_scanner_extract_ca
+从指定消息或消息 ID 中提取 CA，并触发链上信息查询。
+
+### tg_scanner_first_call_check
+检查某 CA 是否在某 alpha 群中为首次提及，若是则生成告警。
+
+### tg_scanner_call_performance
+查询某 CA 或某群/喊单者的历史 call 表现（价格变化、盈亏统计）。
+
+### tg_scanner_detect_bot_signal
+识别消息是否为 Maestro/BananaGun 等 bot 广播格式。
+
+## 数据持久化
+
+扫描结果、CA 提取记录、first-call 时间戳、call 表现数据持久化至本地，供 whale-tracker 和 onchain-monitor 交叉引用。

package/skills/clawvif/whale-tracker/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: whale-tracker
+description: |
+  巨鲸追踪 — 基于 onchain-monitor 输出的行为模式分析。
+  聚合地址历史构建行为画像，识别吸筹/派发模式，多地址交叉关联提升信号置信度。
+user-invocable: true
+metadata:
+  openclaw:
+    permissions:
+      - filesystem:read
+      - filesystem:write
+---
+
+# Whale Tracker Skill — 巨鲸追踪
+
+## 架构依赖
+
+本 Skill 建立在 **onchain-monitor** 的输出之上。onchain-monitor 提供原始链上事件，whale-tracker 进行高阶行为分析。
+
+## 何时使用
+
+- 当用户想了解某地址最近的巨鲸动向时，使用 `whale_query`
+- 当用户想深入了解某地址的行为偏好和模式时，使用 `whale_profile`
+
+## 可用工具
+
+### whale_query
+查询近期巨鲸动向。参数：chain（可选）、limit。返回符合巨鲸阈值的交易列表，含 from/to、金额、时间等。
+
+### whale_profile
+获取某地址的行为画像。参数：address。返回该地址的聚合行为特征。
+
+## 核心能力
+
+### 1. 行为画像聚合
+基于地址历史交易聚合：
+- **偏好链**：最常活动的链
+- **偏好 DEX**：最常使用的 DEX（Uniswap、Raydium 等）
+- **平均持有时长**：从买入到卖出的典型时间
+- **胜率**：盈利交易占比
+
+### 2. 吸筹模式检测
+识别「多次小额买入同一代币」的模式。多笔 buy 汇聚到同一 token，可能预示建仓。
+
+### 3. 派发模式检测
+识别「大额转至 CEX」或「分散转至多地址」的模式。可能预示出货或分仓。
+
+### 4. 交叉关联
+当多个互不关联的聪明钱地址在短时间内买入同一代币时，生成高置信度共振信号。可结合 sentiment-radar 和 tg-group-scanner 的多源验证。
+
+## 输出示例
+
+### whale_profile 输出结构
+
+```json
+{
+  "address": "0x...",
+  "preferredChains": ["ethereum", "base"],
+  "preferredDexes": ["Uniswap V3", "BaseSwap"],
+  "avgHoldingPeriodHours": 48,
+  "winRate": 0.72,
+  "accumulationPatterns": [
+    { "token": "0x...", "buyCount": 5, "totalUsd": 15000 }
+  ],
+  "distributionPatterns": [
+    { "type": "cex_withdrawal", "count": 2, "totalUsd": 80000 }
+  ]
+}
+```
+
+## 用户查询示例
+
+- "最近巨鲸有什么大动作" → `whale_query`
+- "0x123... 这个地址什么风格" → `whale_profile` address=0x123...
+- "有没有多个聪明钱同时买同一代币" → 交叉关联分析 + `whale_query` 过滤

package/workspace/SOUL.md

@@ -0,0 +1,22 @@
+# SOUL.md — Clawvif
+
+## Identity
+你是 Clawvif，一个专注于 Web3 市场情报与链上分析的 AI Agent。
+你的名字来源于法语 "Vif"（敏锐、迅捷）。
+你为你的主人（Owner）服务，帮助他在加密市场中获取信息优势。
+
+## Personality
+- 简洁、高效、数据驱动。不说废话。
+- 使用中文与主人沟通（除非主人切换语言）。
+- 汇报行情时使用结构化格式：代币/价格/变化/来源。
+- 有自己的判断力：当数据矛盾时，会明确表达不确定性。
+
+## Core Directives
+1. **安全第一**: 永远不在消息中明文输出私钥、助记词或敏感凭证。
+2. **信息溯源**: 所有分析结论必须标注数据来源和时间戳。
+3. **错误处理**: 遇到 API 调用失败，记录完整错误信息并通知 Owner。
+
+## What I Will NOT Do
+- 绝不自行生成或导出私钥
+- 绝不在公开群组中讨论 Owner 的持仓细节
+- 绝不捏造数据来源或伪造分析结论

package/workspace/USER.md

@@ -0,0 +1,18 @@
+# USER.md — Owner Preferences
+
+## Language
+中文（默认）。如果我切换到英文，请跟随。
+
+## Preferred Chains
+Solana, Ethereum, Base
+
+## Notification Preferences
+- CRITICAL 告警：立即通知，连续提醒
+- HIGH 告警：立即通知
+- MEDIUM 告警：每 5 分钟批量聚合后通知
+- LOW 告警：静默记录，我主动查询时再看
+
+## Display Preferences
+- 金额显示使用 USD 等值
+- 地址显示缩写形式（前 6 + 后 4）
+- 时间使用 UTC

package/workspace/config/alert-rules.json

@@ -0,0 +1,37 @@
+{
+  "rules": [
+    {
+      "name": "high-alpha-signal",
+      "eventType": "alpha_signal",
+      "minLevel": "high",
+      "delivery": "immediate",
+      "cooldownSeconds": 60,
+      "enabled": true
+    },
+    {
+      "name": "medium-price-alert",
+      "eventType": "price_alert",
+      "minLevel": "medium",
+      "delivery": "batch",
+      "cooldownSeconds": 300,
+      "enabled": true
+    },
+    {
+      "name": "whale-movement",
+      "eventType": "whale_alert",
+      "minLevel": "medium",
+      "delivery": "immediate",
+      "cooldownSeconds": 120,
+      "enabled": true
+    },
+    {
+      "name": "low-info-update",
+      "eventType": "info",
+      "minLevel": "low",
+      "delivery": "batch",
+      "cooldownSeconds": 600,
+      "enabled": true
+    }
+  ],
+  "defaultCooldownSeconds": 300
+}

package/workspace/config/kol-list.json

@@ -0,0 +1,3 @@
+{
+  "kols": []
+}

package/workspace/config/tg-groups.json

@@ -0,0 +1,3 @@
+{
+  "groups": []
+}

package/workspace/config/watchlist.json

@@ -0,0 +1,3 @@
+{
+  "addresses": []
+}