使用智能体

Hermes Agent

前提条件

项目值
Hermes Agent 版本0.15.2
配置文件~/.hermes/config.yaml
环境变量文件~/.hermes/.env
Providerjoytoken
模型名auto
API Key 环境变量JOY_TOKEN_API_KEY

Hermes Agent 支持两种协议，通过命名 custom provider 接入。transport 必须和所选 tab 一致。

第 1 步：安装

pipx install hermes-agent==0.15.2
hermes --version

第 2 步：设置 API Key 和 Base URL

export JOY_TOKEN_API_KEY="sk-xxx"
export JOY_TOKEN_OPENAI_BASE_URL="https://api.joytokens.ai/openai/v1"

创建 ~/.hermes/.env 保存 API Key，并把所选 Base URL 保留在 shell 或配置文件中。限制 env 文件权限：

mkdir -p ~/.hermes
printf '%s\n' 'JOY_TOKEN_API_KEY="sk-xxx"' > ~/.hermes/.env
chmod 600 ~/.hermes/.env

第 3 步：配置 provider

JOY_TOKEN_OPENAI_BASE_URL="${JOY_TOKEN_OPENAI_BASE_URL:-https://api.joytokens.ai/openai/v1}"
mkdir -p ~/.hermes
cat > ~/.hermes/config.yaml <<EOF
model:
  provider: joytoken
  default: auto
providers:
  joytoken:
    name: JoyToken
    base_url: $JOY_TOKEN_OPENAI_BASE_URL
    key_env: JOY_TOKEN_API_KEY
    default_model: auto
    transport: chat_completions
EOF

第 4 步：验证

hermes config check
hermes chat \
  -q "Reply with exactly: pong" \
  --provider joytoken \
  -m auto \
  -Q \
  --ignore-rules

成功时，返回内容包含 pong。Hermes 可能在回复前打印 Python 包或 security scanner warning；只要包含 pong，就说明 JoyToken 请求成功。

JoyToken 侧检查

位置应看到
Logs请求路径是 /openai/v1/chat/completions
认证Bearer 认证
Usage本次调用产生 tokens 和 credits

常见错误

错误处理方式
401 Unauthorized检查 ~/.hermes/.env 里的 JOY_TOKEN_API_KEY
Hermes 仍调用其他 provider检查 model.provider: joytoken 和所选 transport
配置检查失败检查 providers.joytoken.key_env 和 base_url
JoyToken 没有日志检查 URL、transport 是否与所选协议 tab 一致

相关资源