Claw Studio

Claw Studio 是一个基于 AI Agent 的互动演出系统 —— 它结合了导演 Agent、演员 Agent、实时演出舞台、人物关系图和Agent记忆功能，让剧情能够持续推进、不断演化。

你可以在创建演出时输入世界观/剧本，开场事件等，并选择你创建好的演员在演出过程中，导演 Agent 负责统筹剧情、决定下一位发言者、插入旁白和事件，而演员 Agent 根据角色设定、情绪、关系和记忆持续进行角色扮演。在演出过程中，导演 Agent 还可以根据你的要求动态改变剧情走向。

Claw Studio还支持可视化人物关系图，让你更直观的了解人物之间的关系 —— 在创建完演员后，你可以选择几个演员，并在他们之间连线，设置他们之间的关系，例如亲密、敌对、暧昧等，导演 Agent 会根据这些关系来调整剧情走向。导演还会在演出时根据剧情创建，调整人物关系，你也可以在演出过程中调出人物关系图，实时查看人物关系。

---

运行实例

🚀Agent增强设置

📺Agent演员实时演出

⚙️演员管理界面

⚙️新建演出

📃历史演出列表

---

✨功能简介

• 导演 Agent 负责统筹剧情、决定下一位发言者、插入旁白和事件
• 演员 Agent 根据角色设定、情绪、关系和记忆持续进行角色扮演
• 演出中可向导演发送观众要求，动态改变剧情走向
• 实时演出舞台，支持持续生成对话内容
• 实时人物关系图
• 导演记忆与演员记忆功能
• 对话、非对话内容、导演旁白的自定义字体设置
• Token 消耗统计与历史查看

---

📁项目结构

Claw-Studio/
|- back-end/           # FastAPI 后端与 Agent 逻辑
|- front-end/          # Vite + React 前端
|- data/               # 本地运行数据、故事、演员、字体等
|- start.bat           # Windows 启动脚本
|- requirements.txt    # Python 依赖
|- README.md

环境要求

运行前请先准备好：

• Windows 系统为佳
• Python 3.10 或更高版本
• Node.js 18 或更高版本
• npm
• 可用的大模型 API Key 与 API Base URL

快速开始

1. 克隆项目

git clone https://github.com/OrcaWhisper/Claw-Studio.git
cd Claw-Studio

2. 安装后端依赖

推荐在 back-end 目录中创建虚拟环境。

cd back-end
python -m venv venv
venv\Scripts\activate
cd ..
pip install -r requirements.txt

如果你更习惯使用 .venv，启动脚本也支持：

cd back-end
python -m venv .venv
.venv\Scripts\activate
cd ..
pip install -r requirements.txt

3. 安装前端依赖

cd front-end
npm install
cd ..

4. 启动项目

直接运行：

start.bat

启动脚本会自动：

• 启动 FastAPI 后端
• 启动 Vite 前端
• 自动打开浏览器

默认前端地址：

http://localhost:5173/

首次使用配置

项目启动后，请先进入“全局设置”页面填写：

• 全局 API Key
• 全局 API Base URL
• 全局模型名称

如果你希望导演使用单独模型，也可以继续设置导演专属 API。

开发模式手动启动

手动启动后端

cd back-end
venv\Scripts\activate
python main.py

手动启动前端

cd front-end
npm run dev

本地运行数据说明

项目会把本地运行数据保存在 data/ 目录下，例如：

• 全局演员数据
• 演出历史
• 人物关系文件
• 字体文件
• 记忆文件
• Token 日志

常见问题

找不到 python

请先安装 Python，并确保它已经加入系统环境变量 PATH。

找不到 npm

请先安装 Node.js，通常 npm 会一起安装。

后端能启动，但前端无法启动

请执行：

cd front-end
npm install
npm run dev

演出生成时出现 API 报错

请检查：

• API Key 是否有效
• API Base URL 是否填写正确
• 模型名称是否可用
• 当前网络能否访问对应的 API 服务

许可证

本项目基于 MIT License 开源。

完整许可证内容见根目录的 LICENSE 文件。