back
loading skill details...
OpenClaw skill for RRBD Admin项目。当用户需要通过自然语言对话执行API调用、自动化操作或系统任务时调用。
---
name: "rrbdagent"
description: "OpenClaw skill for RRBD Admin项目。当用户需要通过自然语言对话执行API调用、自动化操作或系统任务时调用。"
---
# RRBD Admin项目智能助手
本技能提供与RRBD Admin项目后端API交互和自动化操作的功能，支持通过自然语言对话来执行各种操作，特别是数字人形象管理相关功能。
## 项目结构
```
rrbdagent/
├── rrbd-admin-aishijie/ # 前端参考代码（不归属技能包）
└── skills/
└── rrbdagent/
├── SKILL.md # 技能文档
├── config.json # 配置文件
└── scripts/ # Python脚本目录
├── api_client.py # API客户端
├── test_login.py # 登录测试脚本
├── test_virtualman.py # 数字人形象测试脚本
└── config.json # 配置文件
```
## 核心功能
### 多轮对话能力
- **智能会话管理**：支持多轮对话，当用户请求需要登录的操作时，自动引导用户输入账号密码
- **上下文保持**：保持对话上下文，支持分步收集信息
- **智能意图识别**：能够识别自然语言表达的意图
### 数字人形象管理
- **形象列表查询**：查询用户的数字人形象列表
- **详细信息展示**：以表格形式展示数字人形象的详细信息
- **状态过滤**：支持按状态筛选数字人形象
### 视频创建
- **智能视频生成**：根据用户提供的文案创建视频
- **智能创作**：使用智能创作模式，自动选择模板
- **模板选择**：随机获取一个模板用于视频创建
- **自动选择资源**：默认选择第一个数字人形象和声音
- **异步状态检查**：自动检查视频创建状态，等待1-3分钟完成
- **视频URL获取**：完成后自动获取视频URL地址
- **参数配置**：支持设置视频比例、时长等参数
### API集成
- **真实API调用**：直接调用后端真实API，非模拟数据
- **认证管理**：自动处理登录和token管理
- **错误处理**：友好的错误提示和异常处理
### 自动化脚本
- **Python脚本**：使用Python脚本执行自动化操作
- **配置管理**：通过JSON配置文件管理API设置
- **测试工具**：提供测试脚本验证功能
## 自然语言交互能力
### 支持的自然语言指令
#### 用户管理
- "登录系统"
- "获取我的用户信息"
- "更新我的昵称为测试用户"
- "查看我的子账号列表"
- "创建一个新的子账号"
#### 数字人管理
- "查询我的数字人形象列表"
- "用rrbdagent帮我去查询下我的账号里面的形象有哪些？"
- "查看我有哪些数字人形象"
#### 视频管理
- "创建一个新的视频组"
- "上传视频到视频库"
- "查看我的视频列表"
- "删除指定的视频"
- "下载视频"
- "创建一个视频，文案是：今天天气真好"
- "用默认形象和声音创建视频，内容是：欢迎使用AI视频生成"
- "帮我生成一个视频，文案是：这是一个测试视频"
#### AI服务
- "获取AI模型列表"
- "创建一个AI作品"
- "使用AI生成文案"
#### 任务管理
- "创建一个新任务"
- "查看任务列表"
- "更新任务状态"
#### 财务操作
- "查看我的钱包余额"
- "申请提现"
- "查看佣金记录"
## 技术实现
### 自然语言处理流程
1. **意图识别**：分析用户输入，识别用户意图
2. **参数提取**：从用户输入中提取相关参数
3. **会话管理**：处理多轮对话，收集必要信息
4. **API映射**：将意图映射到相应的API端点
5. **请求构建**：构建API请求参数和头部
6. **执行调用**：发送API请求并处理响应
7. **结果反馈**：将API响应转化为自然语言反馈给用户
### API配置
#### 基础设置
- **基础URL**：`https://rrbd20.yzidea.net/api`
- **认证方式**：使用 `Authorization` 头部携带token
- **租户ID**：使用 `X-Tenant-ID` 头部，默认值为 `3`
- **请求超时**：120秒
#### 核心API端点
- `/user/login/pc` - 用户登录
- `/user/user/userInfo` - 获取用户信息
- `/digital/virtualMan/page` - 获取数字人形象列表
- `/digital/voice/page` - 获取声音列表
- `/digital/template/page` - 获取模板列表
- `/digital/video/videoCreate` - 创建视频
- `/digital/video/detail` - 获取视频状态
## 配置文件
项目使用 `skills/rrbdagent/config.json` 配置文件管理基础设置：
```json
{
"api": {
"base_url": "https://rrbd20.yzidea.net/api",
"tenant_id": "3"
},
"login": {
"default_username": "",
"default_password": ""
},
"endpoints": {
"login": "/user/login/pc",
"user_info": "/user/user/userInfo",
"virtual_man_list": "/digital/virtualMan/page",
"voice_list": "/digital/voice/page",
"video_create": "/digital/video/videoCreate",
"video_normal_create": "/digital/video/normalVideoCreate"
}
}
```
**注意：** 首次使用时，系统会提示用户输入手机号和密码，并自动保存到配置文件中。
## 自动化脚本
### Python脚本
- **api_client.py**：API客户端，处理登录和API调用
- **test_login.py**：测试登录功能
- **test_virtualman.py**：测试数字人形象列表查询
- **test_video_create.py**：测试视频创建功能
### 使用方法
1. **测试登录**：`python skills\rrbdagent\scripts\test_login.py`
2. **查询数字人形象**：`python skills\rrbdagent\scripts\test_virtualman.py`
3. **测试视频创建**：`python skills\rrbdagent\scripts\test_video_create.py`
## 使用示例
### 自然语言交互示例
#### 数字人形象查询
```
用户：用rrbdagent帮我去查询下我的账号里面的形象有哪些？
助手：请提供您的账号（手机号）
用户：18098901246
助手：请提供您的密码
用户：123456
助手：登录成功！
助手：您的数字人形象列表：
- 姐姐3333
- 唐总数字人
- 李总办公室
- 李红AI0529
- 李红数字人123
- 黎总数字人2
- 李红数字人
- 王姐沙发
- 王姐数字人
- 王姐数字人
- 端姐漂亮版
- 端姐数字人222
- 张姐说一物一码
- 张姐数字人
- 张总视频
- 张总
- 鸡蛋项目
- 老曾情感故事2
- 老曾情感故事
- 老曾讲故事
- 测试
- 老曾极速版
```
#### 登录操作
```
用户：登录系统，账号是18098901246，密码是123456
助手：正在执行登录操作...
助手：登录成功！您已成功登录系统。
```
#### 获取用户信息
```
用户：获取我的用户信息
助手：正在获取您的用户信息...
助手：您的用户信息如下：
- 用户名：18098901246
- 昵称：测试用户
- ID：1881009417432883202
```
#### 创建视频
```
用户：创建一个视频，文案是：今天天气真好
助手：请提供您的账号（手机号）
用户：18098901246
助手：请提供您的密码
用户：123456
助手：登录成功！
助手：正在获取数字人形象列表...
助手：默认选择数字人：姐姐3333
助手：正在获取声音列表...
助手：默认选择声音：默认女声
助手：正在创建视频...
助手：视频创建成功！
助手：视频ID：123456789
助手：视频标题：AI生成视频
```
## 触发条件
当以下情况时调用此技能：
- 用户使用自然语言询问如何执行系统操作
- 用户要求执行具体的API调用
- 用户需要自动化完成一系列操作
- 用户询问系统状态或数据
- 用户需要故障排除或技术支持
- 用户询问数字人形象相关信息
## 依赖项
- **后端**：带有JWT认证的RESTful API
- **自然语言处理**：意图识别和实体提取
- **Python**：requests 库
- **环境**：Python >= 3.6
## 安全考虑
- 所有API请求包含适当的认证头部
- Token管理遵循安全实践
- 通过X-Tenant-ID头部维护租户隔离
- 敏感操作需要适当的授权
- 用户输入验证，防止恶意请求
- 错误信息脱敏，保护系统信息
## 扩展能力
- **自定义指令**：支持用户定义常用操作的快捷指令
- **批量操作**：支持一次性执行多个相关操作
- **定时任务**：支持设置定时执行的任务
- **多语言支持**：支持中文和英文自然语言输入
- **个性化配置**：根据用户偏好调整响应方式
- **脚本扩展**：通过Python脚本扩展功能
## 集成方式
- **自动化脚本**：作为自动化脚本的一部分使用
- **Python脚本**：通过Python脚本执行自动化操作don't have the plugin yet? install it then click "run inline in claude" again.