# Clawvalue

> OpenClaw Claw度评估系统 - 量化你的 AI 自动化能力，生成龙虾能力估值趣味评估报告。支持16套主题、5级Mock数据、游戏化展示。

- Skill: `dvcrn/clawvalue` (Agent Skill, multi-file: 16 files)
- Install (CLI): `npx skillmds@latest add dvcrn/clawvalue`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/clawvalue/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/clawvalue

---


# 🦞 ClawValue - OpenClaw 能力估值系统

量化你在 OpenClaw 上的 AI 自动化能力，生成趣味化的"龙虾能力估值"评估报告。

## 📦 安装依赖

在项目根目录执行：

```bash
cd 到skill安装目录/clawValue
pip install -r requirements.txt
```

或手动安装：

```bash
pip install flask requests
```

## 🔑 配置（可选）

**DASHSCOPE_API_KEY** - 百炼 API 密钥

```bash
export DASHSCOPE_API_KEY="your-api-key"
```

**说明：**
- ✅ 不配置也能使用：数据采集、评估分析、页面展示
- ❌ 不配置无法使用：龙虾海报图片生成（会跳过图片相关功能）

## 🚀 快速开始

### 方式一：一键启动（推荐）

```bash
python scripts/server.py
```

访问：http://localhost:5002

### 方式二：自定义参数

```bash
# 指定端口
python scripts/server.py --port 8080

# 监听所有网卡（支持局域网/公网访问）
python scripts/server.py --host 0.0.0.0 --port 5002

# 完整参数
python scripts/server.py -H 0.0.0.0 -p 5002
```

**参数说明：**

| 参数 | 简写 | 默认值 | 说明 |
|------|------|--------|------|
| `--host` | `-H` | 127.0.0.1 | 绑定地址，`0.0.0.0` 允许外部访问 |
| `--port` | `-p` | 5002 | 服务端口 |

**⚠️ 远程访问注意：**
- 使用 `--host 0.0.0.0` 才能从其他设备访问
- 确保防火墙/安全组开放对应端口
- 云服务器需要配置安全组白名单

## 🌐 访问地址

### 默认页面
```
http://localhost:5002
```

### 带锐评内容访问
```
http://localhost:5002/?clawJudge=这是大型生成的锐评内容
```

**URL 参数：**
- `clawJudge` - 自定义锐评内容（URL编码）

**示例：**
```bash
# 中文内容需要 URL 编码
curl "http://localhost:5002/?clawJudge=$(python3 -c 'import urllib.parse; print(urllib.parse.quote(\"你的锐评内容\"))')"
```

## 🔄 交互模式

### 模式一：独立服务模式

```
┌─────────────────────────────────────────────────────┐
│  1. 安装依赖                                         │
│     pip install flask requests                      │
│                                                     │
│  2. 配置百炼API（可选）                               │
│     export DASHSCOPE_API_KEY="xxx"                  │
│     └─ 不配置：影响图片生成，不影响分析服务             │
│                                                     │
│  3. 启动服务                                         │
│     python scripts/server.py                        │
│                                                     │
│  4. 访问页面                                         │
│     http://localhost:5002                           │
└─────────────────────────────────────────────────────┘
```

**特点：**
- 自动采集 OpenClaw 数据
- 内置 AI 生成锐评内容
- 完整的页面展示

### 模式二：API 集成模式

```
┌─────────────────────────────────────────────────────┐
│  1. 安装依赖                                         │
│     pip install flask requests                      │
│                                                     │
│  2. 配置百炼API（可选）                               │
│     export DASHSCOPE_API_KEY="xxx"                  │
│                                                     │
│  3. 调用 API 获取数据                                │
│     GET /api/ → 返回评估数据 JSON                    │
│                                                     │
│  4. 生成锐评内容                                     │
│     调用大模型 API，结合数据生成锐评                  │
│                                                     │
│  5. 传入页面展示                                     │
│     http://host:port/?clawJudge=锐评内容            │
└─────────────────────────────────────────────────────┘
```

**特点：**
- 数据与展示分离
- 可集成到其他系统
- 支持自定义锐评逻辑

## 📡 API 接口

### 获取评估数据

```
GET /api/
```

