真正做到长时运行、按量计费。
PPIO 上线针对首个国内用户的 Hermes Agent 云端沙箱部署方案——PPHermes。
基于 PPHermes，不需要任何编程基础，就能在十分钟内部署可以自主进化的 AI 助手。
为什么建议你开始尝试 PPHermes？
Hermes Agent 是开源项目，官方提供不同的运行环境，适合不同技术背景和使用场景的用户。
**第一类是本地运行（Local / Docker），**直接安装在自己的电脑或本地容器中运行。
✅ 优势：零成本、数据不出本机、配置最灵活。
❌ 劣势：电脑关机 Agent 就停；无法从外部访问；占用本机资源，且跟其他本地部署的 Agent 一样存在数据安全风险。
**第二类是SSH 到云服务器（VPS），**在云平台租一台服务器，SSH 上去部署 Hermes。
✅ 优势：24 小时在线；有公网地址；完整控制权
❌ 劣势：按月付费，不管用不用都在计费；需要自己运维服务器；对新手不友好
**第三类是云端沙箱部署方案。**Agent 的运行环境托管在云端沙箱中，Hermes 官方目前推荐的沙箱方案是海外的 Daytona 和 Modal。
✅ 优势：闲置时自动休眠、有请求时自动唤醒，状态完整保留，近乎零成本待机，且有效避免了本地部署的数据安全风险。
❌ 劣势：部署复杂，沙箱本身没有针对 Hermes 部署的专门接口或者能力，而且对国内用户的使用习惯不太友好。
相比之下，PPIO 推出的 PPHermes，正是把这套云端沙箱持久化方案完整搬到了国内。PPHermes 基于 PPIO 自研的 Agent 沙箱运行 Hermes，核心优势：
✅聚焦国内开发者生态，更加符合国内用户的使用习惯
✅专为 Hermes 设计的 CLI 工具链，一条命令完成启动、暂停、恢复，自动化脚本友好
✅内置飞书集成，pphermes pair 直接对接，无需额外配置
✅支持 AI Agent 原生接入，Claude Code、Cursor 等工具可直接用自然语言管理沙箱，零配置即用。
✅成本可控，与传统云服务器方案不同，PPHermes 采用轻量容器沙箱架构，支持按需 pause/resume——不用时暂停即停止计费，真正做到按量付费。
如何用 PPHermes 部署你的 Hermes Agent
第一步：给电脑装上 Python
PPHermes 是一个基于 Python 的小工具（要求 Python 3.9+），所以需要先在电脑上装好 Python。
Windows 用户（最关键的一步）
-
下载 Python 安装包：www.python.org/downloads/
-
双击打开安装包，务必勾选底部的
Add Python to PATH。这是新手最容易漏掉的地方，不勾选的话后面所有命令都会报错。 -
点击
Install Now，等到看到Setup was successful就可以关掉了
macOS 用户
-
按
Command + 空格，搜索”终端”（Terminal）并打开 -
输入下面这行命令，按回车：
python3 --version
-
如果显示
Python 3.9或更高版本，说明已经装好了，直接跳到下一步 -
如果版本太低或没装，使用 Homebrew 安装：
brew install python
Linux（Ubuntu）用户
打开终端，输入：
sudo apt update && sudo apt install python3 python3-venv python3-pip -y
第二步：获取你的 API Key
你需要一个 PPIO API Key 来连接 PPIO 的云端 Agent 沙箱。
-
打开 PPIO 控制台 并注册登录
-
进入 API Key 管理页面
-
点击**「创建 API Key」**
-
你会看到一串以
sk_开头的字符串，复制下来找个地方存好
API Key 只在创建时显示一次，关掉页面就看不到了，记得及时复制保存。
第三步：安装并启动
打开你的终端窗口（Windows 叫 PowerShell，macOS 叫终端）。
安装 PPHermes
macOS / Linux 用户输入：
curl -fsSL https://pphermes.ppio.com/install.sh | bash
Windows 用户在 PowerShell 中输入：
irm https://pphermes.ppio.com/install.ps1 | iex
也可以通过 pip 安装：
pip install pphermes
安装完成后，输入下面的命令验证一下：
pphermes --help
如果看到类似下面这样的输出，就表示安装成功了：
Usage: pphermes [OPTIONS] COMMAND [ARGS]... PPHermes - One-click launch of Hermes Agent on PPIO Agent Sandbox.Options: --version Show the version and exit. --json / -j Output as JSON (for programmatic use). --help Show this message and exit.Commands: launch Create and start a new Hermes sandbox list List all running Hermes sandboxes status Show sandbox status pause Pause a sandbox (preserves state, no charges) resume Resume a paused sandbox stop Stop and destroy a sandbox doctor Diagnose gateway health gateway Manage Hermes gateway (update / restart / config) pair Pair external channels (Feishu / Lark) update Check for updates and upgrade to the latest version
macOS 用户如果碰到 command not found 报错，把下面两行加到 shell 配置里就好：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrc
配置 API Key
把 API Key 设置成环境变量，后续命令就不用每次手动传了：
export PPIO_API_KEY=sk_xxx
也可以每次执行命令时通过 --api-key sk_xxx 显式传入。
启动你的 Hermes Agent
输入下面这行命令：
pphermes launch
等大约 60 秒，看到类似下面的输出就说明创建好了：
+------------------- PPHermes Sandbox Ready -------------------+| Sandbox ID: hermes-abc123-fb47b43e || State: running || || Hermes Web UI: https://9119-xxx.sandbox.ppio.cn || Web Terminal: https://7681-xxx.sandbox.ppio.cn || File Manager: https://7682-xxx.sandbox.ppio.cn || Services User: admin || Services Password: <随机生成> |+--------------------------------------------------------------+
其中几个关键信息：
-
Sandbox ID — 沙箱的唯一编号，后续管理（查看状态、暂停、停止）时会用到
-
Hermes Web UI — Hermes Agent 的交互界面，复制到浏览器打开就能用
-
Web Terminal — 浏览器里的终端，可以直接进入沙箱执行命令、查看日志
-
File Manager — 网页文件管理器，支持上传 / 下载 / 删除沙箱内的文件
-
Services User / Password — Web Terminal 和 File Manager 的登录凭据（每次 launch 自动生成随机密码）
复制
Hermes Web UI
那一行的链接地址，粘贴到浏览器里打开，就能开始和你的 Hermes Agent 对话了。
PPHermes 启动后会自动配置好默认模型（PPIO 提供的 minimax/minimax-m2.5-highspeed），并预置 context compression、vision、web_extract 等辅助 LLM 能力，开箱即用，无需任何额外设置。如需切换模型或自定义 provider，可在沙箱内通过 hermes setup 或编辑 ~/.hermes/config.yaml，也可以用 pphermes gateway config-import 一键导入配置文件。
暂停 vs 停止
用完之后建议优先用 pause，状态会被保留下来，且不产生费用：
pphermes pause <Sandbox ID>
下次需要时秒级恢复：
pphermes resume <Sandbox ID>
如果确认不再使用，再用 stop 彻底销毁（不可逆）：
pphermes stop <Sandbox ID>
进阶：接入飞书 / Lark
PPHermes 内置 pair feishu 子命令，一行命令把 Hermes Agent 变成飞书机器人。
WebSocket 长连接（推荐）
无需公网回调地址，Gateway 主动连接飞书服务端：
pphermes pair feishu <sandbox-id> \ --app-id cli_xxx \ --app-secret secret_xxx \ --mode websocket
Webhook 回调
Gateway 在沙箱内启动 HTTP 服务（端口 8765）接收回调：
pphermes pair feishu <sandbox-id> \ --app-id cli_xxx \ --app-secret secret_xxx \ --mode webhook \ --verification-token <TOKEN>
配置完成后，到飞书开放平台把回调地址设置为：
https://8765-<sandbox-id>.sandbox.ppio.cn/feishu/webhook
Webhook 模式不支持飞书的 Encrypt Key（Hermes Gateway 不解密加密 payload），飞书开放平台的 Encrypt Key 必须留空。
如果用的是 Lark（飞书海外版），把 --domain feishu 换成 --domain lark 即可。
进阶：用 AI Agent 直接管理沙箱
PPHermes 也提供了一份专为 AI Agent 设计的 Skill 文档（https://pphermes.ppio.com/skill.md），无需任何配置，在 Claude Code、Cursor、Windsurf 等 Agent 输入框直接用自然语言操作：
Read https://pphermes.ppio.com/skill.md and follow the onboarding instructions
Agent 会自动获取文档、安装 PPHermes CLI、配置 API Key 并启动沙箱。也可以直接调用 REST API（基础地址 https://pphermes.ppio.com/api，交互式文档在 /api/docs），所有端点用 Authorization: Bearer <PPIO_API_KEY> 鉴权。
