sbx/hermes-agent-kit

镜像概述

本镜像为Hermes Agent专属预制沙箱套件，由Nous Research官方推出，作为独立沙箱运行环境，将Hermes Agent及其所有依赖在镜像构建阶段预安装完成，无需在沙箱启动时进行耗时安装，可实现秒级启动。该镜像未内置Docker引擎，默认终端后端直接在沙箱内部执行命令，无需依赖容器虚拟化能力。

核心功能

• 自迭代技能体系：可从运行过程的实际经验中自动生成新技能，并在持续使用过程中动态优化完善
• 跨会话持久化记忆：永久保留AI代理的历史交互数据与运行上下文，多次启动运行可连贯承接历史状态
• 大模型广泛兼容：原生支持对接200+主流AI大模型，内置Anthropic、OpenAI、OpenRouter三家平台的预配置对接逻辑
• 内置定时调度：自带Cron定时任务能力，可配置代理按预设周期自动执行指定任务
• 多平台网关支持：原生对接***、***、Slack、***四大即时通讯平台，可快速将AI代理部署为聊天机器人
• 安全隔离设计：沙箱采用密封设计，无外部PyPI软件包写入权限，避免运行过程中安装未知第三方包带来的安全风险

使用场景

1. 轻量化AI代理快速部署：无需复杂环境配置，秒级启动可自我迭代的AI代理服务
2. 多模型统一调度实验：基于OpenRouter接入数百款大模型，快速开展多模型效果对比测试
3. 智能聊天机器人搭建：对接主流通讯平台，快速搭建具备自定义技能的群聊/私聊AI助手
4. 自动化AI任务编排：搭配内置定时调度能力，实现周期性数据处理、信息汇总等自动化智能任务

配置说明

前置要求

提前准备至少一个支持的大模型服务平台的API密钥（Anthropic、OpenAI、OpenRouter任选其一），通过sbx工具在主机侧完成密钥注册，密钥仅存储在主机密钥库中，不会直接暴露到沙箱内部。

密钥配置步骤

Anthropic 平台配置

console
sbx secret set-custom -g \
    --host api.anthropic.com \
    --env ANTHROPIC_API_KEY \
    --placeholder "sk-ant-{rand}" \
    --value "$ANTHROPIC_API_KEY"

OpenAI 平台配置

console
sbx secret set-custom -g \
    --host api.openai.com \
    --env OPENAI_API_KEY \
    --placeholder "sk-{rand}" \
    --value "$OPENAI_API_KEY"

OpenRouter 平台配置（支持200+模型）

console
sbx secret set-custom -g \
    --host openrouter.ai \
    --env OPENROUTER_API_KEY \
    --placeholder "sk-or-{rand}" \
    --value "$OPENROUTER_API_KEY"

部署运行示例

直接拉取镜像运行

console
sbx run --kit "docker.io/sbx/hermes-agent-kit:latest" hermes-agent

通过GitHub仓库源码部署

console
sbx run --kit "git+https://github.com/docker/sbx-kits-contrib.git#dir=hermes-agent" hermes-agent

基于本地克隆源码部署

console
sbx run --kit ./hermes-agent/ hermes-agent

沙箱启动完成后，执行hermes model命令选择对应的模型服务商与目标模型，即可开始与AI代理交互。

身份认证逻辑说明

沙箱内置代理会自动拦截向外发出的大模型服务请求，自动注入对应平台的认证请求头，沙箱环境中仅存储随机占位符密钥，不会暴露真实API密钥：

• 请求api.anthropic.com时自动注入x-api-key认证头
• 请求api.openai.com与openrouter.ai时自动注入Authorization: Bearer认证头

请勿直接在沙箱内部完成平台登录认证，避免真实密钥泄露。

已存密钥清理

如需删除主机侧存储的认证密钥，执行以下命令即可：

console
sbx secret rm -g --host api.anthropic.com
sbx secret rm -g --host api.openai.com
sbx secret rm -g --host openrouter.ai