nora

Nora 是一个开源、自托管的人工智能智能体运维平台，用于在用户自行控制的基础设施上运行自治智能体集群。它可以统一管理 OpenClaw、Hermes，或同时保留两者于同一运维界面。项目采用 Apache-2.0 许可证，代码托管在 GitHub。

用途： 多数团队在生产环境运行智能体后，最终都会围绕运行时重建同一套层：部署工作流、密钥、监控、日志、终端、模板以及独立的管理界面。Nora 的目标是让这套层无需随运行时对话的变化而反复重写。运维人员工作流位于 /app 下，平台级管理位于 /admin 下。

主要能力：

• 部署与运维运行时：将 OpenClaw 和 Hermes 智能体部署到 Docker 或 Kubernetes（两者均为 GA，提供官方 Helm chart），支持完整生命周期控制：部署、启动/停止、重启、重新部署以及版本历史。
• 迁移现有运行时：从上传的包中重建智能体，自托管平台管理员可使用特权本地 Docker Live Pull。
• 实时运维访问：流式日志、进入运行中容器的交互式终端、文件浏览器/编辑器，以及嵌入运维界面的 OpenClaw 网关和 Hermes 仪表板。
• 监控与告警：每个智能体的指标与成本、集群需关注汇总（出错、卡住、超预算、遥测停滞），以及用户自定义告警规则并投递到指定渠道。
• 预算与定时运行：每个智能体的大模型预算硬上限并支持自动暂停，以及智能体运行的周期性 cron 调度，含队列重试与清扫保护。
• 默认故障关闭的密钥管理：提供商密钥静态使用 AES-256-GCM 加密并同步到运行中的运行时；生产环境若无有效加密密钥则拒绝启动，除非运维人员刻意启用不安全的明文覆盖；SSH 主机密钥固定用于保护远程（BYOC）Docker 主机。
• 网络隔离：基于 Kubernetes NetworkPolicy 的基线入站隔离，管理员可管理 CIDR 允许规则，并提供实验性的 NemoClaw 加固沙箱用于不可信代码。
• Agent Hub：可安装、带版本的入门模板，帮助快速从零搭建可用智能体。
• 集成：69 项凭据/连接目录（源代码管理、聊天、云、可观测性、向量数据库、自动化）以及 17+ 大模型提供商。可执行行为来自运行时技能或 MCP 适配器；支持的按智能体 MCP 服务器需显式启用。
• 实验性 Proxmox LXC：将标准 OpenClaw 或预置 Hermes 镜像部署到非特权 LXC，并验证 API TLS 与固定 SSH。它并非虚拟机级隔离，生产使用前仍需真实硬件冒烟测试。
• 全面自动化：公共 REST API（OpenAPI 3.1）、@noraai/cli，以及面向 Claude Code、Gemini CLI、Claude Desktop 和 Cursor 的 @noraai/mcp-server。
• 工作区与 RBAC：多租户工作区、分级角色、平台管理界面、账户事件历史以及加密托管备份。

使用方式： 系统要求：macOS 12+、Linux 或 Windows 10+（WSL2），并安装 Docker Engine 与 Compose v2。安装程序会检查 Docker、Git 和 OpenSSL，并安装缺失项。 macOS / Linux / WSL2 安装命令以及 Windows PowerShell 安装命令、Kubernetes Helm 安装命令请参见官方文档。Windows 需要 PowerShell 7+，不支持默认的 Windows PowerShell 5.1，需在 pwsh 7 会话中执行。 安装程序会验证前置条件、生成或保留密钥、可选创建引导管理员、在默认端口被占用时选择空闲本地端口，并启动整套服务。完成后打开安装程序打印的 URL。本地模式默认 http://localhost:8080，但繁忙工作站上可能选择 8081 等其它端口。随后可跟随“前 15 分钟”演练。 若尚无 API 密钥：在启用本地 Docker 目标的安装中，可在“开始使用”页面选择“启动本地 Docker 演示”。Nora 会使用内置的确定性演示提供商部署一个可用智能体，无需任何密钥、无模型使用成本即可验证聊天与运维工作流。仅 Kubernetes 安装需先添加模型提供商并部署到启用的集群目标。 手动设置、环境变量、公共域模式、TLS、远程 Docker、Kubernetes、NemoClaw 以及实验性 Proxmox LXC 配置，请参阅自托管指南、环境变量参考、供应后端、远程 Docker BYOC 设置、TLS 与公共域、Cloudflare 前置部署等文档。完整文档位于 docs.norafleet.ai，MDX 源码在 docs/ 中。完整架构说明见 docs/concepts/architecture。

