1. 项目定位与用途
TenacitOS 是 OpenClaw 的官方 Mission Control Dashboard，定位为实时监控与控制中心。它作为统一界面，集中呈现 OpenClaw 实例的系统指标（CPU、内存、磁盘、网络）、所有 AI 代理的状态与活动、基于会话的成本分析、cron 作业管理、内存与文件浏览器、全局搜索以及 3D 办公室可视化。其核心用途是让用户无需切换工具即可全面掌握和控制 AI 代理的运行情况，提升运维效率。
项目档案应用项目
TenacitOS - OpenClaw AI 代理实时监控仪表盘 | 安装与使用指南
TenacitOS 是 OpenClaw 的 Mission Control Dashboard，提供系统监控、代理管理、成本跟踪、3D 办公室等功能。本页详细介绍项目定位、解决痛点、适用场景、安装步骤、使用方式及技术实现，助你在 VPS 上集中管理 AI 代理实例。
AI 总结
TenacitOS 是专为 OpenClaw AI 代理设计的实时监控仪表盘，直接读取工作区数据提供系统状态、代理管理、成本分析等功能，无需额外数据库，帮助用户集中运维 AI 实例。
中文项目介绍
TenacitOS 是 OpenClaw 的 Mission Control Dashboard，作为一个实时仪表盘与控制中心，集中展示 AI 代理实例的系统资源、活动日志、会话历史、成本消耗及文件内存等信息。它直接读取 OpenClaw 工作区目录下的配置与数据文件，无需额外数据库或后端服务，简化了多代理环境的监控与运维。项目基于 Next.js 16 与 React 19 构建，使用 Tailwind CSS v4 样式，集成 three.js 实现 3D 办公室可视化，并利用 better-sqlite3 在本地持久化活动与成本数据。适用场景包括在 VPS 或服务器上管理多个 OpenClaw 代理、跟踪 token 使用与真实成本、通过可视化界面操作工作区文件与内存，以及安排 cron 作业。
详细信息与使用说明
2. 解决的问题
该项目解决了 OpenClaw 用户在多代理场景下面临的监控碎片化问题。传统方式需手动查看日志、统计成本、检查资源，效率低下且易遗漏。TenacitOS 通过自动发现代理、实时读取工作区数据、提供可视化图表与交互操作，将分散的信息聚合于一处，实现系统健康度、代理活动、费用支出的一站式监控，并支持文件编辑与 cron 管理，显著降低运维复杂度。
3. 适用场景
主要适用于运行 OpenClaw 的 VPS 或服务器环境，特别是需要管理多个 AI 代理实例的用户。常见场景包括：监控代理在线状态与资源消耗；跟踪各代理的 token 使用量及对应成本；通过 3D 视图直观查看代理活跃度；直接浏览和编辑工作区文件及内存内容；安排和查看定时任务执行历史；以及通过只读终端安全执行状态命令。适合个人开发者或团队在生产环境中集中管理 AI 工作流。
4. 安装方式
安装需在已安装 OpenClaw 的同一主机上进行。步骤：1) 进入 OpenClaw 工作区目录（默认 /root/.openclaw/workspace），克隆仓库到 mission-control 子目录；2) 在 mission-control 目录运行 npm install 安装依赖；3) 复制 .env.example 为 .env.local，并必须设置强密码 ADMIN_PASSWORD 与随机密钥 AUTH_SECRET，可选配置 OPENCLAW_DIR 路径及品牌信息；4) 复制 data 目录下的示例 JSON 文件（如 cron-jobs.example.json）为实际配置文件。生产环境建议使用 PM2 或 systemd 管理进程，并配置 Caddy 等反向代理启用 HTTPS。
5. 使用方式
开发时运行 npm run dev 启动本地服务器，浏览器访问即可。生产环境需通过反向代理访问。首次使用需用 .env.local 中设置的密码登录仪表盘。登录后，各功能模块可通过侧边栏导航：系统监控页显示实时 VPS 指标；代理页列出所有代理及其会话与 token 用量；成本页展示每日开销趋势；cron 页提供可视化定时任务管理；活动源页显示日志与热力图；内存与文件浏览器支持搜索与编辑；Office 3D 页以 3D 办公室形式展示代理状态。API 端点如 /api/agents 和 /api/costs 供前端调用。
6. 补充说明或实现特点
技术栈采用 Next.js 16（App Router）、React 19、Tailwind CSS v4。架构上，后端 API 路由直接读取 OpenClaw 工作区文件系统（如 openclaw.json 和内存文件），不依赖独立业务数据库；部分持久化数据（活动、成本）通过 better-sqlite3 存储在本地 data 目录。认证采用密码验证配合基于 IP 的限流与锁定机制。前端可视化使用 recharts 绘制图表，@react-three/fiber 与 drei 构建 3D 场景，@monaco-editor/react 提供代码编辑。项目结构清晰，模块间通过 API 交互，整体设计轻量且与 OpenClaw 深度集成。
思维导图
TenacitOS 项目结构
前端应用
仪表盘页面
登录页面
全局样式与布局
API 路由
agents (代理列表与状态)
activities (活动日志)
costs (成本跟踪)
auth (登录认证)
browse (文件浏览)
memory (内存操作)
cron (定时任务)
system (系统指标)
组件库
ActivityFeed (活动源)
ActivityHeatmap (热力图)
AgentOrganigrama (代理结构)
CronJobCard (Cron 卡片)
charts (图表集合)
Breadcrumbs (面包屑)
ChangePasswordModal (改密弹窗)
数据与配置
data/ (示例数据文件)
.env.example (环境变量模板)
package.json (依赖与脚本)
next.config.mjs (Next.js 配置)
tsconfig.json (TypeScript 配置)
静态资源
public/ (图标、模型等)
docs/ (截图与文档)
scripts/ (辅助脚本)
常见问题
TenacitOS 是否需要额外数据库？
不需要。它直接读取 OpenClaw 工作区文件系统（openclaw.json、内存文件等），仅使用本地 SQLite 数据库（better-sqlite3）存储活动日志与成本数据，无额外后端依赖。
如何安装和配置 TenacitOS？
克隆仓库到 OpenClaw 工作区目录（如 /root/.openclaw/workspace/mission-control），运行 npm install 安装依赖；复制 .env.example 为 .env.local 并设置 ADMIN_PASSWORD 与 AUTH_SECRET；复制 data 目录下的示例 JSON 文件为实际配置文件。生产环境需配置反向代理与进程管理。
TenacitOS 支持哪些 OpenClaw 版本？
README 未明确指定版本兼容性，但代码证据显示它读取标准 OpenClaw 目录结构（openclaw.json 与 workspace），应兼容常规安装的 OpenClaw 实例。
生产环境如何部署 TenacitOS？
建议使用 PM2 或 systemd 管理 Node 进程，并配置 Caddy 等反向代理提供 HTTPS。具体可参考 README 中 Requirements 部分的建议。
如何登录 TenacitOS 仪表盘？
访问登录页面，使用 .env.local 中设置的 ADMIN_PASSWORD 提交。认证 API 包含 IP 限流与锁定机制，防止暴力破解。