103 lines
2.4 KiB
Markdown
103 lines
2.4 KiB
Markdown
# 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
|