下载与部署

下载与校验

AgentNet 面向一般使用发布的产品安装包均为公开免费下载，地址 https://downloads.aiagentnet.cloud，无需账号。

AgentOS X：Server / Desktop ISO。AgentNet IM 桌面：本 CDN 上的 Windows / macOS 安装包。IM 移动端：仅 App Store · Google Play · 应用市场（此处无原始移动包）。文件下载请先校验 SHA-256。

ISO 镜像版本与产品更新记录，详见营销站 更新日志（英文：changelog）。每次对外替换 CDN 镜像会登记日期与 SHA-256。

已装盘系统的日常升级不走「再下 ISO 重装」，见下文 版本补丁（系统更新）与软件安装。

AgentNet IM 移动端（应用市场）

校验（CDN 文件）

# AgentOS X  -  Server
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-server-x.1.0.iso
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-server-x.1.0.iso.sha256
shasum -a 256 -c agentos-x-server-x.1.0.iso.sha256

# AgentOS X  -  Desktop
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-desktop-x.1.0.iso
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-desktop-x.1.0.iso.sha256
shasum -a 256 -c agentos-x-desktop-x.1.0.iso.sha256

# AgentNet IM desktop (example: macOS)
curl -fLO https://downloads.aiagentnet.cloud/im/agentnet-im-macos.dmg
curl -fLO https://downloads.aiagentnet.cloud/im/agentnet-im-macos.dmg.sha256
shasum -a 256 -c agentnet-im-macos.dmg.sha256

哈希不一致 = 不要安装。桌面 IM 的 CDN 行在包未上传前可能 404。移动端仅商店。

AgentOS X 操作指南（ISO）

AgentOS X 桌面版与服务器版（无头 + Web）的公开操作指南：下载校验、装机、系统更新（版本补丁）、软件安装（市场）、LLM 首配、桌面界面、运维与排障。以当前产品实现为准；架构内部细节不在此公开。

通道分工：空盘/新机 → ISO 装盘；已装盘滚动 → 签名版本补丁；应用与可选能力 → 软件市场（AGPK）。详见 §9 版本补丁（系统更新）与软件安装。

1. 版本

两者共享同一代理运行时与三层模型（计算 / 状态 / 投影）。差异仅在人类交互表面。

2. 系统要求

本发行仅 x86-64。未发布 ARM 镜像。

3. 黄金路径（最短跑通）

1. 下载对应 ISO 并校验 SHA-256（见上表）。
2. 选一种启动方式：U 盘 或 本机硬盘引导工具（见 §4 / §5，不必强制 U 盘）。
3. GRUB 选 Install → 装到目标磁盘 → 重启拔掉安装介质。
4. 自备 LLM（§6）：用 agentx llm 预设配置或 Settings → agentx llm test 测通。
5. 装盘完成后的版本与能力更新：走 系统更新（版本补丁），不要依赖再烧一张新 ISO 重装。

Desktop → 个人 PC / 工作站。 Server → 服务器 / 无头 / 云 VM。安全工具（ClamAV / Lynis / fail2ban / host-probe）不预装，装完后从 AGPK 市场按需装。

4. 桌面版（个人电脑）

4.1 硬盘引导安装（Windows / Linux · 不必 U 盘）

在当前电脑下载 agentos-x-desktop-x.1.0.iso 到硬盘后，用本机引导工具从该 ISO 启动安装器（常见：Ventoy 把 ISO 放进 Ventoy 分区再启动菜单选 ISO；或 Linux 下 GRUB loopback 挂 ISO）。进入 live/安装器后，向导与 U 盘路径相同——把系统装到目标磁盘（不要误选只放了 ISO 的介质）。

• Windows：下载 ISO → 用 Ventoy（或同类）制作可引导分区/盘 → 重启从该介质启动 → 菜单选 agentos-x-desktop-x.1.0.iso → Install。
• Linux：同上（Ventoy / GRUB loopback / 发行版自带 ISO 启动工具均可）。

4.2 写 U 盘（可选）

diskutil list
diskutil unmountDisk /dev/diskN
# 确认设备 - 写错盘会毁数据
sudo dd if=agentos-x-desktop-x.1.0.iso of=/dev/rdiskN bs=4m status=progress
diskutil eject /dev/diskN

sudo dd if=agentos-x-desktop-x.1.0.iso of=/dev/sdX bs=4M status=progress && sync

Windows U 盘：Rufus 或 balenaEtcher 烧录 agentos-x-desktop-x.1.0.iso。

