首页 / 开源热榜 / omnigent / 使用教程

Omnigent 教程：先守住凭据和 6767 端口

更新于 2026-09-23 · NGJOO AI 实验室 · 约 12 分钟

Omnigent 把 Claude Code、Codex、Cursor、OpenCode、Hermes、Pi 和自定义 agent 放进同一个会话层。终端、浏览器和手机可以接续同一会话，策略还能在风险动作前暂停审批。

最新公开 release 是 v0.14.0（2026-09-15）；main 的 pyproject 已进入 0.16.0.dev0。教程用 release 做基线，不能把 main 的新功能当作 v0.14 已交付。

1. 它多加了哪些服务

Python 服务端保存会话、agent 树、策略和凭据映射，CLI wrapper 启动具体 harness，Web UI 同步消息、终端和文件。默认本地界面在 localhost:6767；远程 host 可放在本机、VPS、Kubernetes 或 Modal、Daytona、E2B 等第三方 sandbox。

这套结构换来了跨设备协作，也扩大了权限面：模型 key、已有 CLI 登录态、项目目录、shell、Web 端口和云沙箱凭据可能同时出现。

2. 安装时不要省略脚本审查

curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh -o /tmp/install_oss.sh
sed -n '1,260p' /tmp/install_oss.sh
# 或固定已发布包
uv tool install 'omnigent==0.14.0'

Python 下限是 3.12。原生终端 wrapper 还需要 tmux；Linux 强制要求 bubblewrap，macOS 使用 seatbelt。Web UI 开发需要 Node.js 22+ 与 pnpm。

3. 第一次只开一个 harness

omnigent
# 或指定已有 CLI
omnigent codex
omnigent server status

首次运行会发现环境里的 ANTHROPIC_API_KEY、OPENAI_API_KEY 和已登录的 claude/codex CLI。共享服务器前先清掉无关凭据，只给测试 agent 一个工作目录和一套 provider。

Linux/macOS 的 OS sandbox 能限制文件和网络；Windows 原生模式只有 Job Object 进程树与资源控制，不隔离文件系统和网络。需要完整边界时改用 WSL 或 Linux。

4. 远程协作是第二阶段

手机通过局域网访问、Cloudflare tunnel 或公网部署都可能暴露会话、终端和文件。先检查监听地址、防火墙与认证；团队模式启用 OMNIGENT_AUTH_ENABLED=1，再配置 OIDC、域名 allowlist 或单次邀请。

项目自身没有充值或额度转售。模型和云 sandbox 使用用户已有账号，第三方费用仍需分别核对。

验证边界：本轮只核对官方 README、pyproject、部署文档、CHANGELOG 和 Releases。没有执行脚本、安装包、启动服务或 sandbox，也没有录入凭据；本文属于 docs-only。

5. 与 AutoGen 对比

Microsoft AutoGen提供 AgentChat/Core/Extensions 与 Studio，重点是用 Python/.NET 编写多代理应用。Omnigent 更偏操作层：把现成编码 harness 接到共享会话、终端和远程 host。

要设计新的代理逻辑先看 AutoGen；要统一操作多个现成编码 agent，再评估 Omnigent。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

适合谁用

适合需要统一管理多个编码 agent、跨设备接续会话或对工具调用增加审批策略的团队。只运行单一 agent、无需远程协作时，额外服务端、凭据映射和 sandbox provider 会增加维护面。

原教程未展开的系统信息

核心功能

跨设备会话
本地 CLI 启动服务器和 Web UI，消息、终端、文件与子代理状态可在浏览器和手机继续查看。

技术栈和运行条件

语言

Python 3.12+；Web UI 还需 Node.js 22+ 与 pnpm

框架

Starlette/Uvicorn 服务端、CLI 和多 harness adapter

关键依赖

uv
git
tmux（原生终端 wrapper）
Linux bubblewrap
模型 provider CLI 或 API key
可选云沙箱 provider 凭据

运行环境

本地 Web UI 默认 localhost:6767；部署可启用多用户认证、OIDC 和远程 host，云沙箱费用与权限由对应 provider 决定

官方与对比资料

以下链接用于核对版本、安装方式、功能边界和同类差异。

常见问题

Omnigent 的一键安装脚本可以直接管道执行吗？

官方给出 curl 管道安装，但脚本会安装工具并修改环境。更稳妥的做法是先下载和审查 install_oss.sh，或用 uv tool install omnigent 安装已发布包，并固定版本。

Omnigent 会自动读取现有模型凭据吗？

首次运行会发现环境里的 ANTHROPIC_API_KEY、OPENAI_API_KEY，或已登录的 claude/codex CLI，并让用户选择默认项。共享主机前应清理无关凭据，避免把个人账号带入团队会话。

Omnigent 在 Windows 上有完整沙箱吗？

没有。官方称 Windows 原生模式使用 Job Object 管理进程树和资源，但不提供 Linux bubblewrap 或 macOS seatbelt 那样的文件系统与网络隔离；需要这些边界时应使用 WSL、Linux 或 macOS。

把 Omnigent Web UI 给手机访问安全吗？

本地 UI 默认在 6767 端口；局域网访问、隧道或公网部署会暴露会话、终端和文件。远程使用前要启用认证，核对绑定地址、防火墙、OIDC 与单次邀请链接。

Omnigent 和 AutoGen 的用途一样吗？

不一样。AutoGen 更适合用框架 API 编写多代理应用；Omnigent 主要把现成编码 harness、共享会话、终端、策略和远程 host 放到一个操作层。