需通过沙箱机制为hermes agent配置独立隔离运行环境以保障安全，具体包括：一、docker容器化部署；二、modal托管式无服务器沙箱；三、singularity本地hpc沙箱；四、e2b/腾讯云等云端托管沙箱；五、ags平台自定义沙箱工具（beta）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要为Hermes Agent配置独立、隔离的运行环境以保障操作安全，则需通过沙箱机制实现执行边界控制。以下是多种可行的安全沙箱部署方法：
一、Docker容器化沙箱部署
Docker后端是Hermes Agent官方推荐的终端隔离方案，具备启动快、资源可控、与生产环境一致性强等优势，所有命令均在轻量级容器中执行，宿主机完全不受影响。
1、确保系统已安装Docker引擎，并用户加入docker组以避免sudo权限依赖。
2、执行终端后端配置命令：hermes config set terminal_backend docker。
3、可选：通过环境变量指定自定义镜像：export TERMINAL_DOCKER_IMAGE=python:3.11-slim。
4、设置沙箱持久化开关（默认关闭）：hermes config set container_persistent true，启用后已安装包与文件将在会话间保留。
5、验证沙箱可用性：运行hermes run --tool bash --args "echo 'sandbox OK'"，确认输出在隔离环境中完成。
二、Modal沙箱环境接入
Modal提供托管式无服务器沙箱服务，支持自动扩缩容与毫秒级冷启动，适用于高并发AI代理任务，且无需维护底层基础设施。
1、注册Modal账号并安装CLI工具：pip install modal-client。
2、登录Modal账户：modal login。
3、配置Hermes Agent使用Modal后端：hermes config set terminal_backend modal。
4、在environments/hermes_swe_env/default.yaml中补充Modal认证参数：modal_token_id与modal_token_secret。
5、首次运行时Modal将自动拉取基础运行时镜像并创建隔离沙箱实例。
三、本地Singularity沙箱配置
Singularity适用于高性能计算（HPC）环境或对内核级隔离有强需求的场景，其镜像为单文件格式，可离线分发且默认以非特权模式运行，安全性优于传统容器。
1、在Linux系统上安装Singularity 4.0+版本，确保启用user namespace支持。
2、下载预构建的Hermes兼容SIF镜像（如hermes-sandbox-base.sif）至本地路径。
3、配置终端后端为Singularity：hermes config set terminal_backend singularity。
4、指定SIF镜像路径：hermes config set terminal_singularity_image /path/to/hermes-sandbox-base.sif。
5、启用只读根文件系统加固：hermes config set singularity_readonly true。
四、云端托管沙箱快速接入（E2B/Tencent Cloud）
对于无需自行运维沙箱基础设施的用户，可直接对接已商用的托管式代码沙箱API服务，实现开箱即用的安全执行能力。
1、访问E2B沙箱控制台或腾讯云Agent沙箱服务，创建新沙箱模板，选择Python 3.11运行时。
2、获取API密钥及沙箱模板ID（如tmpl-xxxxx）。
3、在Hermes Agent中启用HTTP终端后端：hermes config set terminal_backend http。
4、配置沙箱网关地址与认证头：hermes config set terminal_http_url https://api.e2b.dev/v1/sandbox，并设置terminal_http_headers包含Authorization字段。
5、运行测试任务，Hermes Agent将自动发起沙箱创建请求并转发命令执行。
五、自定义沙箱工具（Beta版，限广州地域）
面向大规模AgentRL训练或私有化部署需求，AGS平台支持基于预置镜像快速生成大量同构沙箱实例，显著降低镜像分发与初始化延迟。
1、登录Agent沙箱服务控制台，进入“沙箱工具” → “自定义沙箱(Beta)”。
2、点击“新建沙箱工具”，填写工具名称（如hermes-prod-sandbox），名称须以字母开头、仅含字母数字与短横线。
3、设置生命周期参数：5m（默认）、300s或1h，超时后实例自动销毁。
4、上传或选择已构建的Docker镜像tar包，或输入公开镜像仓库地址（如ghcr.io/nousresearch/hermes-sandbox:latest）。
5、提交后获取沙箱工具ID，将其填入hermes config set terminal_custom_tool_id完成绑定。