1. 目标机从 U 盘或硬盘引导工具启动（F12 / F2 / Esc；必要时关 Secure Boot、选 UEFI）。
2. GRUB → Install AgentOS X Desktop。
3. 语言、磁盘、用户名/密码；约 5–10 分钟；重启并移除安装介质。
4. COSMIC：顶栏 AgentX applet；右侧对话侧栏。

5. 服务器版

文件 agentos-x-server-x.1.0.iso。启动方式同桌面：U 盘、本机硬盘引导工具、或虚拟机/云控制台挂载 ISO 为虚拟光驱。GRUB → Install AgentOS X Server。磁盘、网络（DHCP/静态）、root 密码 → 无头重启。

这是真机/VM 安装器 ISO，不是云厂商「系统盘镜像」。阿里云/腾讯云等控制台通常不能把本 ISO 直接当系统盘挂载装机；请用自备机、工控机、或支持挂 ISO/IPMI 虚拟介质的环境。

# SSH
ssh root@<server-ip>

# Web 控制台（agentx-api 默认 127.0.0.1:18086 · 勿裸奔公网）
ssh -L 18086:127.0.0.1:18086 root@<server-ip>
# 浏览器打开 http://localhost:18086

6. 首次配置 · LLM（用户自备 · 当前实现）

对话与自驱必需自备大模型供应商。不强制先注册 AgentNet 平台账号。引擎只认三种协议：openai_chat · openai_responses · anthropic（按协议透传，不写死厂商 SDK）。

6.1 配置落点

ISO 安装树常见还有 /opt/agentx/（运行时等）。模型密钥的事实源是 AGENTX_HOME 下 sidecar（no-master-key），不是 vault。

6.2 双轨鉴权

xAI：优先 OAuth 预设 xai_oauth；若 access_token 无法调 completions，回退 xai_api + Console API Key。Grok 网页 / Build 登录态不等于自动具备 API completions 权限。

6.3 Day-0 预设（agentx llm presets）

readiness=template：配置形状已内置，但厂商公开路径可能仍以 API Key 为主；登录后须实测 chat/completions（token_use）。

6.4 CLI 操作

# 列预设
agentx llm presets

# xAI OAuth（推荐）
export AGENTX_LLM_OAUTH_CLIENT_ID=<public-client-id>
agentx llm configure --preset xai_oauth
agentx llm login
agentx llm status
agentx llm test
agentx llm logout    # 仅清 token 文件

# API Key 示例
export DEEPSEEK_API_KEY=sk-...   # 或 AGENTX_LLM_API_KEY / XAI_API_KEY / ...
agentx llm configure --preset deepseek_api
agentx llm test

export XAI_API_KEY=xai-...
agentx llm configure --preset xai_api
agentx llm test

# 本机 Ollama
agentx llm configure --preset ollama_local
agentx llm test

# 手动字段（无预设时）
agentx llm configure --auth api_key --protocol openai_chat \
  --base_url https://api.example.com/v1 --model your-model-id

可选覆盖：AGENTX_LLM_OAUTH_ISSUER · AGENTX_LLM_OAUTH_DEVICE_ENDPOINT · AGENTX_LLM_OAUTH_TOKEN_ENDPOINT · AGENTX_LLM_BASE_URL · AGENTX_LLM_MODEL。

多 profile 路由：

agentx llm set-llm-routing /path/to/routing.json
# → $AGENTX_HOME/llm_routing.json（0600）

6.5 llm.json 形状（兼容旧格式）

// 旧格式 / 默认 api_key（无 auth 字段 = api_key）
{
  "protocol": "openai_chat",
  "base_url": "https://api.deepseek.com",
  "model": "deepseek-chat",
  "api_key": "sk-...",
  "max_tokens": 4096
}

// OAuth 示意（字段以 configure 写入为准）
{
  "protocol": "openai_chat",
  "base_url": "https://api.x.ai/v1",
  "model": "grok-3",
  "auth": "oauth",
  "oauth": {
    "issuer": "https://auth.x.ai",
    "client_id": "<public-client-id>",
    "scopes": ["openid", "offline_access"],
    "flow": "device_code",
    "token_file": "llm_oauth_xai.json"
  }
}

6.6 Desktop / Server 入口

• Desktop：顶栏 AgentX → 对话弹层 → Settings；或终端执行上文 CLI。
• Server：SSH 隧道打开 Web 控制台配置同等字段；或 SSH 内跑 agentx llm。

上游 curl 辅助（优先仍用 agentx llm test）：