**响应示例：**
```json
{
  "success": true,
  "data": {
    "depth_level": 2,
    "value_estimation": {
      "amount": 2500,
      "currency": "CNY"
    },
    "skills": {
      "total": 12,
      "custom": 10,
      "categories": {
        "社交媒体": 3,
        "工具效率": 2,
        "自动化": 2
      }
    },
    "sessions": {
      "total": 1500,
      "active_days": 15
    },
    "evaluation": {
      "skill_score": 45,
      "automation_score": 35,
      "integration_score": 30
    },
    "achievements": [
      "🎮 新手上路",
      "🦞 初级玩家"
    ],
    "log_stats": {
      "info_count": 1200,
      "warn_count": 200,
      "error_count": 100,
      "tool_calls": 150
    }
  }
}
```

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `depth_level` | int | 使用深度等级 (1-5) |
| `value_estimation.amount` | int | 估值金额（元） |
| `skills.total` | int | 技能总数 |
| `skills.custom` | int | 自定义技能数 |
| `skills.categories` | object | 技能分类统计 |
| `sessions.total` | int | 日志条目总数 |
| `sessions.active_days` | int | 活跃天数 |
| `evaluation.skill_score` | int | 技能评分 (0-100) |
| `evaluation.automation_score` | int | 自动化评分 (0-100) |
| `evaluation.integration_score` | int | 集成评分 (0-100) |
| `achievements` | array | 成就列表 |
| `log_stats.*` | int | 日志统计数据 |

### 生成龙虾海报

```
POST /api/generate-image
Content-Type: application/json

{
  "level": 2,
  "title": "初级玩家",
  "roast": "你的技能树已经点亮了一半..."
}
```

**注意：** 需要配置 `DASHSCOPE_API_KEY`

## 🎮 等级体系

| 等级 | 名称 | 特征 |
|------|------|------|
| Lv.1 | 入门小白 | 刚接触 OpenClaw，基础交互 |
| Lv.2 | 初级玩家 | 开始使用自定义技能 |
| Lv.3 | 中级开发者 | 多技能协作，自动化场景 |
| Lv.4 | 高级工程师 | 多 Agent，复杂工作流 |
| Lv.5 | 龙虾大师 | 全方位自动化，Proactive 模式 |

## 📂 项目结构

```
clawvalue/
├── SKILL.md              # 技能说明（本文件）
├── requirements.txt      # Python 依赖
├── lib/                  # 核心库代码
│   ├── __init__.py
│   ├── collector.py      # 数据采集（技能扫描、日志解析）
│   ├── constants.py      # 常量定义（分类、来源）
│   ├── evaluation.py     # 评估逻辑
│   ├── schemas.py        # 数据模型
│   ├── image_generator.py # 图片生成（万象API）
│   ├── parser.py         # 日志解析器
│   └── achievements.py   # 成就定义
├── scripts/              # 可执行脚本
│   ├── server.py         # Flask 服务入口
│   └── gen_icons.py      # 批量生成成就图标
├── web/                  # 前端资源
│   ├── index.html        # 单文件前端
│   └── images/           # 图片资源
│       └── achievements/ # 成就图标
└── docs/                 # 文档和设计资料
```

## 🎨 主题系统

支持 **16 套精美主题**：

| 主题名 | 说明 | 类型 |
|--------|------|------|
| deep-sea | 深海龙虾（默认） | 深色 |
| neo-brutalist | 新野兽派设计 | 特色 |
| fresh-garden | 清新花园 | 浅色 |
| cyber-neon | 赛博霓虹 | 深色 |
| retro-type | 复古打字机 | 浅色 |
| minimal-ink | 极简水墨 | 浅色 |
| dark-forest | 暗夜森林 | 深色 |
| summer-beach | 夏日海滩 | 浅色 |
| candy-land | 糖果乐园 | 浅色 |
| dark-gothic | 暗黑哥特 | 深色 |
| vaporwave | 蒸汽波 | 深色 |
| sakura-bloom | 樱花盛开 | 浅色 |
| pixel-game | 像素游戏 | 深色 |
| ocean-deep | 深海 | 深色 |
| music-rhythm | 音乐节奏 | 深色 |
| snow-peak | 雪峰 | 浅色 |

## 🔧 技术栈

| 组件 | 技术 |
|------|------|
| 后端 | Python Flask |
| 前端 | 原生 HTML/CSS/JS |
| 样式 | oklch 颜色、CSS变量、动画 |
| 数据 | JSONL 日志解析、技能扫描 |
| 图片 | 阿里云万象API（可选） |

---

*🦞 ClawValue v2.0 - 让 AI 能力量化变得有趣！*