1. 项目定位与用途
AgentOS 是 SapienX 开发的人类控制层（Human Control Layer），基于 OpenClaw agent orchestration kernel 构建。它提供 mission-control 界面，使人类操作员能够从单一工作区协调 AI agents、项目和公司。该 Next.js 控制平面应用将实时 agent 状态转化为可视化的操作环境，支持规划、执行监督、工作区管理和任务调度，旨在成为 AI agent 系统之上缺失的操作层。
项目档案应用项目
SapienXai/AgentOS 是什么？用途、安装与使用指南
AgentOS 是 SapienX 开发的人类控制层，基于 OpenClaw 内核构建，提供 mission-control 界面使操作员从单一工作区协调 AI agents、项目与公司。本页涵盖项目定位、解决的问题、适用场景、安装使用方式及 Next.js 技术实现。
AI 总结
AgentOS 是基于 OpenClaw 构建的人类控制层，提供 mission-control 界面，使操作员能从单一工作区协调 AI agents、项目与公司，解决多 agent 系统的人类控制瓶颈问题。
中文项目介绍
AgentOS 是 SapienX 开发的人类控制层，基于 OpenClaw agent orchestration kernel 构建。它提供 mission-control 界面，使人类操作员能够从单一工作区协调 AI agents、项目和公司。
该软件解决随着 AI agents 运行成本降低而凸显的人类控制瓶颈问题。现有 agent 系统主要暴露运行时、会话和 CLI 原语，缺少人类操作层。AgentOS 提供统一监控 workspaces、agents、models、runtimes 和健康状态；将 missions 映射到真实项目文件夹；支持事后检查 runtime 输出和生成文件；为 agent 团队提供结构（presets、policies、memory、workspace scaffolds）；并为 "one-person company" 模式提供控制层而非仅编排引擎。
适用场景包括：人类操作员统一管理多个 AI agents；跨项目协调 agent 团队并映射 missions 到真实文件夹；检查 agent 执行历史、文件和对话记录；为个人或小团队构建结构化 agent 团队；在个人公司模式下作为人类控制层。
技术特征：采用 Next.js 16、React 19、TypeScript Strict，本地优先控制平面。架构上，Human Operator 通过 AgentOS 控制层与 OpenClaw 内核交互，进而驱动 LLMs 和工具。控制平面包含 UI（Sidebar/Canvas/Inspector/Command Bar/Planner）、API 路由、服务适配器、CLI 封装，以及文件系统集成。支持流式响应和状态快照同步。
详细信息与使用说明
2. 解决的问题
随着 AI agents 运行成本降低，系统瓶颈从原始编排转移到人类控制。现有 agent 系统主要暴露运行时、会话和 CLI 原语，缺少人类操作层。AgentOS 解决：统一查看 workspaces、agents、models、runtimes 和健康状态；将 missions 映射到真实项目文件夹而非临时聊天线程；事后检查 runtime 输出和生成文件；为 agent 团队提供结构（presets、policies、memory、workspace scaffolds）；为 "one-person company" 模式提供控制层而非仅编排引擎。
3. 适用场景
主要适用场景包括：人类操作员统一监控和管理多个 AI agents 及其工作状态；跨多个项目协调 agent 团队，将 missions 映射到真实项目文件夹；检查 agent 执行历史、生成的文件和对话记录；为个人或小团队构建结构化 agent 团队，包括预设、策略、记忆和工作区模板；在 "one-person company" 模式下，作为人类控制层而非仅编排引擎，协调公司级工作。
4. 安装方式
仓库中明确给出两种安装方式：全局安装打包启动器：先执行 pnpm add -g @sapienx/agentos 安装，然后运行 agentos start --open 启动，agentos doctor 进行健康检查。或从源码本地运行：克隆仓库后执行 pnpm install 安装依赖，然后 pnpm dev 启动开发服务器。注意：若 OpenClaw 未就绪，AgentOS 会进入明确引导或降级路径，不会假装控制平面存在。
5. 使用方式
启动后通过 Web 浏览器访问 mission-control 界面。使用侧边栏（Sidebar）导航和查看 workspaces、agents、runtimes 等拓扑结构；在画布（Canvas）上可视化和管理 agents、tasks、workspaces 节点及其连接；使用检查器面板（Inspector Panel）查看和编辑选中实体的详细信息；通过命令栏（Command Bar）快速执行操作和 dispatch missions；使用规划器（Planner）创建和部署任务计划。具体操作细节可参考界面组件，但仓库中未提供详细用户手册。
6. 补充说明与实现特点
采用 Next.js App Router 架构，前端页面通过 API 路由与后端 OpenClaw 内核通信。API 路由层作为服务适配器，封装对 OpenClaw CLI 与服务的调用，并使用 Zod 进行输入验证。支持流式响应（TransformStream）以实时反馈长时间运行操作（如计划部署）的进度。核心状态通过 getMissionControlSnapshot 从 OpenClaw 获取，实现前后端状态同步。技术栈包括 Next.js 16、React 19、TypeScript Strict、OpenClaw kernel 和 local-first control plane。仓库包含打包发布脚本（build:agentos-package、pack:agentos、publish:agentos），可将控制平面发布为独立 npm 包。但 Key Features 和 Highlights 的具体内容在提供的摘要中未详细给出，需查阅完整 README。
思维导图
AgentOS
Mission Control UI
Sidebar
Canvas
Inspector Panel
Command Bar
Planner
Agent Management
Agent CRUD
Capability Editor
Chat Drawer
Agent Nodes
Workspace Management
Workspace Wizard
File System Bindings
Channels
Workspace Nodes
Mission & Task Orchestration
Mission Submission
Plan Deployment
Task Nodes
Mission Connections
OpenClaw Integration
Service Adapter
Snapshot Normalization
CLI Wrapper
Capabilities Aggregation
Runtime & Model Management
Model Providers
Runtime Nodes
Model Picker
Provider Cards
Gateway Control
Gateway Status
Presence
Control Routes
Onboarding
Onboarding Flow
Model Addition
Workspace Blueprint Editor
常见问题
AgentOS 的核心定位是什么？
AgentOS 是 AI agent 系统之上的人类控制层（Human Control Layer），基于 OpenClaw orchestration kernel 构建，提供 mission-control 界面，使人类操作员能从单一工作区协调多个 agents、项目和公司，解决多 agent 系统的人类控制瓶颈问题。
如何安装和运行 AgentOS？
支持两种方式：全局安装打包启动器（pnpm add -g @sapienx/agentos，然后 agentos start --open）；或从源码本地运行（pnpm install 后 pnpm dev）。若 OpenClaw 未就绪，会进入引导或降级路径。
AgentOS 主要解决哪些问题？
解决随着 AI agents 成本降低而凸显的人类控制瓶颈：统一监控 workspaces/agents/models/runtimes；将 missions 映射到真实项目文件夹；事后检查 runtime 输出和文件；为 agent 团队提供结构（presets/policies/memory/scaffolds）；为 one-person company 模式提供控制层而非仅编排引擎。
使用 AgentOS 需要什么技术环境？
基于 Next.js 16、React 19 和 TypeScript Strict 构建，依赖 OpenClaw 作为 orchestration kernel。本地运行需安装 pnpm 和 Node.js，并通过 Web 浏览器访问界面。控制平面采用 local-first 设计，状态通过 OpenClaw 快照同步。
如何提交一个 mission 到 AgentOS？
通过前端界面或 API 端点 POST /api/mission 提交，可指定关联的 agent 和 workspace，并配置思考模式。mission 内容经验证后提交至 OpenClaw 内核执行，支持流式响应反馈进度。具体操作也可通过命令栏（Command Bar）快速 dispatch。