公共 REST API、CLI 与 MCP： 工作区范围的 API 密钥（仅 bearer、前缀 nora_、静态 HMAC 哈希、基于作用域）驱动 REST 表面的稳定子集。在 /app/workspaces/<id>/api-keys 签发密钥。 CLI 位于 cli/（@noraai/cli）：运行一次 nora login 保存主机与 API 令牌，随后 nora workspaces、nora agents、nora monitoring 封装同一 REST 表面。nora doctor 运行仅管理员可用的控制平面健康检查，nora mcp 启动 MCP stdio 服务器。支持的端点与作用域见 API 参考。 可从 Claude Code、Gemini CLI、Claude Desktop 或 Cursor 操作 Nora：mcp-server/ 包（@noraai/mcp-server）将同一 API 暴露为 Model Context Protocol 工具——部署智能体、控制其生命周期、读取集群指标、事件和每个智能体成本。除非显式选择加入，破坏性删除保持禁用。 Gemini CLI 用户可直接安装仓库扩展。安装程序会提示输入 Nora API URL，并将工作区 API 密钥存储为敏感扩展设置。关于 Gemini CLI、Claude Desktop 和 Cursor 的配置、工具列表和安全说明，请参阅 MCP 指南。

标准与隔离：

• MCP：已提供。控制平面 MCP 服务器（@noraai/mcp-server，已发布到官方 MCP Registry）以及按智能体的 MCP 服务器管理。
• OpenTelemetry GenAI：可用。按 gen_ai.* 语义约定导出 OTLP + Prometheus 运行时遥测——每次交互的聊天 span 以及 token/成本/资源指标流入现有 Grafana / Datadog / Langfuse 栈。按工具调用的子 span 依赖运行时事件流，仍在路线图中。
• A2A：路线图中。面向托管 OpenClaw 和 Hermes 智能体的 Agent Cards / 智能体到智能体发现。
• 按部署目标的隔离：标准 Docker 运行使用容器命名空间及运维设置的 CPU 和 RAM 限制；disk_gb 为元数据，运维人员需监控 Docker 存储。Kubernetes 增加工作负载资源限制和预置存储请求。实验性 NemoClaw 配置文件以非 root 用户、丢弃所有 Linux 能力、no-new-privileges、Landlock + seccomp 以及默认拒绝出站来加固不可信代码。实验性 Proxmox 放置使用非特权 LXC，仍属共享内核边界，未作为虚拟机级隔离呈现。

适用场景： 适合需要在自有基础设施上标准化运维 OpenClaw 和 Hermes 智能体集群的团队、平台管理员和自托管用户，涵盖部署、监控、预算、密钥、隔离与自动化等生产运维需求。

限制与路线图（部分）：

• NemoClaw 加固（高优先级）：将实验性安全沙箱配置文件端到端成熟化。
• Proxmox 硬件资格：在确切节点、存储、网桥、模板和网络上运行受保护 OpenClaw 与预置 Hermes 生命周期矩阵前，该目标仍为实验性。
• Hermes/OpenClaw 对等：弥合验证、日志、终端访问、监控和故障报告方面的运行时差距。
• 首次运行运维体验、账户级监控、认证与密钥同步加固、Agent Hub 人体工学、A2A 支持等仍在推进中。 项目包含贡献指南 CONTRIBUTING.md，CLAUDE.md 记录了仓库布局、开发命令和子树归属。贡献方向包括运行时适配器、运维与管理 UX、供应与生命周期编排、集成与渠道、测试与 CI 加固、自托管部署人体工学等。典型工作流：fork → 分支（feature/...）→ 提交 → 拉取请求。