mercury-agent

给AI装上权限锁和预算表，7x24小时稳定干活

mercury-agent 是一个基于 TypeScript 的智能体框架，核心特点是“灵魂驱动”和“权限加固”。它解决了 AI 助手在自主运行时面临的安全与资源控制问题，通过为工具调用设置严格的权限边界和 token 预算，防止智能体越权或消耗过多资源。项目支持 CLI 和 Telegram 双通道接入，可 24/7 不间断运行，适合需要长期后台任务的场景。其核心能力包括：多工具集成与权限管理、token 使用量实时监控、多会话管理，以及灵活的部署方式。开发者可通过配置自定义智能体的“灵魂”（即人格与行为模式），使其更贴合特定业务需求。项目处于成长阶段，社区活跃，但文档和生态尚在完善中。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3168

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队cosmicstack-labs

所属国家

官网地址https://mercuryagent.sh

GitHubhttps://github.com/cosmicstack-labs/mercury-agent

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-agent,ai-assistant,llm

GitHub 星标★ 3168

30天Star增速

HF 下载量

上线时间2026-04-20 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

macOS / Linux 或 Windows（可用官方一键安装脚本，无需 Node.js）
若走 npm 方式安装，需要 Node.js 20+
可用的 LLM Provider API Key（用于写入 ~/.mercury/.env）
磁盘可写目录 ~/.mercury/（运行时数据全部存放于此）

安装与启动步骤

1一键安装(macOS/Linux)

官方脚本会自动下载对应系统的最新独立二进制，无需预装 Node.js。
```
curl -fsSL https://mercuryagent.sh/install.sh | sh
```
2一键安装(Windows)

在 PowerShell 中执行，同样是下载独立二进制安装。
```
irm https://mercuryagent.sh/install.ps1 | iex
```
3填写配置与密钥

运行时数据都在 ~/.mercury/，不要把配置放在项目目录里；在 .env 填 API key，在 mercury.yaml 配 provider、channel 和 budget。
4启动 CLI 验证

README 建议本地直接用 mercury 命令测试运行，首次启动会读取 ~/.mercury/ 下的配置。
```
mercury
```
5安装社区技能

从 skills.mercuryagent.sh 注册表拉取技能，安装后下次启动即被智能体加载。也可先 search / browse / view 再安装。
```
mercury skills install ai-ml/prompt-engineering
```
6检查技能环境

用 doctor 检查技能安装根目录和注册表连通性，确认技能落盘位置正确。
```
mercury skills doctor
```
7从源码构建(可选)

二次开发流程：fork 仓库后安装依赖并编译，再本地用 mercury 测试，最后提 PR。
```
npm install
npm run build
```

关键配置

配置项	必填	说明	示例
`~/.mercury/mercury.yaml`	是	主配置：providers、channels、token budget	`~/.mercury/mercury.yaml`
`~/.mercury/.env`	是	存放 API keys 和 tokens，会与项目 .env 一起加载	`sk-xxxxxxxx`
`~/.mercury/permissions.yaml`	否	工具能力边界与审批规则，权限加固的核心配置	`~/.mercury/permissions.yaml`
`~/.mercury/soul/*.md`	否	智能体人格设定（soul、persona、taste、heartbeat）	`~/.mercury/soul/soul.md`
`MERCURY_SKILLS_REGISTRY`	否	换成自建技能注册表地址，等价于 --registry 参数	`https://skills.mercuryagent.sh`
`MERCURY_SKILLS_INSTALL_ROOT`	否	指定技能的备用安装路径，默认 ~/.mercury/skills/	`/your/path/skills`

如何确认成功

终端能执行 mercury 命令并进入交互；执行 mercury skills doctor 能正常输出安装根与注册表状态；Web 面板 http://127.0.0.1:6174/skills 可打开。

常见问题

Q：安装必须先装 Node.js 吗？

A：不需要。官方一键脚本会下载对应系统的独立二进制；只有走 npm 方式时才要求 Node.js 20+。

Q：社区技能安全吗？

A：技能由社区贡献且未经审计，官方明确建议安装前先执行 mercury skills view 审阅内容，再决定是否安装。

Q：安装的技能放在哪里？

A：默认落在 ~/.mercury/skills///SKILL.md，会被视作与内置技能完全一致，下次启动智能体即可加载。

Q：怎么改用自建技能注册表？

A：命令行加 --registry ，或设置环境变量 MERCURY_SKILLS_REGISTRY；输出可用 --json 让结果变为机器可读。

Q：能否从 Telegram 装技能？

A：可以，Telegram 端提供 /skills、/skills search 、/skills view 、/skills install ，其中安装为管理员专属。

注意事项

所有运行时数据都放在 ~/.mercury/，不会写进你的项目目录。
README 中 npm 安装命令被截断，npm 包名可参考徽章 @cosmicstack/mercury-agent，实际命令请以官网 mercuryagent.sh 为准。
技能安装前务必先 view 审阅：社区技能未经审计。
贡献代码流程：fork 仓库 → npm install → 修改 → npm run build 验证编译 → 本地用 mercury 测试 → 提 PR。

核心亮点

权限加固机制：每个工具调用都有明确权限边界，防止AI越权操作
token预算控制：实时监控和限制token消耗，避免成本失控
双通道接入：同时支持CLI和Telegram，方便远程管理和交互

不足之处

文档/社区待观察
项目较新，生态和插件丰富度可能不如成熟框架

适用场景

个人自动化助手：通过Telegram远程控制智能体执行日常任务
企业后台服务：在服务器上运行，处理定时任务或数据整理
AI安全实验：研究如何限制LLM工具调用的权限和资源

替代项目

AutoGPT、LangChain、Superagent

项目介绍

mercury-agent 是智能体领域的开源项目，由 cosmicstack-labs 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,168）位列前 30%，在智能体分类的 2,499 个项目里位列前 13%。

近 45 天，它的 GitHub 星标从 2,994 增加到 3,168，净增 174。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：个人自动化助手：通过Telegram远程控制智能体执行日常任务。同类可对比的替代方案包括 AutoGPT、LangChain、Superagent。

上一篇：BotSharp

下一篇：clawpanel