LiveAgent 是什么:一句话定义
LiveAgent 是一个本地优先(local-first)的开源 AI Agent 桌面客户端,跑在 macOS、Windows 或 Linux 桌面上,把大模型推理与本地系统工具深度结合:AI 能真正读写你的文件、执行命令、管理定时任务,通过 MCP 与 Skills 生态扩展工具,再经可选部署的 Gateway 从任意浏览器远程控制本地 Agent。项目以 MIT 协议开源,技术栈为 Tauri 2 + React 19 + Rust + Go 1.25,GitHub star 约 2000(2026-09 查询为 2018)。它面向的场景很明确:让 AI 替你干真活——改代码、跑构建、做巡检、值守后台任务。
为什么本地优先在 Agent 场景里是硬需求
Agent 要动你的文件、跑你的命令、长期积累记忆,数据和执行环境天然应该留在自己的机器上——这一条决定了 LiveAgent 的整个架构走向。
拆开看是三层。其一是数据在本地:对话历史、持久记忆、文件操作对象全部落在本机,官方 README 的 FAQ 写得直接——API key 只存在桌面端本地,Gateway 是纯协议转发,不访问文件系统、不存储任何凭证。
其二是工具在本地执行。文件读写走本机文件系统,Bash 调的是你机器上已有的 Python、Node、Docker 等环境,没有网络往返,也不受云端沙箱的能力上限约束。
其三是桌面端完全独立可用。官方 README 的原话是桌面应用 fully standalone、不依赖任何服务器,Gateway 只在你需要浏览器远程访问时才部署。本地优先在 LiveAgent 这里是落进架构的设计。
四大能力板块:功能地图
按官方 README 的划分,LiveAgent 的核心能力分四大板块,各自对应 Agent 干活流程里的一个环节:动手、扩展、积累、远程。
| 板块 | 核心能力 | 在干活流程里的角色 |
|---|---|---|
| 本地工具执行 | 文件读写、Bash、进程监管、子代理、隧道 | 动手 |
| MCP 与 Skills | 桥接任意 stdio/http MCP 服务器,Skills 按需加载 | 扩展 |
| 记忆与自动化 | Markdown + SQLite FTS 记忆,bash/http/prompt 定时任务 | 积累与值守 |
| 远程 Gateway | Go 网关 + 浏览器 WebUI | 远程接入 |
本地工具执行是基本盘:文件系统完整能力 Read/Write/Edit/Delete,配合 Glob/Grep 做模式与正则搜索;Bash 非交互执行,可指定工作目录与超时;ManagedProcess 专职监管开发服务器这类常驻进程;子代理并行执行、TunnelManager 公网隧道各司其职。
MCP 与 Skills 是扩展面:Tauri 侧原生桥接任意 stdio/http MCP 服务器,外部工具无限接入;Skills 包按渐进式披露按需加载,支持安装、创建、打包,并接入 ClawHub 生态。
记忆与自动化管积累:持久记忆用 Markdown 加 SQLite FTS 全文检索;定时任务支持 bash/http/prompt 三种 cron 类型,在后台自动执行。远程 Gateway 管接入:Go 编写,走 WebSocket + Protobuf,浏览器 WebUI 远程控制本地 Agent,断线恢复靠有界 seq 窗口重放。
对话层还有几处容易被忽略的工程细节:多模型路由内置 Claude(Anthropic)、Codex(OpenAI)、Gemini 三种协议并支持自定义 Base URL,i18n 多语言框架内置(以上均出自官方 README)。
和纯聊天客户端差在哪:一张执行能力清单
纯聊天客户端产出的是文字,LiveAgent 产出的是已执行的动作——判断一个客户端算不算 Agent,就看它有没有下面这张清单里的东西。
| 能力 | README 描述的行为 | 对应的活 |
|---|---|---|
| Read / Write / Edit / Delete | 文件精确读写编辑删除 | 改代码、改配置、整理文件 |
| Glob / Grep | 模式与正则搜索 | 定位符号、批量找引用 |
| Bash | 非交互执行,支持 cwd 与 timeout | 构建、测试、脚本化操作 |
| ManagedProcess | 监管开发服务器等常驻进程 | 起本地服务并盯住它 |
| 子代理 | 并行执行,worktree 隔离 + 自动合并 | 多模块并行改造 |
| TunnelManager | 一键暴露本地服务到公网 | 演示、回调、远程联调 |
| 定时任务 | bash/http/prompt 三种 cron 类型 | 每日巡检、定时摘要 |
这张清单里真正拉开差距的是 ManagedProcess 和定时任务:前者让「跑一个 dev server 然后继续干别的」成为可能,后者让 Agent 在你关掉对话之后仍然值守。纯聊天客户端要做到这两件事,得靠你自己开终端拼命令。渲染与长会话也有兜底:流式 Markdown 内置 KaTeX、Mermaid 与 Monaco 预览,历史由 Segment + Summary Checkpoint 双层持久化(README)。
与 Claude Desktop、OpenHuman 的定位差异
三款产品都常被叫「桌面 AI 客户端」,路线差异很清晰:Claude Desktop 是 Anthropic 官方闭源客户端,OpenHuman 专注个人数据记忆,LiveAgent 走本地工具执行加开放生态。
| 维度 | Claude Desktop | OpenHuman | LiveAgent |
|---|---|---|---|
| 开源性 | 官方闭源客户端 | 开源,GPL3,Rust + Tauri | 开源,MIT,Tauri 2 + React 19 + Rust + Go |
| 模型接入 | Anthropic 官方模型 | 多模型自动路由 | Claude / Codex / Gemini 协议 + 自定义 Base URL |
| 侧重点 | 官方模型对话入口 | 个人数据记忆,每 20 分钟自动同步 | 本地工具执行 + MCP / Skills 生态 |
OpenHuman 的重心是「先让 AI 认识你」——本站的介绍篇写过它的本地记忆树与 20 分钟一次的自动同步,数据侧很强。LiveAgent 把重心放在工具执行与生态扩展上,记忆做的是跨会话知识管理。两者可以共存:一个当「第二大脑」,一个当「执行器」。
Claude Desktop 适合纯粹想用官方模型对话的用户;要让它操作本地系统,需要按 MCP 规范逐个配置工具,配置思路可以参考站内的 MCP 配置实践。LiveAgent 把 MCP 桥接做进 Tauri 侧,外加 Skills 生态,开箱即得的执行面更宽。
技术栈拆解:Tauri、React、Rust、Go 各管什么
四层技术栈各司其职,README 的架构图与技术栈表能一一对上。
| 层 | 技术 | 承担的职责 |
|---|---|---|
| 桌面壳 | Tauri 2 | 跨平台窗口、系统 WebView、Rust 后端宿主 |
| 前端 | React 19 + TypeScript(Vite 构建) | 对话界面与渲染:streamdown + KaTeX + Mermaid + Monaco |
| 桌面后端 | Rust + Tokio + SQLite(rusqlite) | 工具执行、MCP 桥接、记忆与 FTS、WebSocket |
| Gateway | Go 1.25,WebSocket + Protobuf + HTTP | 远程接入、会话管理、事件存储 |
工程上看这个分工是合理的。Tauri 2 复用操作系统自带的 WebView,安装包体积与内存占用天然低于自带 Chromium 的方案——这是 Tauri 路线的公开常识,也是近年桌面 AI 工具普遍转向 Tauri 的原因。Rust 后端管本地工具执行与持久化,进程边界清晰;Go 只在 Gateway 一侧出现,远程接入出问题也不影响桌面端独立干活。
适合谁用
- 想让 AI 干真活的开发者:改代码、跑构建、管进程、定时巡检,工具清单全部在本地
- 手里有多个模型渠道的人:Claude、Codex、Gemini 协议加自定义 Base URL,一个客户端全接进来
- 数据敏感的团队与个人:数据、记忆、API key 全在本机,Gateway 可自托管
- 多机与远程场景用户:部署 Gateway 后浏览器就是控制台
确定要装的话,直接看安装与 Gateway 部署教程;想深入扩展体系,看 MCP 与 Skills 实战。同类自托管路线还可以对照本站的 AgentDock——它面向服务器与容器场景做 MCP 运行时,与 LiveAgent 的桌面形态互补。
常见问题
LiveAgent 免费吗?
LiveAgent 按 MIT 协议开源,软件本身免费,源码可审计可修改,Gateway 镜像同样免费拉取。真实成本只有模型 API 用量:你在客户端里填自己的 Claude、Codex、Gemini 或第三方兼容服务密钥,按各服务商的计费付费,没有订阅费和抽成。
LiveAgent 和 ChatGPT 桌面版有什么区别?
ChatGPT 桌面版是对话入口,产出文字;LiveAgent 是 Agent 运行时,能读写文件、执行 Bash、监管常驻进程、跑定时任务,工具全部在本机执行,模型侧还支持三种协议加自定义 Base URL。
LiveAgent 支持哪些模型?
内置 Claude(Anthropic)、Codex(OpenAI)、Gemini 三种协议,并支持自定义 Base URL 接入任何协议兼容的第三方服务(官方 README)。中转站、企业网关、自建兼容端点填 URL 即用,无需改代码。