clawvif 0.2.0

package/README.md

@@ -0,0 +1,120 @@
+# 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`)
+
+### 安装
+
+```bash
+# 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` | 系统健康检查 |
+
+## 开发
+
+```bash
+pnpm install          # 安装依赖
+pnpm build            # 构建插件
+pnpm test             # 运行测试
+pnpm typecheck        # 类型检查
+pnpm lint             # 代码检查
+pnpm dev              # 开发模式 (watch)
+```
+
+## License
+
+MIT

package/dist/file-store-Cp6U-dO6.mjs

@@ -0,0 +1,98 @@
+import { dirname } from "node:path";
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/lib/file-store.ts
+/**
+* File storage utilities for Clawvif.
+*
+* Provides helpers for reading/writing JSON and JSONL files,
+* following OpenClaw's local-first, file-based memory philosophy.
+*/
+var file_store_exports = /* @__PURE__ */ __exportAll({
+	appendJsonl: () => appendJsonl,
+	ensureDir: () => ensureDir,
+	ensureParentDir: () => ensureParentDir,
+	readJson: () => readJson,
+	readJsonOr: () => readJsonOr,
+	readJsonl: () => readJsonl,
+	readJsonlTail: () => readJsonlTail,
+	writeJson: () => writeJson
+});
+/**
+* Ensure a directory exists, creating it recursively if needed.
+*/
+function ensureDir(dirPath) {
+	if (!existsSync(dirPath)) mkdirSync(dirPath, { recursive: true });
+}
+/**
+* Ensure the parent directory of a file path exists.
+*/
+function ensureParentDir(filePath) {
+	ensureDir(dirname(filePath));
+}
+/**
+* Read and parse a JSON file.
+*
+* @param filePath - Absolute path to JSON file
+* @returns Parsed JSON content
+* @throws If file doesn't exist or contains invalid JSON
+*/
+function readJson(filePath) {
+	const content = readFileSync(filePath, "utf-8");
+	return JSON.parse(content);
+}
+/**
+* Read a JSON file, returning a default value if the file doesn't exist.
+*/
+function readJsonOr(filePath, defaultValue) {
+	if (!existsSync(filePath)) return defaultValue;
+	return readJson(filePath);
+}
+/**
+* Write data as formatted JSON to a file.
+* Creates parent directories if they don't exist.
+*/
+function writeJson(filePath, data) {
+	ensureParentDir(filePath);
+	writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+/**
+* Append a single entry to a JSONL (JSON Lines) file.
+* Each entry is written as one JSON object per line.
+* Creates parent directories if they don't exist.
+*/
+function appendJsonl(filePath, entry) {
+	ensureParentDir(filePath);
+	appendFileSync(filePath, JSON.stringify(entry) + "\n", "utf-8");
+}
+/**
+* Read all entries from a JSONL file.
+*
+* @param filePath - Absolute path to JSONL file
+* @returns Array of parsed entries
+*/
+function readJsonl(filePath) {
+	if (!existsSync(filePath)) return [];
+	return readFileSync(filePath, "utf-8").split("\n").filter((line) => line.trim().length > 0).map((line) => JSON.parse(line));
+}
+/**
+* Read the last N entries from a JSONL file (most recent first).
+*/
+function readJsonlTail(filePath, count) {
+	return readJsonl(filePath).slice(-count).reverse();
+}
+//#endregion
+export { readJsonl as a, readJsonOr as i, ensureDir as n, readJsonlTail as o, file_store_exports as r, writeJson as s, appendJsonl as t };
+
+//# sourceMappingURL=file-store-Cp6U-dO6.mjs.map

package/dist/file-store-Cp6U-dO6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store-Cp6U-dO6.mjs","names":[],"sources":["../src/lib/file-store.ts"],"sourcesContent":["/**\n * File storage utilities for Clawvif.\n *\n * Provides helpers for reading/writing JSON and JSONL files,\n * following OpenClaw's local-first, file-based memory philosophy.\n */\n\nimport { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync } from 'node:fs';\nimport { dirname } from 'node:path';\n\n/**\n * Ensure a directory exists, creating it recursively if needed.\n */\nexport function ensureDir(dirPath: string): void {\n  if (!existsSync(dirPath)) {\n    mkdirSync(dirPath, { recursive: true });\n  }\n}\n\n/**\n * Ensure the parent directory of a file path exists.\n */\nexport function ensureParentDir(filePath: string): void {\n  ensureDir(dirname(filePath));\n}\n\n/**\n * Read and parse a JSON file.\n *\n * @param filePath - Absolute path to JSON file\n * @returns Parsed JSON content\n * @throws If file doesn't exist or contains invalid JSON\n */\nexport function readJson<T>(filePath: string): T {\n  const content = readFileSync(filePath, 'utf-8');\n  return JSON.parse(content) as T;\n}\n\n/**\n * Read a JSON file, returning a default value if the file doesn't exist.\n */\nexport function readJsonOr<T>(filePath: string, defaultValue: T): T {\n  if (!existsSync(filePath)) {\n    return defaultValue;\n  }\n  return readJson<T>(filePath);\n}\n\n/**\n * Write data as formatted JSON to a file.\n * Creates parent directories if they don't exist.\n */\nexport function writeJson(filePath: string, data: unknown): void {\n  ensureParentDir(filePath);\n  writeFileSync(filePath, JSON.stringify(data, null, 2) + '\\n', 'utf-8');\n}\n\n/**\n * Append a single entry to a JSONL (JSON Lines) file.\n * Each entry is written as one JSON object per line.\n * Creates parent directories if they don't exist.\n */\nexport function appendJsonl(filePath: string, entry: unknown): void {\n  ensureParentDir(filePath);\n  appendFileSync(filePath, JSON.stringify(entry) + '\\n', 'utf-8');\n}\n\n/**\n * Read all entries from a JSONL file.\n *\n * @param filePath - Absolute path to JSONL file\n * @returns Array of parsed entries\n */\nexport function readJsonl<T>(filePath: string): T[] {\n  if (!existsSync(filePath)) {\n    return [];\n  }\n  const content = readFileSync(filePath, 'utf-8');\n  return content\n    .split('\\n')\n    .filter((line) => line.trim().length > 0)\n    .map((line) => JSON.parse(line) as T);\n}\n\n/**\n * Read the last N entries from a JSONL file (most recent first).\n */\nexport function readJsonlTail<T>(filePath: string, count: number): T[] {\n  const all = readJsonl<T>(filePath);\n  return all.slice(-count).reverse();\n}\n\n/**\n * Check if a file exists.\n */\nexport function fileExists(filePath: string): boolean {\n  return existsSync(filePath);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,SAAgB,UAAU,SAAuB;AAC/C,KAAI,CAAC,WAAW,QAAQ,CACtB,WAAU,SAAS,EAAE,WAAW,MAAM,CAAC;;;;;AAO3C,SAAgB,gBAAgB,UAAwB;AACtD,WAAU,QAAQ,SAAS,CAAC;;;;;;;;;AAU9B,SAAgB,SAAY,UAAqB;CAC/C,MAAM,UAAU,aAAa,UAAU,QAAQ;AAC/C,QAAO,KAAK,MAAM,QAAQ;;;;;AAM5B,SAAgB,WAAc,UAAkB,cAAoB;AAClE,KAAI,CAAC,WAAW,SAAS,CACvB,QAAO;AAET,QAAO,SAAY,SAAS;;;;;;AAO9B,SAAgB,UAAU,UAAkB,MAAqB;AAC/D,iBAAgB,SAAS;AACzB,eAAc,UAAU,KAAK,UAAU,MAAM,MAAM,EAAE,GAAG,MAAM,QAAQ;;;;;;;AAQxE,SAAgB,YAAY,UAAkB,OAAsB;AAClE,iBAAgB,SAAS;AACzB,gBAAe,UAAU,KAAK,UAAU,MAAM,GAAG,MAAM,QAAQ;;;;;;;;AASjE,SAAgB,UAAa,UAAuB;AAClD,KAAI,CAAC,WAAW,SAAS,CACvB,QAAO,EAAE;AAGX,QADgB,aAAa,UAAU,QAAQ,CAE5C,MAAM,KAAK,CACX,QAAQ,SAAS,KAAK,MAAM,CAAC,SAAS,EAAE,CACxC,KAAK,SAAS,KAAK,MAAM,KAAK,CAAM;;;;;AAMzC,SAAgB,cAAiB,UAAkB,OAAoB;AAErE,QADY,UAAa,SAAS,CACvB,MAAM,CAAC,MAAM,CAAC,SAAS"}

package/dist/index.d.mts

@@ -0,0 +1,35 @@
+//#region src/index.d.ts
+/**
+ * Clawvif — OpenClaw Plugin Entry Point
+ *
+ * This is the main entry point loaded by OpenClaw's plugin system via jiti.
+ * It registers all Clawvif tools that the agent can invoke.
+ *
+ * IMPORTANT: This default export function must be SYNCHRONOUS.
+ * OpenClaw's plugin loader ignores async activate functions.
+ */
+/** OpenClaw Plugin API (minimal typing) */
+interface OpenClawPluginApi {
+  registerTool(config: {
+    name: string;
+    description: string;
+    parameters: unknown;
+    execute: (id: string, params: Record<string, unknown>) => Promise<{
+      content: Array<{
+        type: string;
+        text: string;
+      }>;
+    }>;
+  }, options?: {
+    optional?: boolean;
+  }): void;
+  /** Plugin-specific config from openclaw.json plugins.entries.<id>.config */
+  pluginConfig?: Record<string, unknown>;
+}
+/**
+ * Plugin entry — called synchronously by OpenClaw at load time.
+ */
+declare function clawvifPlugin(api: OpenClawPluginApi): void;
+//#endregion
+export { clawvifPlugin as default };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;UAuBU,iBAAA;EACR,YAAA,CAAa,MAAA;IACX,IAAA;IACA,WAAA;IACA,UAAA;IACA,OAAA,GAAU,EAAA,UAAY,MAAA,EAAQ,MAAA,sBAA4B,OAAA;MACxD,OAAA,EAAS,KAAA;QAAQ,IAAA;QAAc,IAAA;MAAA;IAAA;EAAA,GAEhC,OAAA;IAAY,QAAA;EAAA;EAAA;EAGf,YAAA,GAAe,MAAA;AAAA;;;;iBAMO,aAAA,CAAc,GAAA,EAAK,iBAAA"}