---
title: 安装
summary: 下载适用于 macOS、Windows 或 Linux 的 HeartBeatAgents，并在你的设备上运行起来。
date: 2026-09-11
---

# 安装

下载适用于 macOS、Windows 或 Linux 的 HeartBeatAgents，并在你的设备上运行起来。

HeartBeatAgents 完全运行在你自己的设备上：安装过程不依赖任何云端账户。请从 [https://zh.heartbeatagents.com/download](https://zh.heartbeatagents.com/download) 下载。完全免费，无需注册账户。

## 前提条件：Docker Desktop

请先安装 [Docker Desktop](https://www.docker.com/products/docker-desktop/)（免费，跨平台）。HeartBeatAgents 使用 Docker 运行本地容器，以隔离每个智能体的执行环境。

## 选择安装包

### macOS
需要 **macOS 12 Monterey 或更高版本**。同时支持 Apple Silicon（arm64）和 Intel（x64）：
- `.dmg` 原生安装包
- `.zip` 压缩包

### Windows
需要 **Windows 10 或更高版本**：
- `.exe` 安装程序

### Linux
支持 **Ubuntu 20.04+、Debian 11+、Fedora 36+ 或同等版本**，同时支持 x64 和 arm64：
- `.deb` 软件包（Debian/Ubuntu）
- `.AppImage`（适用于任何发行版）
- Docker 镜像，用于完全容器化的自托管部署

## 安装

下载适用于你所在平台的安装程序并运行它。安装程序会自动处理其余步骤：无需手动配置。

每个下载文件都附带 **SHA-256 校验和**，可在运行前验证其完整性。Docker 镜像通过 GitHub OIDC 使用 `cosign` 签名，因此自托管部署也能以同样的方式验证来源。

HeartBeatAgents 在使用你自己的 API 密钥时是免费的；如果通过 Ollama 在本地运行模型，则可实现端到端完全免费。

## 卸载

- **macOS**：将 `HeartBeatAgents.app` 从“应用程序”拖到废纸篓即可。配置和数据保存在 `~/.heartbeatagents/` 中；如果要彻底删除所有内容，也请删除该目录。
- **Windows**：控制面板 → 程序 → 卸载程序 → HeartBeatAgents → 卸载，或在提升权限的 PowerShell 中运行 `winget uninstall HeartBeatAgents`。
- **Linux（.deb）**：运行 `sudo apt remove heartbeat-agents-desktop`；若还要同时删除配置，请运行 `sudo apt purge heartbeat-agents-desktop`。
- **Linux（.rpm）**：运行 `sudo dnf remove heartbeat-agents-desktop`（在较旧的发行版上使用 `yum`）。
- **自托管 / 无界面部署**：运行 `hba uninstall`，或手动执行：`cd ~/.heartbeatagents && docker compose down -v && cd ~ && rm -rf ~/.heartbeatagents`。

## 下一步

在[系统要求](/zh/docs/getting-started/system-requirements)中确认你的设备满足最低配置要求，或者如果已准备好配置第一个智能体，可直接跳转到[首次设置](/zh/docs/getting-started/first-setup)。