一条命令,即刻启动

安装 ZAgent 最快的方式 — 选择对应平台的命令即可。所有二进制文件均由 SamAI CI 在每次提交后自动构建并签名。

Linux / macOS / Termux bash
curl -fsSL https://zagent.samai.cc/install.sh | bash
Windows PowerShell
irm https://zagent.samai.cc/install.ps1 | iex
安装指定版本 可选
curl -fsSL https://zagent.samai.cc/install.sh | bash -s -- --version 0.28.23

独立下载

所有主流桌面平台的预编译二进制文件 — 由 SamAI CI 在每次发布后自动上传。提供 SHA-256 校验。

🪟

Windows

x86_64 (amd64)

⬇ 下载 .zip

或在 PowerShell 中执行:
irm https://zagent.samai.cc/install.ps1 | iex

🪟

Windows

ARM64

⬇ 下载 .zip

适用于 Surface Pro X / 骁龙笔记本

🐧

Linux

x86_64 (amd64)

⬇ 下载 .tar.gz

或一键安装:
curl -fsSL https://zagent.samai.cc/install.sh | bash

🐧

Linux

ARM64 (aarch64)

⬇ 下载 .tar.gz

树莓派 / ARM 服务器 / Termux proot

🍎

macOS

Apple Silicon (arm64)

⬇ 下载 .tar.gz

M1 / M2 / M3 / M4 系列 Mac

🍎

macOS

Intel (amd64)

⬇ 下载 .tar.gz

旧款 Intel 系列 Mac

🤖

Android

ARM64 APK

⬇ 查看发布

从公开发布仓库侧载 APK

手动安装

如果一键命令不适用,可选择下方手动方式。

# 一键安装(自动识别 amd64 / arm64)
$ curl -fsSL https://zagent.samai.cc/install.sh | bash

# 或手动下载并解压
$ wget https://zagent.samai.cc/downloads/zagent-linux-amd64.tar.gz
$ tar xzf zagent-linux-amd64.tar.gz
$ sudo install -m 0755 zagent /usr/local/bin/

# 启动 Web UI
$ zagent -name ZAgent -code WVJFDK
ZAgent running at http://localhost:8181
# 一键安装(Apple Silicon + Intel)
$ curl -fsSL https://zagent.samai.cc/install.sh | bash

# 移除 macOS 隔离属性(如有需要)
$ xattr -d com.apple.quarantine /usr/local/bin/zagent

# 启动
$ zagent -name ZAgent -code WVJFDK
ZAgent running at http://localhost:8181
# 在 PowerShell 中一键安装(管理员或当前用户)
> irm https://zagent.samai.cc/install.ps1 | iex

# 或手动下载并解压
> Invoke-WebRequest https://zagent.samai.cc/downloads/zagent-windows-amd64.zip -OutFile zagent.zip
> Expand-Archive zagent.zip -DestinationPath "$env:LOCALAPPDATA\zagent"

# 启动
> zagent -name ZAgent -code WVJFDK
ZAgent running at http://localhost:8181
# 以守护进程方式运行(Unix 双 fork,Windows 后台分离)
$ zagent -name ZAgent -code WVJFDK -daemon -log-file zagent.log

# 无 Web UI 模式 — 无界面、无托盘(适合服务器)
$ zagent -nowebui -name ZAgent -log-file zagent.log

# 完整参数
$ zagent \
  -code WVJFDK \
  -name "ZAgent" \
  -server "https://aicq.online" \
  -llm-url "https://internal-api.z.ai/v1" \
  -llm-key "Z.ai" \
  -poll 8 \
  -workers 4 \
  -daemon

准备好部署了吗?

打开终端,一分钟内即可在任何平台启动你的 AI 代理。

查看发布 了解特性 查看架构