API 与下载
下载与部署
AgentOS X Server / Desktop ISO 公开下载、SHA-256 校验与装机指南。
下载与校验
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。
| 产品 | 版本 | 文件名 | 大小 | 安装包 | SHA-256 |
|---|---|---|---|---|---|
| AgentOS X | server | agentos-x-server.iso |
1.1 GiB | 下载 · .sha256 | 4da071d05eb2b83921f7c0269393e349d0c00323949d3469fd5155f380426ad1 |
| AgentOS X | desktop | agentos-x-desktop.iso |
1.6 GiB | 下载 · .sha256 | aeb7035b3ba19dfe493e8e3e8b5004ff7be35363065c0493a0aee44805ddb98f |
| AgentNet IM | windows | agentnet-im-windows.exe |
- | 下载 · .sha256 | 发布后见 .sha256 侧车文件 |
| AgentNet IM | macos | agentnet-im-macos.dmg |
- | 下载 · .sha256 | 发布后见 .sha256 侧车文件 |
AgentNet IM 移动端（应用市场）
| 平台 | 市场 | 链接 |
|---|---|---|
| ios | App Store | 上架后配置商店 URL（env） |
| android | Google Play | 上架后配置商店 URL（env） |
| harmony | AppGallery | 上架后配置商店 URL（env） |
校验（CDN 文件）
# AgentOS X - Server
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-server.iso
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-server.iso.sha256
shasum -a 256 -c agentos-x-server.iso.sha256
# AgentOS X - Desktop
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-desktop.iso
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-desktop.iso.sha256
shasum -a 256 -c agentos-x-desktop.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。移动端仅商店。
ISO 部署指南
AgentOS X 桌面版（COSMIC）与服务器版（无头 + Web）操作指南。架构内部细节不在此公开 - 仅安装、首配、运维与排障。
1. 版本
| 版本 | 公开文件 | 界面 | 用途 |
|---|---|---|---|
| Desktop | agentos-x-desktop.iso | COSMIC 桌面 + AgentX 侧栏 applet | 个人 PC / 工作站 |
| Server | agentos-x-server.iso | 经 agentx-api 的 Web 控制台 | 服务器、云主机、无头 |
两者共享同一代理运行时与三层模型（计算 / 状态 / 投影）。差异仅在人类交互表面。
2. 系统要求
| Desktop（最低 / 推荐） | Server（最低 / 推荐） | |
|---|---|---|
| CPU | x86-64 双核 / 四核+ | x86-64 双核 / 四核+ |
| RAM | 4 GB / 8 GB+ | 2 GB / 4 GB+ |
| 磁盘 | 20 GB / 50 GB+ | 10 GB / 20 GB+ |
| GPU / 显示 | iGPU Vulkan；1366×768+ | 不需要（无头） |
| 启动 | UEFI | UEFI 或 legacy |
本发行仅 x86-64。未发布 ARM 镜像。
3. 黄金路径（最短跑通）
- 下载对应 ISO 并校验 SHA-256（见上表）。
- 选一种启动方式：U 盘 或 本机硬盘引导工具（见 §4 / §5，不必强制 U 盘）。
- GRUB 选 Install → 装到目标磁盘 → 重启拔掉安装介质。
- 自备 LLM（§6）：填 Base URL / 模型 / API Key → 发一句测试对话。
Desktop → 个人 PC / 工作站。 Server → 服务器 / 无头 / 云 VM。安全工具（ClamAV / Lynis / fail2ban / host-probe）不预装，装完后从 AGPK 市场按需装。
4. 桌面版（个人电脑）
4.1 硬盘引导安装（Windows / Linux · 不必 U 盘）
在当前电脑下载 agentos-x-desktop.iso 到硬盘后，用本机引导工具从该 ISO 启动安装器（常见：Ventoy 把 ISO 放进 Ventoy 分区再启动菜单选 ISO；或 Linux 下 GRUB loopback 挂 ISO）。进入 live/安装器后，向导与 U 盘路径相同——把系统装到目标磁盘（不要误选只放了 ISO 的介质）。
- Windows：下载 ISO → 用 Ventoy（或同类）制作可引导分区/盘 → 重启从该介质启动 → 菜单选
agentos-x-desktop.iso→ Install。 - Linux：同上（Ventoy / GRUB loopback / 发行版自带 ISO 启动工具均可）。
4.2 写 U 盘（可选）
diskutil list
diskutil unmountDisk /dev/diskN
# 确认设备 - 写错盘会毁数据
sudo dd if=agentos-x-desktop.iso of=/dev/rdiskN bs=4m status=progress
diskutil eject /dev/diskNsudo dd if=agentos-x-desktop.iso of=/dev/sdX bs=4M status=progress && syncWindows U 盘：Rufus 或 balenaEtcher 烧录 agentos-x-desktop.iso。
- 目标机从 U 盘或硬盘引导工具启动（F12 / F2 / Esc；必要时关 Secure Boot、选 UEFI）。
- GRUB → Install AgentOS X Desktop。
- 语言、磁盘、用户名/密码；约 5–10 分钟；重启并移除安装介质。
- COSMIC：顶栏 AgentX applet；右侧对话侧栏。
5. 服务器版
文件 agentos-x-server.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:180866. 首次配置 · LLM（用户自备）
对话必需自备大模型：你自己的 API Key / Base URL / 模型。不强制先注册平台账号。
| 协议 | 常见 Base URL 示例 | 模型示例 |
|---|---|---|
| OpenAI Chat Completions | https://api.openai.com/v1 · DeepSeek / 月之暗面等兼容端 | gpt-4o · deepseek-chat |
| OpenAI Responses API | 提供商文档中的 Responses 端点 | 按厂商 |
| Anthropic Messages | https://api.anthropic.com | claude-sonnet-4-20250514 |
- Desktop：AgentX applet → 设置 → 协议 / Base URL / 模型 / API Key → 保存。
- Server：SSH 隧道打开 Web 控制台 → LLM 配置（字段相同）。
配置文件：/opt/agentx/llm.json（mode 0600；密钥不回显）。
# 测通上游（把 URL/模型/Key 换成你的）
curl -sS "$BASE_URL/chat/completions" \
-H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
-d '{"model":"'"$MODEL"'","messages":[{"role":"user","content":"ping"}]}'可选平台注册（OTA / 组织席位等）：
agentx register --endpoint https://www.aiagentnet.club7. Web 控制台（Server）
聊天（左）+ 投影审阅（右）。Enter 发送；Shift+Enter 换行。检查点：批准 / 拒绝 / 修改。生产请用 SSH 隧道或带 TLS 的反代，不要裸暴露 18086。
8. COSMIC 侧栏（Desktop）
顶栏 AgentX applet 开关侧栏；检查点卡片支持批准 / 拒绝 / 修改。可与 Web 控制台同时连接。
9. 日常运维
systemctl status agentx-daemon agentx-api office-suite-api
sudo systemctl restart agentx-daemon
journalctl -u agentx-daemon -f
journalctl -u agentx-api -f
# OTA（已注册时）
agentx ota check && agentx ota update| 数据 | 路径 |
|---|---|
| Agent home | /opt/agentx/ |
| LLM 配置 | /opt/agentx/llm.json |
| 投影 / 检查点 / 审计 | /opt/agentx/projections/ · state_checkpoints/ · audit_chain.jsonl |
| 内嵌 PostgreSQL | /opt/agentx/runtime/pg/ |
10. 排障
- 进不了安装器 / Secure Boot：BIOS 关 Secure Boot；启动模式 UEFI；从带 UEFI 前缀的项启动。
- 选错盘：安装会抹掉目标盘；U 盘/Ventoy 介质通常应被排除，仍请二次确认目标不是只放了 ISO 的分区。
- firstboot 卡住：TTY 登录；
journalctl -b -u firstboot -u agentx-daemon；确认网络后再配 LLM。 - 代理无响应：查
/opt/agentx/llm.json；用上面 curl 测上游；重新保存 LLM；确认出网与 Key 额度。 - Web 控制台打不开：
systemctl status agentx-api；ss -tlnp | grep 18086；重开 SSH 隧道。 - COSMIC 起不来：Ctrl+Alt+F2；
journalctl -u seatd -b；可试LIBGL_ALWAYS_SOFTWARE=1。 - 内嵌 PG：清
postmaster.pid；chown -R agentx:agentx /opt/agentx/runtime/pg/data；重启agentx-pg-init。
支持：联系 · 营销站下载页 · www.aiagentnet.club