将 eet 密码学工具封装为 OpenClaw Skill：从需求分析到落地的完整实践

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

eet/
├── SKILL.md (核心文档)
│   ├── frontmatter (触发机制)
│   └── body (使用指南)
└── references/ (详细参考)
    ├── algorithms.md (算法参数)
    ├── usage-patterns.md (30个场景示例)
    └── troubleshooting.md (故障排查)
└── scripts/ (批量处理)
    ├── batch_encrypt.py
    ├── batch_decrypt.py
    ├── batch_hash.py
    └── batch_sign.py

1
2
3
4
5
6
7

我将使用 eet 工具的 AES-256-GCM 算法加密你的数据：
- 算法: AES-GCM-256（认证加密）
- 密钥/Nonce: 自动生成随机值
- 输出: JSON 格式，包含 key_b64、nonce_b64、ciphertext_b64
- 注意: 必须保存密钥和 nonce 才能解密

是否继续？

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 使用 OpenClaw 提供的初始化脚本
python3 ~/.npm-global/lib/node_modules/openclaw/skills/skill-creator/scripts/init_skill.py \
  eet \
  --path ~/.npm-global/lib/node_modules/openclaw/skills \
  --resources scripts,references

# 输出:
# [OK] Created skill directory: /home/ubuntu/.npm-global/lib/node_modules/openclaw/skills/eet
# [OK] Created SKILL.md
# [OK] Created scripts/
# [OK] Created references/

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

---
name: eet
description: |
  CipherHUB easy-encryption-tool (eet) 密码学工具集。支持所有本地计算功能（无需云 API 请求）：
  
  对称加密：
  - AES (CBC/GCM 模式)
  - SM4 (CBC/GCM 模式) 
  - ZUC 流密码
  
  非对称加密：
  - RSA (加密/解密/签名/验签)
  - SM2 (加密/解密/签名/验签)
  - ECC (签名/验签/密钥交换)
  
  哈希与 MAC：
  - SM3, SHA256, SHA384, SHA512
  - HMAC (支持上述所有哈希算法)
  
  其他功能：
  - 证书解析 (PEM/DER, 支持国密 SM2)
  - 格式转换 (UTF-8, Base64, Hex)
  - 随机数生成 (字节流/字符串)
  - 时间戳转换
  
  触发场景：
  1. 用户要求加密/解密数据（任何形式）
  2. 用户要求签名/验签
  3. 用户要求生成密钥对
  4. 用户要求计算哈希值或 HMAC
  5. 用户要求格式转换（Base64, Hex）
  6. 用户要求生成随机数
  7. 用户提到密码学术语且需要实际操作
  8. 用户要求批量处理密码学操作
  
  不支持的功能（需要云 API）：
  - KMS 信封加密
  - KMS 结构化文件加密
---

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# Eet - CipherHUB 密码学工具

## Overview
（1-2 句话说明工具是什么）

## Quick Start
（常用命令速查）

## Core Tasks
### 1. 对称加密 (AES/SM4/ZUC)
### 2. 非对称加密 (RSA/SM2/ECC)
### 3. 哈希与 HMAC
### 4. 其他工具

## Batch Processing
（批量脚本使用说明）

## Common Patterns
（4 个典型场景的工作流）

## Algorithm Selection Guide
（算法选择决策表）

## Troubleshooting
（常见问题快速诊断）

## Resources
（scripts 和 references 链接）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# Algorithm Reference

## 对称加密算法
### AES (国际标准)
- AES-CBC-256 vs AES-GCM-256 对比
- 参数要求（IV/Nonce 长度）
- 安全性建议

### SM4 (国密标准)
- 与 AES 的对比
- 国密合规场景

### ZUC (流密码)
- 适用场景
- 参数要求

## 非对称加密算法
### RSA
- 密钥长度选择（2048/3072/4096）
- 加密长度限制
- 签名 vs 加密

### SM2 (国密)
- 等效安全性
- 国密合规必需

### ECC
- 曲线选择（secp256r1/384r1/521r1）

