如何快速上手AI智能体mercury-agent：从一行命令安装到第一次对话的完整教程-平芜编程栈

如何快速上手AI智能体mercury-agent：从一行命令安装到第一次对话的完整教程

【免费下载链接】mercury-agentSoul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.项目地址: https://gitcode.com/gh_mirrors/me/mercury-agent

mercury-agent 是一款灵魂驱动（Soul-driven）的开源AI智能体，自带权限加固工具、Token 预算与 Second Brain 持久记忆，可在 CLI、Telegram 或 Web 端 7 天 24 小时运行。本文带你用一行命令完成 mercury-agent 安装，走完首次设置向导，并顺利开启你的第一次对话——全程不超过 10 分钟。

一、先认识 mercury-agent：为什么值得装一个

mercury-agent 与其他 AI 助手最大的不同：它先问再做，并且记得住。

🔐权限加固— Shell 黑名单拦截危险命令（如sudo、rm -rf /），文件夹级读写授权，每个操作先征求你的同意
🧠Second Brain 记忆— 基于 SQLite + 全文检索的持久记忆，自动从对话中提取你的偏好、目标和习惯
💰Token 预算— 每日额度管控，超 70% 自动切换精简模式
📱多渠道接入— 终端 TUI、Telegram、内置 Web 仪表盘，随时对话
⚙️31 个内置工具— 文件操作、Shell、Git、网页抓取、定时任务等开箱即用

项目入口在 src/index.ts，完整特性见 README.md，架构细节可阅读 ARCHITECTURE.md。

二、一行命令安装：最快的 mercury-agent 安装方法

安装分为两条路线，任选其一，都无需预先安装 Node.js（npm 路线除外）。

1. macOS / Linux：一行 curl 安装

curl -fsSL https://mercuryagent.sh/install.sh | sh

安装脚本会自动完成这些工作（源码见 scripts/install.sh）：

检测操作系统与 CPU 架构（Apple Silicon / Intel / x64 / arm64）
解析最新版本号，下载预编译二进制文件
用 SHA-256 校验和验证完整性
安装到~/.mercury/bin/mercury并自动更新PATH

2. Windows：一行 PowerShell 命令

irm https://mercuryagent.sh/install.ps1 | iex

3. 已有 Node.js 20+？用 npm 更简单

npm i -g @cosmicstack/mercury-agent mercury

也可以不安装直接试跑：

npx @cosmicstack/mercury-agent

💡 后续升级只需一条命令：mercury upgrade。

三、首次运行：跟随设置向导完成配置

安装完成后直接运行mercury，首次启动会进入设置向导，只需回答几类问题：

步骤	说明
你的名字	智能体用它来称呼你
智能体名字	默认 "Mercury"，可自定义
LLM 提供商	支持 DeepSeek（默认）、OpenAI、Anthropic、Grok、Ollama 等，可多选
模型选择	填入 API Key 后自动拉取可用模型列表供你挑选
Telegram Token	可选，用于手机远程接入

API Key 会经过格式校验，并实际请求模型列表验证——填错会要求重新输入，而不是盲目接受。所有配置统一存放在~/.mercury/目录下，不会污染你的项目目录。

以后想改配置，运行这条"医生"命令即可重新打开向导（按 Enter 保留原值，详见 website/docs/cli-commands/doctor.mdx）：

mercury doctor

四、启动 mercury-agent，开启第一次对话

前台交互模式（推荐新手）

mercury start --foreground

屏幕会打开 Ink TUI 启动界面，在开始聊天前会先让你选择权限模式：

Ask Me— 每次执行敏感操作前征求同意（新手推荐）
Allow All— 本会话全部放行（适合你信任的场景）

然后直接输入你的第一句话，比如：

帮我看看当前目录有哪些文件，再写一个 hello.py

Mercury 会先征求权限，再依次调用list_dir、create_file等工具完成，全过程实时流式输出。退出按Ctrl+C。

后台守护模式：一条命令常驻

mercury up

这条推荐命令会自动安装系统服务（如未安装）、启动后台守护进程并确保其运行。崩溃时按指数退避自动重启，开机自启，日志写入~/.mercury/daemon.log。常用管理命令一览（完整清单见 website/docs/getting-started/starting.mdx）：

mercury status # 查看配置与守护进程状态 mercury logs # 查看最近日志 mercury restart # 重启后台进程 mercury stop # 停止后台进程

五、给对话配大脑：模型提供商与自动故障转移

Mercury 支持配置多个 LLM 提供商，按顺序尝试、失败自动切换，并记住上次成功的提供商，从它开始下一次的请求。

提供商	默认模型	所需 API Key
DeepSeek	deepseek-chat	`DEEPSEEK_API_KEY`
OpenAI	gpt-4o-mini	`OPENAI_API_KEY`
Anthropic	claude-sonnet-4	`ANTHROPIC_API_KEY`
Grok (xAI)	grok-4	`GROK_API_KEY`
Ollama Local	gpt-oss:20b	无需 Key（本地实例）

对话中随时可以用/models查看当前会话模型、/models use <provider>切换模型。提供商实现位于 src/providers/，自动故障转移机制说明见 website/docs/reference/provider-fallback.mdx。

六、第一次对话后，记住这几个聊天内命令

以下命令在对话中直接输入即可，不消耗 API Token（完整列表见 website/docs/cli-commands/in-chat-commands.mdx）：

命令	用途
`/status`	查看智能体配置、预算与用量
`/help`	显示完整手册
`/permissions`	切换权限模式（Ask Me / Allow All）
`/budget`	查看 Token 预算状态
`/tools`	列出当前加载的全部工具
`/memory`	查看和管理 Second Brain 记忆

终端里输入/还会弹出命令自动补全菜单，方向键 + Enter 即可选择，新手不容易记错命令。

七、进阶：接入 Telegram，让 AI 智能体随身可用

如果你希望在手机上也能指挥它，只需在设置向导里填入 Telegram Bot Token，然后完成配对：

在 Telegram 中给机器人发送/start
复制收到的配对码
在终端执行mercury telegram approve <配对码>，你即成为首位管理员

之后 Mercury 以 1:1 私聊为主界面，支持流式消息、文件上传与多用户审批（管理员/成员角色）。频道实现位于 src/channels/telegram.ts。

八、可选：打开 Web 仪表盘

Mercury 内置了 React 单页 Web 界面，包含聊天（SSE 流式）、看板、Second Brain 可视化与 Workspace IDE。在~/.mercury/mercury.yaml中开启：

web: enabled: true port: 6174

浏览器访问http://127.0.0.1:6174即可（默认账号mercury/Mercury@123，仅绑定本机回环地址）。前端源码位于 ui/src/pages/，服务端 API 在 src/web/api/。

九、越聊越懂你：Second Brain 记忆机制

每次对话结束后，Mercury 会自动提取 0–3 条事实（带置信度、重要性评分）存入本地 SQLite 数据库；下一次发消息前，最相关的记忆会被注入上下文。支持身份、偏好、目标、习惯等 10 种记忆类型，并具备冲突消解与自动整合。全部数据保存在本机~/.mercury/memory/second-brain/，不上传任何云端。

十、总结：你的 mercury-agent 上手路线图

步骤	命令	达成效果
① 安装	`curl -fsSL https://mercuryagent.sh/install.sh \\| sh`	一行装好，免 Node 环境
② 设置	`mercury`（首次运行）	完成向导，配好模型
③ 对话	`mercury start --foreground`	第一次终端对话
④ 常驻	`mercury up`	开机自启、崩溃自恢复
⑤ 手机	`mercury telegram approve <码>`	随时随地接入