Omnara

项目简介

Omnara 是用于生产环境运行 AI 智能体的开源托管式智能体平台。其 API 负责执行与状态管理，团队可选择模型、工具、机器以及用户与每个智能体的交互方式。它既可通过 Omnara Cloud 使用，也可自托管部署。

核心功能

• 持久化智能体把状态保存在持久事件日志中，可长期运行，空闲时不消耗计算资源。智能体可运行在托管沙箱中，也可接入自有的 Blaxel、Daytona 或 Unikraft Cloud 账户，或在笔记本电脑、虚拟机、容器上安装 Omnara daemon；daemon 采用出站连接。访问控制支持对高风险工具调用进行人工审批、以加密且限定范围的密钥保存凭据、为人员和 API 密钥提供基于角色的访问，并保留仅追加的审计历史。面向智能体的 API 包括 REST API、TypeScript SDK 和

适用场景

• 在产品仪表盘中嵌入智能体；为团队构建内部 Slack 智能体；运行代码审查、SRE 调查、浏览器操作和视频生成等专门工作流；提供交互式 CLI 体验。

快速开始

• 登录 Omnara Cloud；首个项目自带模型提供方 omnara-openrouter 和默认沙箱池 default-pool。将智能体配置保存为 agent.yaml，并用 Omnara CLI 启动；需要 Node.js 22 或更高版本。可在终端使用 npx omnara agents chat 加智能体 ID 与智能体对话，或在仪表盘中查看工具调用并回复。若以编程方式使用，创建 API 密钥并导出为 OMNARA_TOKEN，安装 @omnara/sdk，并使用 npx omnara config 输出的组织 ID 和项目 ID。

部署与要求

• 自托管需要 Docker 与 Compose。在克隆仓库后运行 docker compose -f compose.yaml --profile app up -d 启动 app profile。新的自托管实例尚无模型和机器；需要在控制台添加模型提供方和模型，在 Machines 下连接计算机，并将二者共享给项目。沙箱还要求该实例具备公共 URL。本地默认配置有意不安全，真实部署应遵循自托管和配置文档。

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。