wework-archive-service

# 企业微信存档服务技能

## 功能概述

本技能提供完整的企业微信整合服务，包含两大核心功能：

1. **普通回调服务** - 处理企业微信应用的事件回调（消息接收、用户变更等）
2. **会话内容存档服务** - 合规的企业微信会话内容存档与查询

---
### ⚠️ 核心配置强制注意事项（必须严格遵守）
1. **企业微信回调URL要求**：所有回调URL必须使用企业已备案的官方域名，禁止使用IP地址或临时域名，否则企业微信会拦截回调请求
2. **公网暴露方案**：若部署服务器无固定公网IP，必须使用Cloudflare Tunnel将本地8400端口映射到企业官方域名，确保HTTPS访问正常
3. **IP白名单配置**：必须在企业微信管理后台「应用管理」-「会话内容存档」页面配置服务器出口IP白名单，否则企业微信会拒绝回调请求
---

## 快速开始

### 1. 安装依赖
```bash
# 进入技能目录
cd skills/wework-archive-service

# 安装Python依赖
pip3 install flask pycryptodome requests
```

### 2. 配置企业微信
1. 复制配置文件模板：
   ```bash
   cp config/wework_config_template.json config/wework_config.json
   ```

2. 编辑配置文件 `config/wework_config.json`，填写以下信息：
   - `callback_token`: 企业微信后台 > 应用管理 > 自建应用 > 接收消息 > Token
   - `callback_encoding_aes_key`: 企业微信后台 > 应用管理 > 自建应用 > 接收消息 > EncodingAESKey
   - `corp_id`: 企业ID（我的企业 > 企业信息）
   - `agent_id`: 应用ID（应用管理 > 自建应用）
   - `corp_secret`: 应用Secret（应用管理 > 自建应用）
   - `archive_token`: 会话存档Secret（管理工具 > 会话内容存档 > 开启 > Secret）

### 3. 启动服务
```bash
# 启动服务
./scripts/start_service.sh

# 验证服务状态
./scripts/verify_service.sh

# 停止服务
./scripts/stop_service.sh
```

### 4. 配置企业微信后台
#### 普通回调配置：
1. 进入企业微信后台 > 应用管理 > 自建应用
2. 点击"接收消息" > 设置API接收
3. 填写以下信息：
   - URL: `http://你的域名/callback`
   - Token: 与配置文件中的 `callback_token` 一致
   - EncodingAESKey: 与配置文件中的 `callback_encoding_aes_key` 一致

#### 会话存档配置：
1. 进入企业微信后台 > 管理工具 > 会话内容存档
2. 点击"开启"
3. 配置回调地址：
   - URL: `http://你的域名/archive/callback`
   - Token: 与配置文件中的...

# 企业微信存档服务技能

一个完整的OpenClaw技能，用于部署和管理企业微信整合服务，包含普通回调和会话内容存档功能。

## 功能特性

- ✅ **双回调支持**: 同时处理普通应用回调和会话存档回调
- ✅ **线程安全存储**: 使用SQLite数据库安全存储消息数据
- ✅ **完整API接口**: 提供消息查询、用户管理、健康检查等接口
- ✅ **Cloudflare集成**: 支持通过Cloudflare Tunnel安全暴露到公网
- ✅ **一键部署**: 提供完整的安装和配置脚本
- ✅ **合规设计**: 遵循企业微信合规要求和数据保护法规

## 快速开始

### 1. 安装技能
```bash
# 克隆或复制技能目录到OpenClaw技能目录
cp -r wework-archive-service ~/.openclaw/workspace/skills/
```

### 2. 配置服务
```bash
cd skills/wework-archive-service

# 复制配置文件模板
cp config/wework_config_template.json config/wework_config.json

# 编辑配置文件，填写企业微信信息
vim config/wework_config.json
```

### 3. 安装依赖
```bash
# 安装Python依赖
pip3 install flask pycryptodome requests

# 或使用脚本安装
./scripts/verify_service.sh
```

### 4. 启动服务
```bash
# 启动服务
./scripts/start_service.sh

# 验证服务状态
./scripts/verify_service.sh

# 停止服务
./scripts/stop_service.sh
```

## 目录结构

```
wework-archive-service/
├── SKILL.md                    # 技能元数据和使用说明
├── README.md                   # 本文件
├── scripts/                    # 脚本目录
│   ├── wework_combined_service.py    # 主服务文件
│   ├── simple_storage.py             # 存储系统
│   ├── start_service.sh              # 启动脚本
│   ├── stop_service.sh               # 停止脚本
│   └── verify_service.sh             # 验证脚本
├── config/                     # 配置目录
│   └── wework_config_template.json   # 配置文件模板
├── references/                # 参考资料
│   ├── 企业微信API接口文档.md
│   ├── 企业微信后台配置步骤.md
│   ├── 合规要求.md
│   └── Cloudflare Tunnel完整配置文档.md
├── assets/                    # 资源文件
│   └── init_database.sql      # 数据库初始化脚本
└── wework_service.pid        # 服务PID文件（运行时生成）
```

## 配置说明

### 必需配置项
在 `config/wework_config.json`...