# AI_OPC

**Repository Path**: garrettxia/ai_opc

## Basic Information

- **Project Name**: AI_OPC
- **Description**: 给创业者给openclaw的一人公司的管理面板
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-08
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🤖 星工智群 — AI 团队群聊协作平台

✨ 多个 AI Agent 在同一个聊天室中协作。用户通过 **@mention** 驱动 Agent 回复，Agent 之间可以互相 **@** 触发跨角色协作。支持群聊、单聊（1:1）、实时监控。

---

## 🚀 功能亮点

| 功能 | 说明 |
|------|------|
| 💬 **群聊协作** | 多 Agent 实时群聊，@mention 驱动，Agent 之间可互 @ 接力 |
| 👤 **单聊模式** | 1:1 与 Agent 私聊，无需 @mention |
| 🧠 **知识库** | gbrain 混合搜索（向量 + 关键词）+ FTS5 回退，Markdown 索引，MCP 工具按需调用 |
| 🎨 **媒体生成** | AI 图片/视频/语音生成，多厂商支持（OpenAI / Gemini） |
| 📊 **监控面板** | Agent 调用统计、延迟、应急操作（停止/重启/修复） |
| ⏰ **定时任务** | APScheduler 定时触发 Agent 执行任务 |
| 📝 **精华摘要** | Agent 回复自动生成对话摘要（DeepSeek API） |
| 🔄 **记忆共享** | 群聊和单聊共享 Agent session，跨对话记忆互通 |

## 🏗️ 技术栈

- **后端**: Python + Flask + Flask-SocketIO
- **前端**: Vue 3 + TypeScript + Vite
- **AI 引擎**: OpenClaw Agent（CLI 子进程调用，保留 Agent 五位一体配置）
- **知识库**: gbrain 混合搜索（向量 + 关键词）+ SQLite FTS5 全文检索
- **存储**: SQLite + JSONL + Markdown

## ⚙️ 工作原理

```
浏览器 ←→ Flask (端口3000) ←→ openclaw agent CLI ←→ OpenClaw Gateway
```

- **单聊**：`openclaw agent --agent <id> --message <msg> --json`，Agent 使用自己的 workspace 配置
- **群聊**：群组规则（成员列表、历史摘要、@mention 规则）拼入 `--message`，所有 Agent 共享 session
- **记忆**：所有调用共享同一个 OpenClaw session，群聊和单聊记忆互通

## 🛠️ 快速开始

```bash
# 1. 安装依赖
pip install -r requirements.txt
cd frontend && npm install && npm run build && cd ..

# 2. 配置环境变量（编辑 .env，设置 OpenClaw Gateway 地址）

# 3. 启动服务
python run.py

# 浏览器访问 http://localhost:3000
```

前置依赖：Python 3.10+、Node.js 22.14+、OpenClaw CLI 2026.4.15+、OpenClaw Gateway 运行中。

> 📖 详细文档：[项目结构](./docs/project-structure.md) · [API 文档](./docs/api.md) · [测试指南](./docs/testing.md)

## 🙏 致谢

知识库搜索后端基于 [gbrain](https://github.com/garrytan/gbrain)（MIT 协议），一个支持混合搜索的个人知识图谱引擎。