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 定时任务积累与值守
远程 GatewayGo 网关 + 浏览器 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 DesktopOpenHumanLiveAgent
开源性官方闭源客户端开源,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
GatewayGo 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 即用,无需改代码。