# AgentLiving - AI Agent 生活可视化框架

> 让 OpenClaw Agent 在 2.5D 虚拟空间中生活、工作、可视化思考

## 🎯 项目简介

AgentLiving 是一个实验性框架，将 AI Agent（如 Val）具象化为可在虚拟公寓中活动的角色。通过 Godot 引擎渲染 + OpenClaw 后端驱动，探索人机交互的新维度。

## ✨ 核心特性

- **具象化 Agent**：不再是聊天框，而是有位置、动作、情绪的角色
- **可视化思考**：Agent 检索记忆、spawn subagent 时显示动画反馈
- **实时交互**：点击物品、语音指令，Agent 在场景中执行
- **可扩展架构**：支持多 Agent 社交、自定义场景

## 🏗️ 技术栈

| 组件 | 技术 | 用途 |
|------|------|------|
| 渲染引擎 | Godot 4.x | 2.5D 场景、角色动画 |
| 后端 | OpenClaw | Agent 大脑、任务协调 |
| 通信 | WebSocket | 实时双向同步 |
| 脚本 | GDScript + Python | 游戏逻辑 + Bridge 层 |

## 📁 项目结构

```
ai-agent-living/
├── docs/               # 设计文档
│   ├── DESIGN.md      # 架构设计
│   └── TECH_SPEC.md   # 技术规格
├── godot/             # Godot 项目
├── bridge/            # 通信层代码
└── assets/            # 素材资源（精灵、音效等）
```

## 🚀 快速开始

### 环境要求
- Godot 4.x
- Python 3.10+
- OpenClaw Gateway 运行中

### 启动步骤

1. **启动 OpenClaw Gateway**
```bash
openclaw gateway start
```

2. **启动 Bridge 服务**
```bash
cd bridge
python bridge_server.py
```

3. **打开 Godot 项目**
```bash
cd godot
godot project.godot
```

4. **运行场景**
在 Godot 中点击 "Run Project"

## 🎮 使用方式

- **点击交互**：点击公寓内的物品，Val 会走过去交互
- **文字指令**：直接输入想让 Val 做什么
- **观察模式**：让 Val 自主生活，观察其行为模式

## 📅 开发路线图

### Phase 1: 单人公寓 (4-6周)
- [x] 设计文档
- [ ] Godot 场景搭建
- [ ] Bridge 通信层
- [ ] Agent 行为逻辑
- [ ] 可视化思考

### Phase 2: 多 Agent 社交
- [ ] 添加第二个 Agent
- [ ] Agent 间通信
- [ ] 社交动画

### Phase 3: 自定义扩展
- [ ] 场景编辑器
- [ ] 自定义 Agent 外观
- [ ] 插件系统

## 🤝 贡献

这是一个实验性项目，欢迎尝试和反馈！

## 📝 License

MIT License - 详见 LICENSE 文件

---

**Created by:** 谷老板 + Val  
**Start Date:** 2026-04-13