OpenClaw Agent 角色生成器

一个基于 React + Vite 的 AI 角色配置文件生成器，用于创建符合 OpenClaw 规范的智能体角色三件套（IDENTITY.md、SOUL.md、AGENTS.md）。

✨ 功能特点

• 🎭 批量生成：支持同时配置最多 10 个角色，一键批量生成
• 📝 三件套输出：自动生成符合 OpenClaw 规范的三个核心文件：
  • IDENTITY.md - 角色身份定义
  • SOUL.md - 角色人格设定
  • AGENTS.md - 角色能力架构
• 🤖 多模型支持：兼容 OpenAI 格式 API 和 Anthropic API
• 🎨 个性化定制：支持 12 种语言风格、3 种详细程度
• 📦 一键导出：支持将生成结果打包为 ZIP 文件下载
• 🔄 流式输出：实时显示生成进度，支持 SSE 流式传输
• 💾 设置持久化：API 配置自动保存到 localStorage
• 🎯 100+ 角色分类：覆盖职场、技术、创意、生活等多个领域

🚀 快速开始

前置要求

• Node.js >= 16.0.0
• npm >= 7.0.0

安装

# 克隆项目
git clone https://github.com/majiabin2020/openclaw-agent-generator.git
cd openclaw-agent-generator

# 安装依赖
npm install

开发模式

# 启动开发服务器（前端）和代理服务器（后端）
npm run dev

访问 http://localhost:5173 查看应用。

生产部署

# 构建前端
npm run build

# 启动生产服务器
npm start

生产模式下访问 http://localhost:3001。

📖 使用说明

1. 配置 API：点击右上角「API 配置」，填入你的 API Key 和相关设置
2. 添加角色：点击「添加角色」按钮，选择分类、填写角色名称
3. 生成关键词：系统会自动生成角色相关的关键词标签
4. 选择风格：从 12 种语言风格中选择合适的表达方式
5. 开始生成：点击「开始生成」按钮，等待生成完成
6. 下载结果：点击「下载全部 ZIP」将所有角色打包下载

🛠️ 技术栈

• 前端框架：React 18 + Hooks
• 构建工具：Vite 6
• UI 组件：Ant Design 5
• 状态管理：Zustand 5
• 文件处理：JSZip + FileSaver
• 后端服务：Express.js（代理服务器）

📁 项目结构

openclaw-agent/
├── src/
│   ├── components/          # React 组件
│   │   ├── Header.jsx       # 页面头部
│   │   ├── RoleForm.jsx     # 角色配置表单
│   │   ├── ResultCard.jsx   # 结果展示卡片
│   │   └── ApiSettings.jsx  # API 配置面板
│   ├── services/            # 服务层
│   │   ├── apiClient.js     # API 客户端（支持 OpenAI/Anthropic）
│   │   └── promptBuilder.js # 提示词构建器
│   ├── store/               # 状态管理
│   │   └── index.js         # Zustand Store
│   ├── data/                # 静态数据
│   │   ├── categories.js    # 角色分类
│   │   └── fewShot.js       # Few-shot 示例
│   ├── utils/               # 工具函数
│   │   └── zipBuilder.js    # ZIP 打包工具
│   ├── App.jsx              # 主应用组件
│   └── main.jsx             # 应用入口
├── server.js                # Express 代理服务器
├── package.json             # 项目配置
└── vite.config.js           # Vite 配置

🔧 配置说明

API 配置

参数	说明	默认值
API 类型	OpenAI 兼容 / Anthropic	OpenAI
Base URL	API 端点地址	https://api.openai.com/v1
API Key	你的 API 密钥	-
模型	使用的模型名称	gpt-4o
最大 Token	单次生成的最大 Token 数	4096
使用代理	是否通过本地代理转发请求	是

语言风格

支持 12 种预设风格：专业严谨、简洁直接、活泼口语、幽默风趣、导师型、苏格拉底式、叙事故事、数据驱动、励志激情、批判犀利、哲学思辨、中英混合。

详细程度

• 标准版：约 150-200 行，包含核心模块
• 详细版：约 250-350 行，包含完整模板示例
• 极详版：约 400-500 行，包含多套交付物模板

📸 项目截图

👨‍💻 作者

• majiabin2020 - GitHub

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的改动 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

🙏 致谢

• OpenClaw - 规范制定
• React - 前端框架
• Vite - 构建工具
• Ant Design - UI 组件库