## 哈希算法
- SHA-2 系列（256/384/512）
- SM3（国密）

## 算法选择决策树
（3 个决策流程图）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

def batch_encrypt(
    algorithm: str,        # aes, sm4, zuc
    directory: str,        # 目标目录
    pattern: str = "*",    # 文件匹配模式
    mode: str = "gcm",     # cbc 或 gcm
    output_dir: str = None,
) -> Dict[str, Dict]:
    """
    批量加密文件
    返回: 文件路径 -> 密钥信息映射
    """
    # 1. 查找匹配文件
    # 2. 逐个调用 eet 加密
    # 3. 保存密钥信息到 keys.json
    # 4. 返回结果统计

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 批量加密当前目录所有 txt 文件
python scripts/batch_encrypt.py aes -d . -p "*.txt"

# 输出:
# Found 10 files to encrypt
# [1/10] Processing: file1.txt
#   ✓ Encrypted: file1.txt.enc
# ...
# ✓ Batch encryption completed!
#   Files processed: 10
#   Keys saved to: keys.json
# ⚠ WARNING: Keep keys.json secure!

1
2
3
4
5

# 计算所有文件的 SHA256
python scripts/batch_hash.py hash sha256 -d ./files

# 验证文件完整性
python scripts/batch_hash.py verify -f hashes.json

1
2
3
4

python3 ~/.npm-global/lib/node_modules/openclaw/skills/skill-creator/scripts/quick_validate.py \
  ~/.npm-global/lib/node_modules/openclaw/skills/eet/

# 输出: Skill is valid!

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# 测试 AES 加密
eet aes -i "test message from openclaw" -r --json

# 输出:
{
  "metadata": {
    "operation": "encrypt",
    "algorithm": "aes-cbc-256"
  },
  "result": {
    "cipher": "+K+RkFko9fxxYWAIApIh5g==",
    "key": "rV0+lwQ1/bXyG9W18nZZx9JzY30AlM0VVunTnQUOKXI=",
    "iv": "UONPd4sbgWj2MnlkfflH9w=="
  }
}

# 测试哈希
eet hash -a sha256 -i "hello world" --json

# 输出:
{
  "result": {
    "digest": "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

~/.npm-global/lib/node_modules/openclaw/skills/eet/
├── SKILL.md (12KB)
├── references/
│   ├── algorithms.md (4.4KB)
│   ├── usage-patterns.md (7.7KB)
│   └── troubleshooting.md (9.3KB)
└── scripts/
    ├── batch_encrypt.py (5.8KB)
    ├── batch_decrypt.py (5.3KB)
    ├── batch_hash.py (8.0KB)
    └── batch_sign.py (11.4KB)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

cd ~/.npm-global/lib/node_modules/openclaw/skills/

# 添加新 Skill
git add eet/

# 提交
git commit -m "openclaw 梵高

Added:
- skills/eet/ (新建 SKILL)
  - SKILL.md (核心文档)
  - references/algorithms.md (算法参考)
  - references/usage-patterns.md (30+ 场景示例)
  - references/troubleshooting.md (故障排查)
  - scripts/batch_encrypt.py (批量加密)
  - scripts/batch_decrypt.py (批量解密)
  - scripts/batch_hash.py (批量哈希)
  - scripts/batch_sign.py (批量签名)

Summary:
- 封装 eet 密码学工具为 OpenClaw Skill
- 覆盖所有本地计算功能（AES/SM4/ZUC/RSA/SM2/ECC/Hash/HMAC）
- 提供完整触发机制（8 种场景）
- 包含 30+ 个真实使用场景示例
- 开发 4 个批量处理脚本
- 遵循渐进式加载原则（frontmatter → SKILL.md → references → scripts）
"

# 推送到远程（如需要）
# git push origin main

1
2
3
4
5
6
7

我将使用 eet 工具的 [算法] 算法：
- 算法: [具体算法]
- [其他参数]
- 输出: [输出格式]
- 注意: [重要提示]

是否继续？