curl -sS "$BASE_URL/chat/completions" \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"'"$MODEL"'","messages":[{"role":"user","content":"ping"}]}'

可选平台注册（版本补丁 / 组织席位等，与 LLM 配置独立）：

agentx register --endpoint https://www.aiagentnet.club

7. Web 控制台（Server）

聊天（左）+ 投影审阅（右）。Enter 发送；Shift+Enter 换行。检查点：批准 / 拒绝 / 修改。生产请用 SSH 隧道或带 TLS 的反代，不要裸暴露 18086。

8. 桌面界面（COSMIC · Desktop）

Desktop 装完后进入 COSMIC 会话：底栏 Dock 进文件、应用、软件市场、AgentNet IM、浏览器、终端与设置。人与 agent 的日常协作优先走 AgentNet IM；系统本体升级走设置里的系统更新（应用版本补丁）。以下为真机截图（与营销站同源，非示意稿）。

未配置 LLM 时，对话/规划不可用或降级；以 agentx llm test 通过为准。截图文件在 monorepo assets/docs/agentos-x/——禁止只传到生产机而不改引用、不入库。

9. 版本补丁（系统更新）与软件安装

从 2026-07-18 起，已装盘实例的日常升级路径与软件安装路径分开。营销站说明见 更新日志。

当前旗舰基线：首装 Desktop ISO x.1.0、Server ISO x.1.0；已装盘版本补丁自 0.0.1 起算（现行 latest 见 CDN）。先前 1.3.x 序列的版本补丁已从 CDN 下架，不再作为升级维护基线。详情见营销站更新日志。Desktop x.1.0 起，设置 / 语言模型配置状态 / 系统更新入口探测更可靠；工业自动化设备通过 AGPK 装模块接入（见 AGPK · 工业边缘）。

9.1 三条通道

系统服务与系统界面通过同一条版本补丁通道发布。版本补丁与 ISO 烤盘在同一交付窗口对齐，使新装与已装升完落在同一产品世代。

9.2 已装盘如何应用版本补丁

# 已装盘系统：检查并应用签名版本补丁（以本机 agentx 帮助为准）
agentx upgrade

# 部分构建亦提供分步子命令（CLI 子命令名仍为 ota，对外学名=版本补丁）：
# agentx ota check
# agentx ota update

• 版本补丁经公开 CDN 分发，并做签名校验；不安全的降级路径会被拒绝。
• 版本补丁路径不以 Ubuntu Software Updater / 商店 / 裸 apt upgrade 作为产品完成标准。
• 升完后设置与版本信息应与本发一致；若界面与版本长期对不上，见 §11 排障并联系支持。

9.3 版本补丁 vs 装软件

10. 日常运维

systemctl status agentx-daemon agentx-api
sudo systemctl restart agentx-daemon
journalctl -u agentx-daemon -f
journalctl -u agentx-api -f
# 桌面图形会话（视 unit 名）
journalctl -u agentx-cosmic -n 50 --no-pager
# LLM
agentx llm status
agentx llm test
# 版本补丁（已装盘 · 详见 §9）
agentx upgrade

11. 排障

• 进不了安装器 / Secure Boot：BIOS 关 Secure Boot；启动模式 UEFI；从带 UEFI 前缀的项启动。
• 选错盘：安装会抹掉目标盘；二次确认目标不是只放了 ISO 的分区。
• firstboot 卡住：TTY 登录；journalctl -b -u firstboot -u agentx-daemon；确认网络后再配 LLM。
• 代理无响应：agentx llm status / test；查 llm.json 是否 0600 存在；curl 测上游；确认出网与 Key 额度。
• OAuth 失败：检查 client_id 与端点 env；token 无法调 completions 时改 API Key 轨。
• Web 控制台打不开：systemctl status agentx-api；ss -tlnp | grep 18086；重开 SSH 隧道。
• COSMIC 起不来：Ctrl+Alt+F2；journalctl -u seatd -b；可试 LIBGL_ALWAYS_SOFTWARE=1。
• 哈希不一致：重新下载 ISO 与 .sha256，以 CDN 最新 digest 为准。
• 版本补丁失败 / 无可用更新：确认出网；再试 agentx upgrade；勿用 Ubuntu 更新界面代替；仍失败则保留日志联系支持。
• 误以为必须重装 ISO 才能升级：已装盘日常升级走版本补丁（§9）；仅灾难恢复或主动全盘重装才再下 ISO。

支持：联系 · 营销站下载页 · www.aiagentnet.club · support@aiagentnet.cloud（7×24）