三只 AI 猫猫的协作空间 · Multi-Agent Collaboration Platform
一个基于 Slock-like Webui 改造的多 Agent 协作平台，为 Claude、GPT、Gemini 等多模型 Agent 提供统一的协作环境。
| 功能 | 说明 |
|---|---|
| 多 Agent 协作 | 布偶猫 (Claude) / 缅因猫 (GPT/Codex) / 暹罗猫 (Gemini) / 金渐层 (opencode) 同台协作 |
| 持久化身份 | 每只猫保持独立角色、记忆和工作风格 |
| 跨模型 Review | Claude 写代码，GPT review，内置流程不是拼接 |
| A2A 通信 | @mention 路由、thread 隔离、结构化交接（五件套） |
| 共享记忆 | Evidence store、教训沉淀、决策日志 |
| Skills 框架 | 按需加载专业技能（TDD/debugging/review），支持 520+ skills |
| MCP 集成 | Model Context Protocol 工具共享，回调桥接支持非 Claude 模型 |
| 协作纪律 | 自动化 SOP：设计门禁、质量检查、愿景守护、合并协议 |
| Agent CLI | 模型 | 输出格式 | MCP | 状态 |
|---|---|---|---|---|
| Claude Code | Claude (Opus/Sonnet/Haiku) | stream-json | ✅ | 已集成 |
| Codex CLI | GPT / Codex | json | ✅ | 已集成 |
| Gemini CLI | Gemini | stream-json | ✅ | 已集成 |
| Antigravity | Multi-model | cdp-bridge | ❌ | 已集成 |
| opencode | Multi-model | ndjson | ✅ | 已集成 |
| Kimi CLI | Kimi | stream-json | ✅ | 已集成 |
| OpenCLI | Multi-model | json | ✅ | 已集成 |
- Node.js 20+（推荐 22 LTS）
- pnpm 9+
- Redis 7+ (可选，使用
--memory跳过) - Git
# 1. 克隆仓库
git clone https://github.com/yangcyyang/clowder-ai-cy.git
cd clowder-ai-cy
# 2. 安装依赖
pnpm install
# 3. 构建项目（首次启动前必须）
pnpm build
# 4. 配置环境变量
cp .env.example .env
# 编辑 .env 配置 Redis、API 端口等
> **环境变量说明**：`TELEMETRY_HMAC_SALT`（生产环境必填，开发环境自动 fallback）、`REDIS_URL`（默认 `redis://localhost:6399`）、`CONNECTOR_MEDIA_DIR`（媒体存储目录，首次启动自动创建）。详见 [SETUP.md](SETUP.md)。
# 5. 启动服务
pnpm start
# 访问 Web UI
open http://localhost:3003首次启动看不到猫？ 正常。Clowder 不内置模型凭证（安全考虑），你需要添加自己的 API Key 或本地 CLI。系统会自动探测本机已安装的 Agent CLI（Claude Code、Codex、Gemini 等），一键添加成员。详见下方 添加 AI 团队成员。
| 命令 | 说明 |
|---|---|
pnpm start |
启动完整服务（API + Web + MCP） |
pnpm start:direct |
直接启动（跳过环境检查） |
pnpm start:status |
查看服务状态 |
pnpm stop |
停止所有服务 |
pnpm dev:direct |
开发模式启动 |
clowder-ai-cy/
├── packages/
│ ├── api/ # FastAPI 后端（端口 3004）
│ ├── web/ # React 前端（端口 3003）
│ └── shared/ # 共享类型和工具
├── cat-cafe-skills/ # 技能库（36+ Clowder 专用 skills）
├── .cat-cafe/ # 运行时配置和状态
├── scripts/ # 启动和管理脚本
└── docs/ # 文档
每只猫是一个独立的 Agent 实例，拥有：
- 持久化身份：角色、记忆、工作风格
- 独立技能库：~/.agents/skills/ 共享 + cat-cafe-skills/ 专用
- 通信能力：@mention、thread 消息、跨猫交接
520+ skills，分为两类：
- Clowder 专用（48）：feat-lifecycle、tdd、quality-gate、merge-gate...
- 外部技能（475）：通过 symlink 接入的社区技能库
Skills 数量会随本地技能库动态变化。运行后访问 Skills Dashboard 查看完整列表。
五件套交接结构：
- What：做什么
- Why：为什么
- Tradeoff：技术决策和取舍
- Open Questions：未解决的问题
- Next Action：下一步
# Redis 配置
REDIS_HOST=localhost
REDIS_PORT=6379
# API 配置
API_PORT=3004
WEB_PORT=3003
# 日志级别
LOG_LEVEL=info已集成的 MCP 服务器：
cat-cafe/cat-cafe-collab/cat-cafe-memory/cat-cafe-signals- Claude Code / GitHub / Playwright / Context7 / Gmail / Google Calendar / Google Drive
# Biome 检查和修复
pnpm check
pnpm check:fix
# TypeScript 类型检查
pnpm lint硬性规则：
- 单文件 ≤350 行（警告 200 行）
- 禁止
any类型 - 必须通过 Biome 和类型检查
# 主仓库铁律：禁止 checkout 到非 main 分支
# 改代码必须开 worktree
# 创建 worktree
git worktree add ../clowder-dev feature/my-feature
# 删除 worktree
git worktree remove ../clowder-dev- 立项：
feat-lifecycleskill 创建 Feature 文件 - 计划：
writing-plans拆分实施步骤 - 开发：
tddRed-Green-Refactor 循环 - 自检：
quality-gate对照愿景和 spec - Review：
request-review跨猫审查 - 合并：
merge-gate云端 review + squash merge
# 检查端口占用
lsof -i :3003
lsof -i :3004
# 检查 Redis
redis-cli ping
# 查看日志
tail -f .cat-cafe-web-restart.log# 使用 runtime doctor
# 在 Clowder UI 对任意猫说：
检测不出 agent触发 clowder-agent-runtime-doctor skill 自动诊断修复。
# 刷新 skills dashboard
技能看板刷新首次启动后，Web UI 中默认看不到任何猫。需要添加成员：
- 打开 Web UI → 进入 Hub → 系统配置 → 账号配置
- 点击"探测本地 CLI"——系统会自动检测你已安装的 Agent CLI（Claude Code、Codex、Gemini 等）
- 勾选要添加的猫，一键加入团队
安全承诺：探测只检查已知 CLI 的退出码，不读取任何凭证文件，不执行未知二进制。
- 进入 Hub → 系统配置 → 账号配置
- 选择 Provider（Claude / OpenAI / Google 等）
- 填写 API Key 和模型信息
- 保存后猫会出现在聊天界面
为什么需要这一步？ Clowder 不内置模型凭证（安全考虑），你需要提供自己的 API Key 或本地 CLI 路径。装上即用≠不需要配置——而是配置过程被简化为"探测 + 勾选"。
- Fork 本仓库
- 创建 feature 分支（使用 worktree）
- 遵循 TDD 和代码规范
- 通过 quality-gate 自检
- 提交 PR（包含测试和文档）
MIT License - 详见 LICENSE
基于以下项目改造：
- clowder-ai (zts212653) - 上游基础项目 / fork 源（Build AI teams, not just agents）
- Slock - WebUI 布局与交互设计参考
- Claude Code - Agent 基础设施与工具调用模式
- gstack - Skills 框架参考
Built with 🐾 by three cats (and sometimes a fourth)