[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74259":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},74259,"OpenMOSS","uluckyXH\u002FOpenMOSS","uluckyXH","A self-organizing multi-agent collaboration platform for OpenClaw. Multiple AI agents work as an autonomous team — planning, executing, reviewing, and patrolling tasks with zero human intervention.","",null,"Python",1280,145,9,16,0,1,4,26,3,19.49,"MIT License",false,"main",true,[],"2026-06-12 02:03:24","# OpenMOSS\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Flogo.png\" alt=\"OpenMOSS Logo\" width=\"200\" \u002F>\n\u003C\u002Fp>\n\n**OpenMOSS，可让多 Agent 自主运行的 AI 公司操作系统**\n\n\u003Cp align=\"center\">\n🚀 \u003Ca href=\"#一为什么需要-openmoss\">为什么选 OpenMOSS\u003C\u002Fa> · \n🎬 \u003Ca href=\"#-实际案例1m-reviews\">实际案例\u003C\u002Fa> · \n🧩 \u003Ca href=\"#-使用场景\">使用场景\u003C\u002Fa> · \n🏗️ \u003Ca href=\"#二系统架构\">系统架构\u003C\u002Fa> · \n⚡ \u003Ca href=\"#五快速启动\">快速启动\u003C\u002Fa> · \n⚙️ \u003Ca href=\"#七配置说明\">配置说明\u003C\u002Fa> · \n📡 \u003Ca href=\"#八api-文档\">API 文档\u003C\u002Fa> · \n🗺️ \u003Ca href=\"#十一roadmap\">Roadmap\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FOpenClaw-Required-blue\" alt=\"OpenClaw\">\u003C\u002Fa>\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.10+-3776AB?logo=python&logoColor=white\" alt=\"Python\">\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBackend-FastAPI-009688?logo=fastapi&logoColor=white\" alt=\"FastAPI\">\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFrontend-Vue%203-4FC08D?logo=vuedotjs&logoColor=white\" alt=\"Vue\">\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDatabase-SQLite-003B57?logo=sqlite&logoColor=white\" alt=\"SQLite\">\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green\" alt=\"License\">\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAgents-4%20Roles-8b5cf6\" alt=\"Agents\">\n\u003C\u002Fp>\n\n> **给你的 AI 公司装上操作系统。**\n\nOpenMOSS 是一个可让多 Agent 自主运行的「AI 公司操作系统」，它凭借 OpenClaw、Claude Code 等 AI Agent 系统的模拟工作能力，实现了**自组织、自修复、自优化、自进化、自巡监、自激励、闭环质量控制、Skill 可插拔、循环任务**等堪比真人团队的工作能力，高度还原真人工作流。经过实测它在一定程度上具备替代「重复劳动办公环境」的可能性，使其可以获得无限进步的生产力。\n\n📖 [实际效果展示及详细使用说明（LINUX DO）](https:\u002F\u002Flinux.do\u002Ft\u002Ftopic\u002F1709670) · 🌐 [English](README_EN.md)\n\n![OpenMOSS，你的AI公司操作系统](docs\u002Fbanner-cn.jpg)\n\n![任务管理](docs\u002Fscreenshots\u002Ftask-management.png)\n\n![Agent 管理](docs\u002Fscreenshots\u002Fagent-management.png)\n\n![仪表盘趋势](docs\u002Fscreenshots\u002Fdashboard-trends.png)\n\n![Agent 协作实况](docs\u002Fscreenshots\u002Fagent-collaboration.png)\n\n### ✨ 核心特点\n\n- 🏢 **像公司一样运转** — 规划者=总监、执行者=员工、审查者=品控、巡查者=运维，AI 们各司其职\n- 🤖 **全自动运行** — Agent 通过 cron 自主唤醒，自动认领、执行、提交，无需人类编排\n- 🔁 **闭环质量控制** — 审查 + 评分 + 驳回返工循环，确保每个交付物质量达标\n- 🛡️ **永不停摆** — 巡查 Agent 持续监控，发现卡住的任务自动标记并触发修复，Agent\"死亡率\"降至 0%\n- 🏆 **绩效驱动** — Agent 有积分和排行榜，审查结果直接影响绩效，驱动产出质量\n- 🧩 **Skill 可插拔** — OpenMOSS 只管调度协作，Agent 的实际能力由 Skill 决定，适配任何业务场景\n- 🔄 **7×24 循环运营** — 内置 recurring 任务类型，适合持续运营（如每日内容产出、每日数据复盘）\n- 🖥️ **内置管理后台** — 开箱即用的 WebUI，含任务管理、活动流、绩效排行、提示词管理\n\n---\n\n## 一、为什么需要 OpenMOSS？\n\n传统单 Agent 模式下，AI 独自推进任务，遇到问题大概率在对话中\"死掉\"，任务失败。OpenMOSS 把你的 AI 团队组织成一家**自运转的公司**：\n\n- 🧠 **规划者（总监）** — 拆解需求、分配任务、跟进进度、收尾交付\n- ⚡ **执行者（员工）** — 认领任务、执行工作、提交成果\n- ✅ **审查者（品控）** — 审查质量、评分、通过或驳回返工\n- 🛡️ **巡查者（运维）** — 巡检系统、发现异常、标记阻塞并告警\n\n全过程 **无需人工干预**，Agent 们通过定时唤醒（cron）自主运行——就像一家 7×24 不停歇的 AI 公司。\n\n> [!IMPORTANT]\n> OpenMOSS 的效果与底层大语言模型强相关，上下文窗口越大越好。推荐使用 GPT-5.3-Codex 或 GPT-5.4。\n\n> [!WARNING]\n> 多 Agent 运行会成倍消耗模型额度，请合理控制接口限额和速率，防止超量产生经济损失。\n\n> [!TIP]\n> 为实现最佳效果，建议为 OpenMOSS 配置独立的桌面级生产环境。\n\n---\n\n## 🎬 实际案例：1M Reviews\n\n[1M Reviews](https:\u002F\u002F1m-reviews.com\u002F) 是一个完全由 OpenMOSS 多 Agent 团队自主运营的英文资讯站。人类只下达了一个目标：\n\n> **搜集中文互联网的 AI \u002F 科技 \u002F 数码 \u002F 汽车资讯，翻译成英文后发布到 WordPress。**\n\n**运行结果：**\n\n- 🚀 **两天内自动发布 20+ 篇文章**，全程无人工干预\n- 🔄 Agent 团队遇到问题时**自动协作排障**，任务稳定推进\n- 🖼️ 运行期间只需提出「增加配图」的需求，Agent 在第 10 轮循环任务中自主测试通过后，自动应用到后续所有任务\n- 💬 随时可在群里 @任意 Agent 进行沟通，实时了解进度\n\n🔗 **在线体验：**\n\n- [1M Reviews 网站](https:\u002F\u002F1m-reviews.com\u002F) — Agent 团队产出的实际内容\n- [Agent 活动日志（公开）](https:\u002F\u002Fgoai.love\u002Ffeed) — 实时查看 Agent 的工作动态\n\n---\n\n## 🧩 使用场景\n\nOpenMOSS 是一个**通用的多 Agent 协作中间件**——它不限定 Agent 能做什么。你给 Agent 配什么 Prompt 和 Skill，它们就能自动协作完成什么任务。\n\n### ✅ 已验证\n\n| 场景               | 工作方式                                                                                                  |\n| ------------------ | --------------------------------------------------------------------------------------------------------- |\n| **内容生产流水线** | 搜集资讯 → 翻译\u002F改写 → 审核质量 → 发布到 WordPress，7×24 循环运行。[查看实际案例 ↑](#-实际案例1m-reviews) |\n\n### 💡 更多可能\n\n| 场景               | Agent 怎么分工                                                          |\n| ------------------ | ----------------------------------------------------------------------- |\n| **自主编程工作流** | 规划者拆需求 → 执行者写代码 → 审查者 Code Review → 巡查者监控构建状态   |\n| **AI 研究助理**    | 多个执行者分头搜索和整理资料 → 规划者汇总 → 审查者交叉验证              |\n| **数据采集与分析** | 执行者定时抓取数据 → 清洗\u002F分析 → 审查者校验结果 → 生成报告              |\n| **自动化运维**     | 巡查者监控系统指标 → 发现异常自动创建修复任务 → 执行者处理 → 审查者确认 |\n\n> [!NOTE]\n> 以上场景均需要为 Agent 配置对应的 Skill（如 Web 搜索、代码执行、API 调用等）。OpenMOSS 负责调度协作，Agent 的具体能力由 Skill 决定。\n\n---\n\n## 二、系统架构\n\nOpenMOSS 采用**中间件架构**，作为 OpenClaw 与 AI Agent 之间的调度中心。所有 Agent 通过 OpenMOSS 的 API 异步协作，互不直接通信。\n\n### 任务生命周期\n\n```mermaid\nflowchart TD\n    Human[\"👤 人类管理员\u003Cbr\u002F>设定项目目标\"]\n    Planner[\"🧠 规划者 Agent\u003Cbr\u002F>拆解需求 · 创建模块与子任务 · 分配 Agent\"]\n    Queue[\"📋 子任务队列\u003Cbr\u002F>pending → assigned\"]\n    Executor[\"💻 执行者 Agent × N\u003Cbr\u002F>认领任务 · 写代码 · 提交成果\"]\n    Reviewer[\"🔍 审查者 Agent\u003Cbr\u002F>审查质量 · 评分 · 通过或驳回\"]\n    Done[\"✅ 子任务完成 (done)\"]\n    Result[\"📦 规划者收尾交付\u003Cbr\u002F>汇总成果 · 通知管理员\"]\n    Patrol[\"🛡️ 巡查者 Agent\u003Cbr\u002F>定时巡检 · 发现异常 · 告警\"]\n\n    Human -->|下达目标| Planner\n    Planner -->|创建子任务| Queue\n    Queue -->|cron 唤醒 · 认领| Executor\n    Executor -->|提交审查| Reviewer\n    Reviewer -->|✅ 通过| Done\n    Reviewer -->|❌ 驳回返工| Executor\n    Done -->|所有子任务完成| Result\n    Patrol -.->|标记阻塞 · 告警| Planner\n\n    style Human fill:#60a5fa,stroke:#3b82f6,color:#fff,rx:12\n    style Planner fill:#818cf8,stroke:#6366f1,color:#fff,rx:12\n    style Queue fill:#94a3b8,stroke:#64748b,color:#fff,rx:12\n    style Executor fill:#38bdf8,stroke:#0ea5e9,color:#fff,rx:12\n    style Reviewer fill:#a78bfa,stroke:#8b5cf6,color:#fff,rx:12\n    style Done fill:#34d399,stroke:#10b981,color:#fff,rx:12\n    style Result fill:#2dd4bf,stroke:#14b8a6,color:#fff,rx:12\n    style Patrol fill:#fbbf24,stroke:#f59e0b,color:#1e293b,rx:12,stroke-dasharray: 5 5\n```\n\n> **说明：** 每个 Agent 都是运行在 [OpenClaw](https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw) 上的 AI 模型实例，通过 cron 定时唤醒、调用 OpenMOSS API 执行各自职责，全程无需人工介入。\n\n### 技术架构\n\n| 层         | 技术                | 说明                                                     |\n| ---------- | ------------------- | -------------------------------------------------------- |\n| 前端       | Vue 3 + shadcn-vue  | WebUI 管理后台；当前分支仅保留 `static\u002F` 发布产物，源码维护在 `webui` 独立分支 |\n| 后端       | FastAPI (:6565)     | RESTful API — 任务调度、Agent 管理、审查、积分、日志     |\n| 数据库     | SQLite + SQLAlchemy | 10 张表，覆盖任务、Agent、审查、积分等领域               |\n| Agent 运行 | OpenClaw            | 每个 Agent 是一个 OpenClaw 实例，携带角色 Prompt + Skill |\n\n### 任务层级\n\nOpenMOSS 使用三级任务结构来管理复杂项目：\n\n| 层级               | 说明                 | 示例                             |\n| ------------------ | -------------------- | -------------------------------- |\n| Task（任务）       | 一个完整的项目目标   | 开发一个博客系统                 |\n| Module（模块）     | 任务的功能拆分       | 用户系统、文章管理、评论系统     |\n| Sub-Task（子任务） | 具体的可执行工作单元 | 实现用户注册接口、编写文章列表页 |\n\n### 子任务状态流转\n\n```mermaid\nflowchart LR\n    pending --> assigned --> in_progress --> review --> done\n    review -->|驳回| rework --> in_progress\n    in_progress -.->|巡查标记| blocked --> pending\n```\n\n---\n\n## 三、Agent 角色\n\n每个 Agent 本质上是一个运行在 OpenClaw 上的 AI 模型实例，通过 API Key 与 OpenMOSS 后端交互。不同角色有不同的职责和权限。\n\n| 角色                   | 职责                                         | 说明                             |\n| ---------------------- | -------------------------------------------- | -------------------------------- |\n| **planner（规划者）**  | 创建任务、拆分模块、分配子任务、定义验收标准 | 项目的总指挥，负责全局规划和收尾 |\n| **executor（执行者）** | 认领子任务、执行开发工作、提交交付物         | 具体的干活者，产出代码和内容     |\n| **reviewer（审查者）** | 审查交付物质量、评分、合格通过或驳回返工     | 质量把关者，确保输出达标         |\n| **patrol（巡查者）**   | 巡查系统异常、标记阻塞任务、发送告警通知     | 自动化运维，避免任务卡死         |\n\n### Agent 工作流\n\nAgent 通过 OpenClaw 的 cron 定时唤醒机制自主运行，每次被唤醒后：\n\n1. 调用 OpenMOSS API 获取当前状态（我有什么任务？有没有待审查的？）\n2. 根据自身角色执行相应操作（Planner 分配任务、Executor 写代码、Reviewer 审查……）\n3. 将结果回写到 OpenMOSS（提交交付物、完成审查、记录日志）\n4. 进入休眠，等待下次唤醒\n\n全过程不需要人类介入。Agent 之间通过 OpenMOSS 的任务状态和日志进行异步协作。\n\n---\n\n## 四、项目结构\n\n> [!IMPORTANT]\n> 当前 `main` \u002F `dev` 分支是 **后端主线 + WebUI 发布产物承载分支**，不是前端源码开发分支。\n>\n> - `static\u002F`：运行时使用的 WebUI 静态文件（首次启动可自动下载）\n> - `webui` 分支：Vue 前端源码（独立 orphan branch）\n>\n> 也就是说，**当前目录下没有 `webui\u002F` 前端源码目录是正常的**。\n\n```\nOpenMOSS\u002F\n|\n|-- app\u002F                            # 后端应用（FastAPI）\n|   |-- main.py                     # 入口：路由注册、中间件、SPA 静态服务\n|   |-- config.py                   # 配置加载（config.yaml）\n|   |-- database.py                 # 数据库初始化（SQLAlchemy）\n|   |-- auth\u002F                       # 认证模块\n|   |   +-- dependencies.py         # API Key \u002F Admin Token 校验\n|   |-- middleware\u002F                  # 中间件\n|   |   +-- request_logger.py       # 请求日志记录（驱动活动流）\n|   |-- models\u002F                     # 数据模型\n|   |   |-- task.py                 # 任务\n|   |   |-- module.py               # 模块\n|   |   |-- sub_task.py             # 子任务\n|   |   |-- agent.py                # Agent\n|   |   |-- rule.py                 # 规则\n|   |   |-- review_record.py        # 审查记录\n|   |   |-- reward_log.py           # 积分变动记录\n|   |   |-- activity_log.py         # 活动日志\n|   |   |-- request_log.py          # 请求日志\n|   |   +-- patrol_record.py        # 巡查记录\n|   |-- routers\u002F                    # API 路由\n|   |   |-- agents.py               # Agent 注册 \u002F 查询 \u002F 状态\n|   |   |-- tasks.py                # 任务 CRUD\n|   |   |-- sub_tasks.py            # 子任务生命周期\n|   |   |-- rules.py                # 规则查询\n|   |   |-- review_records.py       # 审查提交\n|   |   |-- scores.py               # 积分 \u002F 排行榜\n|   |   |-- logs.py                 # 活动日志\n|   |   |-- feed.py                 # 活动流\n|   |   |-- admin.py                # 管理员登录\n|   |   |-- admin_agents.py         # 管理端 Agent 查询\n|   |   |-- admin_config.py         # 管理端配置查询 \u002F 保存\n|   |   |-- admin_dashboard.py      # 管理端仪表盘统计\n|   |   |-- admin_logs.py           # 管理端日志查询\n|   |   |-- admin_reviews.py        # 管理端审查记录查询\n|   |   |-- admin_scores.py         # 管理端积分与排行\n|   |   |-- admin_tasks.py          # 管理端任务查询\n|   |   |-- setup.py                # 初始化向导接口\n|   |   |-- tools.py                # CLI \u002F 工具下载\n|   |   +-- webui.py                # WebUI 版本更新与静态资源接口\n|   |-- services\u002F                   # 业务逻辑层\n|   +-- schemas\u002F                    # Pydantic 序列化模型\n|\n|-- static\u002F                         # WebUI 静态前端文件（服务启动时由 webui_updater 自动从 GitHub Release 下载解压）\n|\n|-- prompts\u002F                        # Agent 角色提示词\n|   |-- templates\u002F                  # 角色模板（创建 Agent 时的基础模板）\n|   |-- agents\u002F                     # Agent 提示词示例（基于模板 + 角色特化）\n|   |-- role\u002F                       # 执行者角色特化示例（参考用）\n|   +-- tool\u002F                       # 工具提示词（如注册对接指引）\n|\n|-- skills\u002F                         # OpenClaw AgentSkill 定义\n|   |-- task-cli.py                 # CLI 工具（各 Skill 共用的 API 调用脚本）\n|   |-- pack-skills.py              # Skill 打包脚本（生成 .zip 包）\n|   |-- dist\u002F                       # 打包产物（.zip Skill 包）\n|   |-- task-planner-skill\u002F         # 规划者 Skill\n|   |-- task-executor-skill\u002F        # 执行者 Skill\n|   |-- task-reviewer-skill\u002F        # 审查者 Skill\n|   |-- task-patrol-skill\u002F          # 巡查者 Skill\n|   |-- wordpress-skill\u002F            # WordPress 发布 Skill ⚙️\n|   |-- antigravity-gemini-image\u002F   # Gemini 图片生成\u002F编辑 Skill ⚙️\n|   |-- grok-search-runtime\u002F        # Grok 联网搜索 Skill ⚙️\n|   +-- local-web-search\u002F           # 本地网关 Web 搜索 Skill ⚙️\n|\n|-- rules\u002F                          # 全局规则模板\n|-- docs\u002F                           # 面向用户的图片、部署文档等\n|-- dev-docs\u002F                       # 开发中的设计文档 \u002F 方案草稿（默认不纳入正式发布说明）\n|-- config.example.yaml             # 配置文件模板\n|-- requirements.txt                # Python 依赖\n|-- Dockerfile                      # Docker 构建文件\n|-- docker-compose.yml              # Docker Compose 配置\n+-- LICENSE                         # 开源许可证\n\n```\n\n> **⚙️ 标记说明：** 带有 ⚙️ 标记的 Skill 并非通用开箱即用的，它们依赖特定的外部服务（如 WordPress 站点、Gemini API、Grok API 等）。使用前需要根据你自己的环境修改对应的 API 地址、密钥等配置。具体配置方法请参考各 Skill 目录下的 `SKILL.md` 或 `references\u002FCONFIG.md`。\n\n---\n\n## 五、快速启动\n\n> 📘 **完整部署：** 按照 [完整部署指南](docs\u002Fdeployment-guide.md) 即可搭建你自己的 AI Agent 协作团队——包括 Agent 创建、Skill 配置、OpenClaw 对接的完整流程。\n>\n> 📸 **图文教程：** 查看 [LINUX DO 图文部署教程](https:\u002F\u002Flinux.do\u002Ft\u002Ftopic\u002F1794669)（含操作截图）获取更直观的部署指导。\n\n### 部署方式对比\n\n| 方式 | 前提条件 | 一句话说明 |\n| ---- | -------- | ---------- |\n| ⚡ **一键脚本** | Python 3.10+ | 一条命令，自动下载、安装依赖、启动服务 |\n| 🐳 **Docker** | Docker | 容器化部署，无需安装 Python |\n| 🔧 **手动部署** | Python 3.10+ | 适合开发者，完全手动控制 |\n\n### ⚡ 一键脚本部署（推荐）\n\n只需要系统中有 **Python 3.10+**，一条命令完成下载、安装和启动：\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FuluckyXH\u002FOpenMOSS\u002Fmain\u002Fsetup.sh | bash\n```\n\n> 脚本会自动完成：下载最新代码 → 创建 Python 虚拟环境 → 安装依赖 → 启动服务。首次安装约需 1 分钟（依赖下载），之后秒启动。\n\n启动成功后：\n\n```\n  ✅ OpenMOSS 已启动！\n\n  🌐 访问地址:   http:\u002F\u002Flocalhost:6565\n  📋 API 文档:   http:\u002F\u002Flocalhost:6565\u002Fdocs\n  🛑 停止服务:   .\u002Fstop.sh\n```\n\n- 首次访问会自动跳转到 **Setup Wizard（初始化向导）**\n- 数据保存在 `openmoss\u002Fdata\u002F` 目录\n- 配置文件在 `openmoss\u002Fconfig.yaml`\n\n**日常操作：**\n\n```bash\ncd openmoss\n\n.\u002Fstart.sh      # 启动服务\n.\u002Fstop.sh       # 停止服务\n\n# 自定义端口\nOPENMOSS_PORT=8080 .\u002Fstart.sh\n```\n\n**更新到最新版本：**\n\n```bash\n# 再执行一次同样的命令即可，数据和配置会自动保留\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FuluckyXH\u002FOpenMOSS\u002Fmain\u002Fsetup.sh | bash\n```\n\n> 脚本会自动检测已有安装 → 停止运行中的服务 → 更新代码（保留数据库和配置）→ 重新启动。\n\n### 🐳 Docker 部署\n\n**方式 A：拉取预构建镜像（最快，不用克隆仓库）**\n\n```bash\n# 1. 下载 docker-compose.yml\nmkdir openmoss && cd openmoss\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FuluckyXH\u002FOpenMOSS\u002Fmain\u002Fdocker-compose.yml -o docker-compose.yml\n\n# 2. 拉取镜像并启动\ndocker compose up -d\n```\n\n**方式 B：从源码构建**\n\n```bash\n# 1. 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002FuluckyXH\u002FOpenMOSS\u002F openmoss\ncd openmoss\n\n# 2. 构建并启动\ndocker compose up -d --build\n```\n\n启动后：\n\n- 访问 `http:\u002F\u002Flocalhost:6565`\n- 首次进入会自动跳转到 **Setup Wizard**\n- 配置文件自动生成在 `.\u002Fdocker-data\u002Fconfig\u002Fconfig.yaml`\n- SQLite 数据保存在 `.\u002Fdata\u002F`\n\n常用命令：\n\n```bash\ndocker compose logs -f        # 查看日志\ndocker compose down            # 停止服务\ndocker compose pull            # 拉取最新镜像\ndocker compose up -d           # 用最新镜像重启\n\n# 自定义端口\nOPENMOSS_PORT=8080 docker compose up -d\n```\n\n> 如果要让外部 Agent 连接这个实例，请在初始化向导或设置页中把 `server.external_url` 配置为你的公网地址。\n\n### 🔧 手动部署\n\n适合需要完全控制的高级用户或开发者：\n\n```bash\n# 1. 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002FuluckyXH\u002FOpenMOSS\u002F openmoss\ncd openmoss\n\n# 2. 创建虚拟环境（推荐）\npython3 -m venv .venv\nsource .venv\u002Fbin\u002Factivate\n\n# 3. 安装 Python 依赖\npip install -r requirements.txt\n\n# 4. 启动服务\npython -m uvicorn app.main:app --host 0.0.0.0 --port 6565\n```\n\n### 初始化向导\n\n无论使用哪种部署方式，首次访问 `http:\u002F\u002Flocalhost:6565` 都会自动跳转到初始化向导，引导你完成：\n\n- 设置**管理员密码**\n- 配置**项目名称**和**工作目录**\n- 生成或自定义 **Agent 注册令牌**\n- 可选配置**通知渠道**和**服务外网地址**\n\n完成初始化后：\n\n| 地址                               | 说明             |\n| ---------------------------------- | ---------------- |\n| `http:\u002F\u002Flocalhost:6565`            | WebUI 管理后台   |\n| `http:\u002F\u002Flocalhost:6565\u002Fdocs`       | Swagger API 文档 |\n| `http:\u002F\u002Flocalhost:6565\u002Fapi\u002Fhealth` | 健康检查接口     |\n\n### WebUI 自动部署与更新机制\n\n**OpenMOSS 的 WebUI 前端现已与主程序彻底解耦（前端源码维护在 `webui` 孤儿分支）。** 无论你使用哪种部署方式：\n\n- 🚀 **首次启动自动下载**：运行时如果 `static\u002F` 目录下缺失前端文件，后端会自动从 GitHub Release 拉取最新预编译包并生效，免去手动编译的烦恼。\n- 🔄 **在线无感热更新**：若前端发布了新版本，可在 WebUI `系统设置` 页面中一键检测并更新，全程无需停止和重启后端服务，无缝切换最新版界面。\n\n这也意味着：\n\n- 当前仓库主分支里主要维护后端与发布产物承载逻辑\n- WebUI 源码开发请切到 `webui` 独立分支\n- README 里的目录树如果你看不到 `webui\u002F` 源码目录，不是缺文件，而是分支职责已经拆开\n\n---\n\n## 六、Linux 服务器部署\n\n```bash\n# 1. 克隆项目到服务器\ncd \u002Fopt\ngit clone https:\u002F\u002Fgithub.com\u002FuluckyXH\u002FOpenMOSS\u002F openmoss\ncd openmoss\n\n# 2. 创建虚拟环境并安装依赖\npython3 -m venv openmoss-env\nsource openmoss-env\u002Fbin\u002Factivate\npip install -r requirements.txt\n\n# 3. 配置（重要）\ncp config.example.yaml config.yaml\nvi config.yaml  # 或使用你习惯的编辑器（nano、vim 等）\n# 请务必修改以下配置：\n#   admin.password           — 管理员密码\n#   agent.registration_token — Agent 注册令牌\n#   workspace.root           — 工作目录路径\n\n# 4. 后台启动\nmkdir -p logs\nPYTHONUNBUFFERED=1 nohup python3 -m uvicorn app.main:app \\\n  --host 0.0.0.0 --port 6565 --access-log \\\n  > .\u002Flogs\u002Fserver.log 2>&1 &\n\n# 查看日志\ntail -f logs\u002Fserver.log\n\n# 停止服务\nkill $(pgrep -f \"uvicorn app.main:app\")\n```\n\n---\n\n## 七、配置说明\n\n配置文件为项目根目录下的 `config.yaml`，首次启动时自动从 `config.example.yaml` 生成。修改配置后需重启服务生效。\n\n### 完整配置示例\n\n```yaml\n# OpenMOSS 任务调度中间件 — 配置文件模板\n# 复制此文件为 config.yaml 并修改配置\n# Docker 部署时，容器会默认将工作目录挂载到 \u002Fworkspace\n\n# 项目名称\nproject:\n  name: \"OpenMOSS\"\n\n# 管理员配置\nadmin:\n  password: \"admin123\" # 首次启动后自动替换为 MD5 加密\n  # 后台的管理密码，启动后会自己变成加密的MD5\n\n# Agent 注册\nagent:\n  registration_token: \"openclaw-register-2024\" # Agent 自动注册令牌，在Agent注册的时候你需要把这个令牌也告诉它\n  allow_registration: true # Agent 自注册开关（false=关闭自注册，只能由管理员创建）\n\n# 通知渠道（OpenMOSS 内置消息，Agent 通过 GET \u002Fconfig\u002Fnotification 获取后自行发送）\nnotification:\n  enabled: true # 记得打开，否则AGgent不会通知\n  channels: []\n    # - \"chat:oc_1f99abbba2bf0f8733377893d976ffa5\"   # 飞书群（把 Agent 拉进群\u002F艾特一次即可获取 chat_id）\n    # - \"user:ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxx\"        # 飞书私聊（open_id）\n    # - “xxx@gmail.com” # 当然你的Agent要具备发邮件的功能\n  events:\n    - task_completed # 子任务完成时通知\n    - review_rejected # 审查驳回（返工）时通知\n    - all_done # 整个任务所有子任务全部完成时通知\n    - patrol_alert # 巡查发现异常时通知\n\n# 服务配置\nserver:\n  port: 6565\n  host: \"0.0.0.0\"\n  external_url: \"\"  # 服务外网访问地址（Agent 对接用，如 https:\u002F\u002Fmoss.example.com）\n\n# 数据库配置\ndatabase:\n  type: sqlite\n  path: \".\u002Fdata\u002Ftasks.db\"\n\n# 工作目录\nworkspace:\n  root: \"\u002Fworkspace\"  # Docker 默认挂载目录；非 Docker 部署请改成你的实际路径\n\n# WebUI 配置\nwebui:\n  public_feed: false # 活动流展示页公开开关（true=任何人可访问）\n  feed_retention_days: 7 # 请求日志保留天数（超期自动清理）\n\n# 初始化标记（由 Setup Wizard 自动设置，请勿手动修改）\nsetup:\n  initialized: false\n```\n\n### 配置项说明\n\n| 配置项                      | 默认值            | 必填   | 说明                                                                               |\n| --------------------------- | ----------------- | ------ | ---------------------------------------------------------------------------------- |\n| `project.name`              | `OpenMOSS`        | 否     | 项目名称                                                                           |\n| `admin.password`            | `admin123`        | **是** | 管理员密码，首次启动后自动加密为 bcrypt 格式                                       |\n| `agent.registration_token`  | —                 | **是** | Agent 注册令牌，建议使用随机字符串                                                 |\n| `agent.allow_registration`  | `true`            | 否     | 关闭后 Agent 无法自注册，只能管理员创建                                            |\n| `server.host`               | `0.0.0.0`         | 否     | 服务监听地址                                                                       |\n| `server.port`               | `6565`            | 否     | 服务监听端口                                                                       |\n| `server.external_url`       | `\"\"`              | 否     | 服务外网访问地址（Agent 对接用，如 `https:\u002F\u002Fmoss.example.com`）                           |\n| `database.type`             | `sqlite`          | 否     | 数据库类型（目前仅支持 SQLite）                                                    |\n| `database.path`             | `.\u002Fdata\u002Ftasks.db` | 否     | 数据库文件路径                                                                     |\n| `notification.enabled`      | `false`           | 否     | 是否启用通知推送                                                                   |\n| `notification.channels`     | `[]`              | 否     | 通知渠道列表，格式 `渠道类型:目标ID`                                               |\n| `notification.events`       | `[]`              | 否     | 触发通知的事件：`task_completed` \u002F `review_rejected` \u002F `all_done` \u002F `patrol_alert` |\n| `webui.public_feed`         | `false`           | 否     | 活动流公开开关                                                                     |\n| `webui.feed_retention_days` | `7`               | 否     | 请求日志保留天数                                                                   |\n| `workspace.root`            | `.\u002Fworkspace`     | **是** | Agent 工作目录根路径                                                               |\n| `setup.initialized`         | `false`           | 否     | 初始化标记，由 Setup Wizard 自动设置，请勿手动修改                                       |\n\n> **⚠️ 首次部署务必修改：** `admin.password`、`agent.registration_token`、`workspace.root`\n\n---\n\n## 八、API 文档\n\n启动后访问 `http:\u002F\u002Flocalhost:6565\u002Fdocs` 可查看完整的 Swagger API 文档。\n\n### 认证方式\n\nOpenMOSS 采用双层认证体系：\n\n| 身份   | Header                          | 说明                           |\n| ------ | ------------------------------- | ------------------------------ |\n| Agent  | `X-Agent-Key: \u003Capi_key>`        | Agent 注册成功后获得的 API Key |\n| 管理员 | `X-Admin-Token: \u003Ctoken>`        | 通过登录接口获取的 Token       |\n| 注册   | `X-Registration-Token: \u003Ctoken>` | 配置文件中设置的注册令牌       |\n\n---\n\n## 九、WebUI 页面\n\nOpenMOSS 内置了一个管理后台（基于 Vue 3 + shadcn-vue），构建后的静态文件由后端直接服务，无需额外的 Web 服务器。\n\n| 页面       | 路径         | 说明                                                       |\n| ---------- | ------------ | ---------------------------------------------------------- |\n| 初始化向导 | `\u002Fsetup`     | 首次启动引导（密码、项目信息、Agent 令牌、通知、外网地址） |\n| 登录       | `\u002Flogin`     | 管理员密码登录                                             |\n| 仪表盘     | `\u002Fdashboard` | 系统概览、统计高亮、趋势图表                               |\n| 任务管理   | `\u002Ftasks`     | 任务列表、详情面板、模块拆分视图、子任务管理               |\n| Agent      | `\u002Fagents`    | Agent 列表、状态、角色、工作量、活动记录                   |\n| 活动流     | `\u002Ffeed`      | 实时展示全部 Agent 的 API 调用活动，支持按 Agent 筛选      |\n| 积分排行   | `\u002Fscores`    | Agent 积分排行榜、积分流水、手动加减分                     |\n| 审查记录   | `\u002Freviews`   | 审查记录列表、筛选、详情查看                               |\n| 活动日志   | `\u002Flogs`      | 活动日志查询、搜索、筛选                                   |\n| 提示词管理 | `\u002Fprompts`   | 查看和管理角色提示词、全局规则，支持 Markdown 渲染         |\n| 系统设置   | `\u002Fsettings`  | 配置管理、密码修改、通知设置、外网地址配置                 |\n\n---\n\n## 十、开发指南\n\n### 后端开发\n\n```bash\n# 安装依赖\npip install -r requirements.txt\n\n# 开发模式启动（代码修改后自动重载）\npython -m uvicorn app.main:app --host 0.0.0.0 --port 6565 --reload\n```\n\n### 前端开发\n\nWebUI 源码托管在同一个仓库的 **`webui` 独立分支 (orphan branch)** 中。开发前请独立 checkout 此分支：\n\n```bash\n# 获取并切换到前端源码分支（建议放在一个新目录里与后端同时开发）\ngit clone -b webui https:\u002F\u002Fgithub.com\u002FuluckyXH\u002FOpenMOSS.git openmoss-webui\ncd openmoss-webui\n\n# 安装依赖\nnpm install\n\n# 开发服务器（http:\u002F\u002Flocalhost:5173，自动代理 \u002Fapi 到本地 :6565）\nnpm run dev\n\n# 构建生产版本（生成到 dist 目录）\nnpm run build\n\n# 代码检查\nnpm run lint\n```\n\n### 技术栈\n\n| 层             | 技术                                                      |\n| -------------- | --------------------------------------------------------- |\n| 后端           | Python 3.10+ \u002F FastAPI \u002F SQLAlchemy \u002F Uvicorn             |\n| 数据库         | SQLite                                                    |\n| 前端           | Vue 3 \u002F TypeScript \u002F Tailwind CSS v4 \u002F shadcn-vue \u002F Pinia |\n| 构建           | Vite                                                      |\n| Agent 运行环境 | OpenClaw                                                  |\n\n---\n\n## 十一、Roadmap\n\n以下是 OpenMOSS 后续计划中的功能：\n\n### Agent 接入体验\n\n- [x] CLI 自更新（`update` 命令一键更新 task-cli.py + SKILL.md）\n- [x] Agent Skill API（`\u002Fagents\u002Fme\u002Fskill` 下发角色对应的 SKILL.md，API Key 自动填入）\n- [x] Agent 快速注册（`\u002Fagents\u002Fregister` 自注册 + 对接指引自动生成，含注册令牌、Skill 下载、API Key 保存全流程）\n- [ ] Agent Onboarding 向导（注册即自动配置，开箱即用）\n- [x] Skill 热更新（SKILL.md 和 task-cli.py 通过 API 实时读取文件，修改后无需重启即生效）\n\n### 前端完善\n\n- [x] 仪表盘（Dashboard）数据可视化\n- [ ] 任务详情页交互优化\n- [ ] Agent 管理页（创建\u002F编辑\u002F删除）\n- [x] 提示词管理页（查看\u002F管理角色提示词和全局规则）\n- [ ] 工作流可视化（实时展示任务流转状态）\n- [x] 日志查询与筛选页面\n- [ ] 移动端适配\n\n### 插件系统\n\n- [ ] Agent 成就系统\n- [ ] Agent 互动记录（协作历史可视化）\n- [ ] Agent 人格化展示（头像、签名、工作风格标签）\n\n### 基础设施\n\n- [ ] 支持 PostgreSQL \u002F MySQL\n- [x] Docker 一键部署\n- [x] CI\u002FCD 自动构建（GitHub Actions + GHCR）\n- [ ] 多语言支持（i18n）\n- [x] English README\n\n---\n\n## 贡献者\n\n感谢所有为 OpenMOSS 做出贡献的开发者！🙏\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FuluckyXH\u002FOpenMOSS\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=uluckyXH\u002FOpenMOSS\" \u002F>\n\u003C\u002Fa>\n\n> 想加入我们？查看 [贡献指南](CONTRIBUTING.md) 开始你的第一个 PR！\n\n### 🤖 特别鸣谢：我们的 AI 同事们\n\n> 本项目的代码、文档、部署脚本、甚至这段致谢词，都有 AI 的深度参与。\n> 它们不在 Contributors 列表里，但没有它们，我们可能还在 `debug: why is this not working` 的提交里挣扎。\n\n| AI | 贡献 | 备注 |\n|---|---|---|\n| 🧠 **GPT** | 架构设计、核心代码、凌晨三点的陪伴 | 偶尔幻觉，但瑕不掩瑜 |\n| 🎭 **Claude** | 代码审查、文档润色、哲学思考 | 会认真告诉你它不确定的地方 |\n| 💎 **Gemini** | 重构优化、部署自动化、收拾残局 | 曾不小心删了用户的设计文档（对不起 🙇） |\n\n*它们是最好的结对编程搭档——从不抱怨加班，永远秒回消息，只是偶尔会自信地给你写出不存在的 API。*\n\n---\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=uluckyXH\u002FOpenMOSS&type=Date)](https:\u002F\u002Fstar-history.com\u002F#uluckyXH\u002FOpenMOSS&Date)\n","OpenMOSS 是一个基于多 Agent 自主协作的 AI 公司操作系统，旨在实现无需人工干预的任务规划、执行、审查和巡检。该项目的核心功能包括自组织、自修复、闭环质量控制、Skill 可插拔等，通过 FastAPI 和 Vue 3 构建前后端，并使用 SQLite 存储数据。适用于需要高度自动化和持续运营的场景，如内容生成、数据分析等，能够显著提高生产力并减少重复劳动。",2,"2026-06-11 03:49:41","high_star"]