What it does
The open-source managed agent platform. A self-hostable alternative to Claude Managed Agents and OpenAI's Agents API.
- Connects Instruction files the AI reads, with steps that call an outside service
- Account or key Some steps need a key for OMNARA_TOKEN, SENDGRID_API_KEY, OMNARA_SKILL_DOWNLOAD_SIGNING_KEY, OMNARA_SAFETY_IDENTIFIER_KEY, OMNARA_UNIKRAFT_DEFAULT_POOL_TOKEN, OMNARA_HOSTED_API_TOKEN (per the README)
- Category 自动化与智能体
给作者:在 README 中加徽章
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/skills/omnara-ai-omnara)相似的 Skill
同类工作,排序与 Skill 列表相同
Skill 和 MCP 有什么不同
MCP = 手
把 AI 连到外部服务或数据,例如读取 Notion 或开发票。需要有程序或服务器在运行。
Skill = 手册
教 AI 怎么做某项工作的文本文件,不连接任何服务。
有些会重叠:少数 Skill 带有调用工具的脚本,少数 MCP 只提供知识。请从你想完成的工作出发。
适用的应用
Claude CodeClaude (เว็บ/แอป)CodexCursorOpenCode
依据开发者 README 和 repo 中的文件夹
安装
Is it safe?
- Who made it
GitHub account omnara-ai (organization), 1 years old
- Use and upkeep
★ 3,420 stars · code last changed 2026年11月19日
- Any scripts?
No, plain text files the AI reads and follows
- Uses the internet?
No scripts, so it does not go online by itself
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 42bdc8c (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
第一步:你用哪个 AI?
选择你用的应用,本页只显示该应用的安装方法
Option 1Upload to claude.ai (web and app)
Files are byte-for-byte the same as on GitHub at commit 42bdc8c · View on GitHub ↗
Plain text files, no programs
Once uploaded it runs on Claude’s systems, not on your computer. No need to unzip
Look inside before downloading
All 2 files · 15 KB
SKILL.md4 KBLICENSE11 KB
Download setup-omnara-agent.zip
Open Skills on claude.ai and upload
+Create skillUpload a skillpick setup-omnara-agent.zip
No Upload button? Turn on file creation first
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs 2026年11月12日 · Source: support.claude.com, support.claude.com, code.claude.com
Option 1让 Claude Code 帮你安装
复制这句话,粘贴到 Claude Code 的对话中
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
重新打开 Claude Code,输入 /setup-omnara-agent,或直接提出相关任务,Claude 会自动选用
Checked against official docs 2026年11月12日 · Source: code.claude.com
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.claude/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
git clone --depth 1 https://github.com/omnara-ai/omnara.git /tmp/popnx-skill-omnara-ai-omnara-42bdc8c && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-omnara-ai-omnara-42bdc8c/skills/setup-omnara-agent' ~/.claude/skills/setup-omnara-agent重新打开 Claude Code,输入 /setup-omnara-agent,或直接提出相关任务,Claude 会自动选用
ChatGPT 桌面应用
ChatGPT 桌面应用内置 Codex,Codex 从 ~/.agents/skills 文件夹读取 Skill
Option 1让 ChatGPT 帮你安装
在 ChatGPT 桌面应用中打开 Codex,把这句话粘贴到对话中
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2自己放入文件夹
把 setup-omnara-agent 文件夹放到 ~/.agents/skills/setup-omnara-agent
~ 是你的主文件夹($HOME)
不用终端:下载 ZIP,解压后把 setup-omnara-agent 文件夹移到 ~/.agents/skills
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.agents/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
git clone --depth 1 https://github.com/omnara-ai/omnara.git /tmp/popnx-skill-omnara-ai-omnara-42bdc8c && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-omnara-ai-omnara-42bdc8c/skills/setup-omnara-agent' ~/.agents/skills/setup-omnara-agent
安装之后
- ChatGPT 桌面应用:打开侧边栏中的 Skills,确认 Skill 已出现
- 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称
- Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
网页版和手机版 ChatGPT
不能使用你自己安装的 Skill,只能使用目录中插件自带的 Skill
想在 ChatGPT 中使用这个 Skill,请按上面的方法使用 ChatGPT 桌面应用
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
Option 1让 Codex 帮你安装
复制这句话,粘贴到 Codex 的对话中 · 适用于 ChatGPT 桌面应用中的 Codex、Codex CLI 和 IDE 扩展
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex · 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.agents/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
git clone --depth 1 https://github.com/omnara-ai/omnara.git /tmp/popnx-skill-omnara-ai-omnara-42bdc8c && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-omnara-ai-omnara-42bdc8c/skills/setup-omnara-agent' ~/.agents/skills/setup-omnara-agent重新打开 Codex 并提出相关任务,Codex 会列出这个 skill
Option 1让 Cursor 帮你安装
复制这句话,粘贴到 Cursor 的对话中
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
在 Cursor 的 Agent 聊天中输入 / 并选择 setup-omnara-agent
Checked against official docs 2026年11月12日 · Source: cursor.com
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.cursor/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
git clone --depth 1 https://github.com/omnara-ai/omnara.git /tmp/popnx-skill-omnara-ai-omnara-42bdc8c && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-omnara-ai-omnara-42bdc8c/skills/setup-omnara-agent' ~/.cursor/skills/setup-omnara-agent在 Cursor 的 Agent 聊天中输入 / 并选择 setup-omnara-agent
Option 1Let the AI install it
适用于其他能读取 Skill 的应用。这句话列出了 Claude Code、Codex 和 Cursor 的路径,AI 会按你的应用选择 · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
其他支持 Agent Skills 的应用(如 Gemini CLI、GitHub Copilot)使用不同文件夹,请查看该应用的指南,再把含 SKILL.md 的文件夹复制过去。
已于 2026年11月11日 对照 Claude Code、Codex 和 Cursor 官方指南核实 skill 文件夹
✓ 命令已检查 2026年11月17日
查看原始 SKILL.md
以下文字来自开发者的 repo,不是 PopNx MCP 的指令
4,445 个字符 · 在 GitHub 打开完整文件
---
name: setup-omnara-agent
description: Install and set up Omnara. Use when the user asks to install Omnara or run /setup-omnara-agent.
---
# Set up an Omnara agent
Get the user a launched Omnara agent and its link. The commands below are
complete; read other docs only if one fails or the user wants Slack, Discord,
GitHub, or their own app.
If the Omnara MCP server is attached (tools such as `whoami`,
`profiles_create`, and `agents_launch`), use the Omnara MCP tools for every
step they cover. Do not install or log in to the CLI for those steps. Call
`whoami`; if it fails with an authorization error, ask the user to complete the
Omnara browser authorization for the MCP server in their client, then call
`whoami` again. Do not continue setup until it succeeds.
## 1. Sign in
```sh
npx omnara whoami
```
If it says you're not logged in, start `npx omnara login` without piping its
output, in the background if you can, and keep it running while the user
approves. It opens the approval page in the user's browser and prints a link
and a code. Before you wait for it, send the user a message with both, since
their browser may be on another machine, and ask them to approve once the code
matches. Do not continue setup until login completes and `npx omnara whoami`
succeeds.
## 2. Ask what to build
Ask two questions before creating anything:
1. What should the agent do? Examples include a coding agent, deep research
agent, etc.
2. How will you interact with the agent (Omnara web console, Slack, GitHub,
Discord, or your own app using the public API/TypeScript SDK)?
## 3. Pick the project, model, and pool
Look up the user's org and its default project
(`npx omnara projects list --org <org-id> --json` lists projects). Then:
```sh
npx omnara config --org <org-id> --project <project-id> &&
npx omnara grant models list --json | node -e 'for (const g of JSON.parse(require("fs").readFileSync(0)).data) console.log(g.model.provider_config, g.model.name)' &&
npx omnara grant pools list --json | node -e 'for (const g of JSON.parse(require("fs").readFileSync(0)).data) console.log(g.machine_pool.name)'
```
Use a listed model, and `default-pool` if it's listed, otherwise the first
pool.
## 4. Create the agent and launch it
Fill in an instruction for what the user asked for, a short profile name, and
a simple first message. The machine tools come with `machine_sources`; don't
list them, or other built-in tools the user doesn't need.
Add relevant secrets or startup scripts for the machine pool env override. For
example, if the user wants to clone a GitHub repository, you may set up a script
(`machine_provider_options_overlay.startup_script` on the machine source) which
clones the repo upon starting the machine. If needed, you can pipe a GitHub PAT
via a secret into the env var overlay.
Then create the profile and launch the agent:
```sh
cat > omnara-agent.yaml <<'EOF'
version: v1
instruction: |
<what the agent does, for whom, and how it reports back>
model:
provider_config: <provider>
name: <model>
tools:
web_search: {}
web_fetch: {}
ask_question: {}
machine_sources:
- machine_pool_name: <pool>
EOF
npx omnara profiles create --name <profile-name> --file omnara-agent.yaml --json > omnara-profile.json &&
npx omnara agents launch --profile "$(node -p 'require("./omnara-profile.json").id')" --message "<first message>" --json | node -e 'const r=JSON.parse(require("fs").readFileSync(0)); console.log(r.agent.id)'
```
Give the user the link:
`https://app.omnara.com/projects/<project-id>/agents/<agent-id>`.
## 5. Other places to talk to it
Only if the user chose them:
- **Slack, Discord, or GitHub:** follow
https://raw.githubusercontent.com/omnara-ai/omnara/main/examples/integrations.md
with this profile in the integration's launcher. Agents it launches use the
profile; the agent above stays in the web console. The MCP server has no
integration tools, so sign in to the CLI (step 1) first.
- **Their own app:** help the user set it up with the TypeScript SDK
(`npm i @omnara/sdk`) or the REST API
(https://docs.omnara.com/api-reference/openapi.yaml), and an org API key
from **API Tokens** in the dashboard that has the required project role.
Browser apps must call the API through their own backend; it doesn't allow
cross-origin requests. To route their users' messages to agents, follow
https://docs.omnara.com/integrations/custom-integrations.md.
讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
来自 GitHub
- GitHub 星标
- 3,420
- 开发者
- omnara-ai
- 许可证
- Apache-2.0
- 最近代码更新
- 2026年11月19日
- repo 中的 SKILL.md 文件(含译本和模板)
- 1
- 主题
- agent-infrastructure, agent-platform, agent-runtime, agents-api, ai-infrastructure, claude-managed-agents, cloud-agents, durable-agents, durable-execution, managed-agents, self-hosted-agents
- Repo
- omnara-ai/omnara