# openclaw-sandbox-simulator

**Repository Path**: jdragonhu/openclaw-sandbox-simulator

## Basic Information

- **Project Name**: openclaw-sandbox-simulator
- **Description**: 🎮 基于 OpenClaw 的多人物社交对话模拟系统，支持 10+ 人物并行推演、用户干预和事件注入
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 沙盘推演系统

基于 OpenClaw 的多人物社交对话模拟系统，支持 10+ 人物并行推演。

## 功能特性

- **多人物推演**：支持 10+ 人物，5 个 session 分批并行
- **双模式交互**：命令模式 + 自然语言模式
- **用户干预**：暂停/继续、注入事件、修改状态
- **Markdown 存储**：人物、世界状态、历史记录均为 Markdown 文件

## 安装（在openclaw中）
```
# 在openclaw的聊天窗口输入
安装技能 https://github.com/jasonhu/openclaw-sandbox-simulator
```

## 快速开始

```bash
# 初始化场景
开始推演5轮，周末的下午，爸爸妈妈和两个儿子，在家里的餐厅，外面下着大雨，小儿子正在学习网课，大儿子待会儿要去打球。

# 开始推演 5 轮
/sandbox start 5

# 查看状态
/sandbox status

# 注入事件
/sandbox inject 突然下起了大雨

# 暂停/继续
/sandbox pause
/sandbox resume
```

## 命令列表

| 命令 | 别名 | 功能 |
|------|------|------|
| `/sandbox init` | `/sb init` | 初始化场景 |
| `/sandbox start [rounds]` | `/sb start` | 开始推演 |
| `/sandbox pause` | `/sb pause` | 暂停推演 |
| `/sandbox resume` | `/sb resume` | 继续推演 |
| `/sandbox status` | `/sb status` | 查看状态 |
| `/sandbox inject <event>` | `/sb inject` | 注入事件 |
| `/sandbox set <path>=<value>` | `/sb set` | 修改状态 |

## 文件结构

```
skills/sandbox-simulation/
├── SKILL.md              # 主技能定义
├── templates/            # 模板文件
│   ├── character.md
│   └── world-state.md
└── scenarios/            # 场景目录
    └── demo/
        ├── characters/   # 人物配置
        ├── world-state.md
        └── history/      # 历史记录
```

## 已知问题
- [ ] 历史记录可能保存不全
- [ ] session会逐步增多，需要等待系统自动回收
- [ ] 比较慢，4人10轮的话，大约需要20分钟推理完

## 示例场景

`demo` 场景包含 5 个人物的咖啡厅场景：
- **Alice** - 开朗的插画师
- **Bob** - 沉稳的程序员
- **Carol** - 敏感的店员
- **David** - 自信的创业者
- **Eve** - 神秘的撰稿人

## 效果截图
![推演开始](images/image-1.png)

![中间过程](images/image.png)

![推演结束](/images/image-2.png)