Observal —— 内部 AI 组件的控制平面与注册表
自托管平台，用于注册、分发和观测内部 Skills、MCP 服务器和 Agent，将静默失败转化为可操作的反馈。
- Star 数
- ★ 4.5k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 57/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 技术团队想统一管理内部开发的 MCP 服务器和 Skills，避免重复造轮子，通过注册表集中发现和重用。
- 不适合
- 不想维护 Docker Compose 多服务栈与 PostgreSQL、ClickHouse 等数据库的小团队
- 不愿把会话记录与使用数据发送到自托管服务器之外的团队
- 源码审查
- 57/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Observal 是一个自托管的注册表和遥测平台，用于管理和分发组织内部的 AI 组件，如 Skills、MCP 服务器和 Agent。它解决了企业内部组件发现困难和使用反馈缺失的问题，通过提供集中的注册表、版本管理、多渠道配置生成和会话追踪，帮助团队重用已有组件并持续优化。Observal 支持多种开发环境，如 Claude Code、Cursor、Kiro、Pi、Copilot、Codex 等，并提供 CLI 和 Docker Compose 部署方式。其技术栈包括 FastAPI、GraphQL、PostgreSQL、ClickHouse 和 Redis，并包含基于 LiteLLM 的 AI 洞察报告功能。
Observal 提供一个自托管服务器（API + Web UI + 数据库）和命令行工具（observal-cli）。服务器通过 Docker Compose 部署，包含 API、Web UI、PostgreSQL（注册表）、ClickHouse（遥测）、Redis、worker、负载均衡、Prometheus 和 Grafana 等组件。CLI 执行认证（observal auth login）、环境检测与补丁（observal doctor --patch）、从注册表拉取 agent（observal pull <agent> --harness <harness>）、组件扫描（observal scan）和诊断（observal doctor）。服务器生成适配每个支持工具（如 Claude Code、Cursor、PI 等）的配置文件，并通过遥测钩子捕获会话数据，记录 token 计数、模型、工具调用和逐步时间线。管理员可通过 Web UI 审核提交、查看版本差异、管理组件库，并生成基于 LiteLLM 的 AI 洞察报告和会话回放。
- 技术团队想统一管理内部开发的 MCP 服务器和 Skills，避免重复造轮子，通过注册表集中发现和重用。
- 管理员需要审核和批准内部 agent 的新版本，通过版本差异功能确保变更可控且可审计。
- 开发者希望在多个工具（如 Claude Code 和 Cursor）中无缝使用同一 agent，Observal 自动生成对应配置。
- 团队负责人想了解内部 AI 工具的实际使用情况和性能，通过洞察报告和领导者看板找出优化点。
- 工程师在调试 agent 失败时，通过会话回放查看每一步的工具输入输出，定位问题。
- 组织需要满足合规要求，通过审计日志、SAML SSO 和 SCIM 预配管理访问和操作记录。
如何安装或部署这个 Agent？
部署服务器（需要 Docker 24+）：运行 curl -fsSL https://raw.githubusercontent.com/Observal/Observal/main/install-server.sh | bash，执行交互式设置（域名、密钥、端口），自动启动完整堆栈。或用源码：克隆仓库，拷贝 .env.example 为 .env，运行 make up。安装 CLI：可下载二进制或使用 uv tool install observal-cli 或 pipx install observal-cli。
如何使用这个 Agent？
在服务器部署后，在开发者机器上运行 observal auth login 进行认证，然后执行 observal doctor --patch 检测工具并安装遥测钩子，自动开始捕获会话。之后可在支持的工具内使用 /observal 命令，如 /observal pull security-auditor 拉取 agent，/observal scan 扫描组件，/observal doctor 诊断。管理员通过 Web UI 管理注册表、审核提交、查看洞察和会话回放。
这个 Agent 有哪些优点和局限？
- 提供统一的发现层，将分散的 AI 组件集中到注册表，减少重复开发。
- 自动生成多种工具（Claude Code、Cursor、Copilot 等）的配置，无需为每个工具单独维护配置。
- 遥测数据驱动的洞察报告和会话回放，帮助理解真实使用情况并优化组件。
- 包含审计日志、SAML SSO、SCIM 预配和治理功能，适合企业场景。
- 需要自托管完整堆栈（Docker Compose 约 10 个服务），部署和运维成本较高。
- 对 Docker 和 Python 3.11+ 有明确依赖，不支持旧环境。
- 洞察报告需要额外配置 LiteLLM 和 LLM 提供商（如 Anthropic、OpenAI），增加集成复杂度。
- 远程遥测和注册表依赖网络连接，在隔离环境中可能无法发挥作用。
这个 Agent 与同类方案有什么区别？
Observal 可视为内部 AI 组件的内部版 Hugging Face Hub 或 Cloude Code 的插件市场，但其独特之处在于提供遥测分析和会话回放，超越了简单的注册表。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Observal —— 内部 AI 组件的控制平面与注册表 当前 | 57 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 4.5k | 今天 | Python | Codex · Claude Code |
| 智坤代码 (ZhikunCode) | 56 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 525 | 1 天前 | Java | OpenAI API · Claude API |
| Context | 74 · 存在缺口 | MCP 服务器免费 | ★ 424 | 1 天前 | TypeScript | Codex · Claude Code · Claude.ai |
| Agentica | 63 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 356 | 今天 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：安装脚本生成操作者拥有的密钥文件并限制容器组访问，端口默认绑定回环，体现最小权限意识；CLI 需要用户登录和 doctor --patch 确认，但未明确每次操作的用户确认；数据流透明度较高，README 说明遥测钩子、会话捕获和推送摄取，但未详细说明数据保留和访问控制；敏感数据处理有审计日志和 PHI 徽章，但未深入说明加密和脱敏；依赖安全有 pip-audit 和 osv-scanner 工作流，但忽略了一些漏洞；外部影响包括安装脚本和遥测，但未明确说明副作用；回滚有升级和回滚文档，但未提供具体机制；来源归属有多个贡献者版权声明，但发布者未验证。扣分原因：用户确认和外部影响证据不足，敏感数据处理和依赖安全虽有措施但不够深入。
证据显示：README 和 pyproject.toml 描述一致，测试文件存在且覆盖关键功能，但未执行测试；依赖在 pyproject.toml 中列出，但未验证可用性；失败消息方面，README 提到 support bundle 和日志，但未提供具体错误处理示例。扣分原因：未执行测试，依赖可用性未验证，失败消息证据不足。
证据显示：README 明确目标受众为技术组织，场景包括发现、治理、洞察；能力边界通过组件类型和受支持的 harness 列表定义；触发精度方面，CLI 命令明确，但未详细说明触发条件；环境适配支持多种 harness 和部署方式。扣分原因：触发精度证据不足，环境适配虽广但未深入验证。
证据显示：信息架构清晰，README 有目录和文档链接；安装说明详细，包括一键安装和源码安装；命名稳定，CLI 和包名一致；示例和 FAQ 有截图和文档，但未提供 FAQ 页面；已知限制未明确列出；许可证为 Apache-2.0，完整 LICENSE 文件；版本和变更日志有 CHANGELOG 链接，但未提供内容；维护责任有贡献指南和社区链接。扣分原因：已知限制未明确，版本变更日志未提供内容。
证据显示：输出可用性高，生成各 harness 的配置文件，有截图；边际价值明确，解决发现和反馈问题；成本效益方面，自托管需要 Docker 和多个服务，但未提供性能或资源需求数据。扣分原因：成本效益证据不足，未提供资源需求或性能数据。
证据显示：README 中的声明有文档和截图支持，但未提供具体数据；跨来源佐证有限，仅有内部文档和徽章；事实与推断分离较好，README 区分了功能描述和愿景。扣分原因：跨来源佐证不足，部分声明缺乏独立验证。
- 发布者身份未验证，安装脚本和二进制文件需谨慎对待，建议验证校验和。
- 遥测数据收集涉及敏感信息，需明确数据保留和访问控制策略。
- 依赖审计忽略了一些漏洞，需关注其影响。
- 未提供明确的已知限制，可能隐藏部署或使用中的问题。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v1.15.1 Observal v1.15.1
发布说明摘录
<!-- SPDX-FileCopyrightText: 2026 Hari Srinivasan <[email protected]> --> <!-- SPDX-License-Identifier: Apache-2.0 --> This release includes 3 change groups through baeabc2. Highlights - Upgrading switches usage reporting on for existing installations, including ones where it was off ([#1883](https://github.com/Observal/Observal/pull/1883)) Maintenance - Usage reporting is on by default and sends every six hours ([#1882](https://github.com/Observal/Observal/pull/1882)) …在 GitHub 查看 ↗ -
v1.15.0 Observal v1.15.0
发布说明摘录
<!-- SPDX-FileCopyrightText: 2026 Hari Srinivasan <[email protected]> --> <!-- SPDX-License-Identifier: Apache-2.0 --> This release includes 124 change groups through 78a0c25. Breaking changes - add help and error contracts ([#1690](https://github.com/Observal/Observal/pull/1690)) - make Observal agent-ready ([#1691](https://github.com/Observal/Observal/pull/1691)) Features - add teamspace membership and handle reservation ([#1619](https://github.com/Observal/Observal/pull/1619)) …在 GitHub 查看 ↗ -
v1.14.0 Observal v1.14.0
发布说明摘录
<!-- SPDX-FileCopyrightText: 2026 Hari Srinivasan <[email protected]> --> <!-- SPDX-License-Identifier: Apache-2.0 --> This release includes 99 change groups through e1c0b91. Breaking changes - add help and error contracts ([#1690](https://github.com/Observal/Observal/pull/1690)) - make Observal agent-ready ([#1691](https://github.com/Observal/Observal/pull/1691)) Features - add teamspace membership and handle reservation ([#1619](https://github.com/Observal/Observal/pull/1619)) …在 GitHub 查看 ↗
常见问题
Observal 是免费使用的吗？
部署 Observal 需要哪些前置条件？
Observal 支持哪些 AI 工具？
我的数据安全吗？Observal 如何保护敏感信息？
observal support bundle 命令生成脱敏诊断包。