LiveAgent：本地优先 AI Agent 桌面客户端

项目简介

LiveAgent 是一款本地优先（local-first）的 AI Agent 桌面客户端，把大模型推理和本机系统工具结合，让 AI 真的能操作文件系统、执行命令、管理定时任务。桌面端可独立运行，不依赖服务器；如果需要从浏览器远程控制，可以另外部署 Gateway。

技术栈为 Tauri 2 + React 19 + Rust，网关部分使用 Go，采用 MIT 许可证。

主要功能

多模型与对话

• 支持 Claude（Anthropic）、Codex（OpenAI）、Gemini 三种协议，可自定义 Base URL 接入第三方兼容服务
• 流式 Markdown 渲染，内置 KaTeX 数学公式、Mermaid 图表与 Monaco 代码预览
• Segment + Summary Checkpoint 双层历史压缩，长对话不丢上下文
• 内置 i18n 多语言框架

本地工具执行

• 文件系统能力：Read / Write / Edit / Delete，以及 Glob / Grep 的路径与正则搜索
• Bash 与常驻进程：非交互式命令执行（可设 cwd / timeout），ManagedProcess 托管 dev server 等常驻任务
• 子 Agent 并行执行，支持 worktree 隔离与自动合并
• TunnelManager 一键把本地服务暴露到公网

MCP 与 Skills 生态

• Tauri 侧原生桥接任意 stdio / http MCP server，工具可无限扩展
• Skills 包渐进式披露、按需加载，支持安装、创建、打包，并有 ClawHub 生态

记忆与自动化

• Markdown + SQLite FTS 全文检索的持久化记忆，跨会话管理知识
• 定时任务支持 bash / http / prompt 三种 cron 类型，后台自动执行

远程 Gateway

• Go 网关（WebSocket + Protobuf）自带 WebUI，可从任意浏览器远程控制本地 Agent
• 断线恢复时用有界 seq 窗口回放短时中断，桌面端持久化作为兜底

安装与使用

安装包由 GitHub Actions 自动构建、签名并发布，从 GitHub Releases 下载最新版本。

macOS：按芯片下载 DMG，拖入「应用程序」即可（已签名公证，首次启动无需手动放行）：

• Apple Silicon：LiveAgent-<version>-macOS-aarch64.dmg
• Intel：LiveAgent-<version>-macOS-x64.dmg

Windows：提供 Setup 向导、MSI 包和 portable 免安装 zip 三种方式，其中 MSI 适合企业分发和静默安装。

Linux：AppImage 加执行权限后直接运行；DEB / RPM 用包管理器安装：

sudo dpkg -i LiveAgent-<version>-Linux-x86_64.deb

需要浏览器远程访问时再部署 Gateway（Docker 镜像由 GitHub Actions 构建，支持 amd64 / arm64）：

docker pull ghcr.io/stack-cairn/liveagent-gateway:latest

运行容器时通过 -e LIVEAGENT_GATEWAY_TOKEN=your-token 设置访问令牌，命名卷 liveagent-gateway-data 用于在升级容器时持久化网关数据库和独立签发的 Agent token。

注意事项

• macOS 同时支持 Intel（x64）与 Apple Silicon（aarch64）
• Windows 为 x64，需要 WebView2 运行时（Windows 11 自带）
• Linux 为 x86_64，需要 WebKitGTK 4.1（Ubuntu 22.04+ / Debian 12+ 等）
• Gateway 放在 Nginx 反向代理后面时，需要在「设置 → 远程」页面把网关地址填成 HTTPS URL 并使用 443 端口；WebSocket 升级涉及 /ws/v2、/ws/v2/agent、/ws/v2/terminal 以及 /t/ 下的隧道，最简单的做法是在整个 vhost 上开启 upgrade
• 桌面端开箱即用，只有需要浏览器远程控制时才需要部署 Gateway

---

本作品整理自 GitHub 开源项目 Stack-Cairn/LiveAgent，原作者 @Stack-Cairn，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。