智能体、OpenClaw 与模型 API

本文说明 OpenClaw、Hermes Agent 与捷智算 模型 API 的区别与配合方式，以及如何在 OpenClaw 中配置 https://mass.gogpu.cn 作为模型服务。

相关概念见 AI 应用概念入门。云主机购买与 ubuntu22-openclaw 镜像使用见 OpenClaw 部署指南。

先分清三件事

名称是什么在捷智算上
模型 API（mass.gogpu.cn）按 Token / 套餐计费的 大模型对话接口控制台 模型 API 服务 创建 sk- 密钥
OpenClaw开源 个人 AI 助手 / Agent 网关（多通道、工具、Skill 等）提供 ubuntu22-openclaw 云主机镜像，开机即用
Hermes Agent开源 智能体运行时（侧重长期记忆、技能自改进等）可在 GPU 云主机 上自行部署；与 OpenClaw 定位不同、可配合使用

两种「Token / 密钥」不要混用

用途典型样子在哪里
访问 OpenClaw 网页/网关实例内预置的 ?token=...云主机内《OpenClaw 服务使用指引》
调用大模型（计费）sk- 开头的 API 密钥控制台 模型 API 服务 → API KEY

前者管 能不能打开 OpenClaw 控制台；后者管 模型对话花谁的套餐/余额。

在捷智算上怎么选

                    ┌─────────────────────────────────────┐
                    │  只想在业务里调大模型（网站/App/API）   │
                    └─────────────────┬───────────────────┘
                                      ▼
                         模型 API（mass.gogpu.cn）+ sk- 密钥
                         见「快速开始」「API 调用指南」

                    ┌─────────────────────────────────────┐
                    │  想要「助手」：飞书/钉钉、多步任务、工具  │
                    └─────────────────┬───────────────────┘
                                      ▼
              购买云主机 → 镜像选 ubuntu22-openclaw → 按实例指引访问
              模型可选：镜像体验额度 / Ollama 本地 / 捷智算模型 API

                    ┌─────────────────────────────────────┐
                    │  想要 Hermes 的学习循环、深度记忆等     │
                    └─────────────────┬───────────────────┘
                                      ▼
              在 GPU 云主机上部署 Hermes（与 OpenClaw 可二选一或组合）
              大模型推理仍可走：本机 Ollama 或 捷智算模型 API
需求推荐路径
企业问答、接入 Dify 等模型 API 即可，无需购买 OpenClaw 镜像
个人或团队助手、接 IMOpenClaw 镜像 + 选配模型来源
重复性流程、希望 Agent「越用越顺手」了解 Hermes；复杂编排可用 OpenClaw + Hermes 分工（见下文）
数据不出机、长期大量调用云主机 Ollama 本地模型（见 OpenClaw 部署指南第二部分）
多模型、按量统一账单云主机 OpenClaw + 捷智算模型 API（下文配置示例）

OpenClaw 是什么（和模型 API 的关系）

OpenClaw 是运行在云主机上的 助手网关：负责会话、通道（如部分 IM）、工具与 Skill 调度，真正「说话」时仍要连接 一个大模型后端。

模型来源优点费用特点
镜像内置 MiniMax 体验额度开机即可试额度用尽需自配 Key
本机 Ollama数据不出机、无按次 API 费占 GPU/显存，见部署指南
捷智算模型 API多模型、统一计费与控制台对账按 Token 套餐或账户余额，见 计费方式说明

OpenClaw 不等于 模型 API：它是 使用模型的一种方式；捷智算 模型 API 是其中一种 模型供应商连接方式（OpenAI 兼容地址 + sk- 密钥）。

与 AI 应用概念入门 中的名词对应关系：

名词在 OpenClaw 里
Agent整体助手会拆任务、调工具
Skill可安装/管理的技能包，完成某类固定流程
MCP可接外部工具与数据源（与 Cursor 类似思路）
RAG / 知识库常通过 Skill 或 MCP 接文档检索，再调用大模型生成

平台 OpenClaw 镜像（ubuntu22-openclaw）已预装网关与指引，详见 OpenClaw 部署指南。

Hermes Agent 是什么（和 OpenClaw 怎么选）

Hermes Agent（Nous Researchopen in new window 等社区维护的开源项目）是另一类 智能体框架，常见特点包括：

维度OpenClawHermes Agent
侧重点多通道网关、助手形态、工具与 Skill 生态执行与学习循环、长期记忆、技能沉淀
典型场景飞书/钉钉/多端个人助手重复性流程、越用越贴合个人习惯的任务
与模型关系可插多种模型提供商同样需接 LLM（本地或 API）

二者 不是替代关系，也可组合使用（例如 OpenClaw 负责多渠道接入，Hermes 负责部分深度任务）。

使用建议

  • 已选购 OpenClaw 镜像：按实例内《OpenClaw 服务使用指引》完成访问与配置；模型可选用体验额度、Ollama 或 模型 API。
  • 需要 Hermes Agent：在 GPU 云主机上按 官方文档open in new window 安装；大模型可配置为 https://mass.gogpu.cn（以 Hermes 版本说明为准）。

名称说明

Hermes Agent（智能体框架）与 Hermes 模型系列（模型权重名称）含义不同，请勿混淆。

在 OpenClaw 中接入捷智算模型 API

适用于：已使用 ubuntu22-openclaw 镜像（或自装 OpenClaw），希望默认模型走 捷智算（多模型、统一账单）。

1. 准备

  1. 在 控制台open in new window 模型 API 服务 创建 API 密钥（sk-），并确认计费方式（套餐或按量）。
  2. 在 模型广场 记下要用的 接口模型名称（如 deepseek-v4-pro）。
  3. （建议）备份配置：cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

2. 增加模型提供商（示例）

在 ~/.openclaw/openclaw.json 的 models.providers 中增加一段 OpenAI 兼容 配置（与镜像内 MiniMax、Ollama 写法类似）。请将 sk- 与 model id 换成您的实际值：

"jogpu": {
  "baseUrl": "https://mass.gogpu.cn/v1",
  "api": "openai-completions",
  "authHeader": true,
  "apiKey": "sk-您的捷智算API密钥",
  "models": [
    {
      "id": "deepseek-v4-pro",
      "name": "DeepSeek-V4-Pro",
      "api": "openai-completions",
      "contextWindow": 128000,
      "maxTokens": 8192
    }
  ]
}

若模型支持 Anthropic 方式，OpenClaw 侧仍以当前镜像文档为准；多数场景使用上表 OpenAI 兼容地址 即可。

3. 设为默认模型（可选）

在 agents.defaults.model.primary 中指定，例如：

"primary": "jogpu/deepseek-v4-pro"

其中 jogpu 为上面 providers 的键名，deepseek-v4-pro 须与 models[].id 及控制台 接口模型名称 一致。

也可把密钥写在 ~/.openclaw/.env，在配置里用环境变量引用（具体变量名以实例内指引或 OpenClaw 版本为准）。

4. 重启并检查

systemctl --user restart openclaw-gateway.service
sleep 3
openclaw status
openclaw models list

在 openclaw models list 中应能看到新加的提供商与模型；对话一次后，在控制台 调用统计 中应有 Token 记录。

5. 与 Ollama 并存

可与部署指南中的 Ollama 本地模型 同时配置：models.mode 为 merge 时，本地模型优先、捷智算 API 作补充，或反过来，按业务调整 agents.defaults.model.primary。

与 Cursor、Dify 等工具对比

工具典型运行位置模型从哪来
Cursor本机 IDE设置里填 https://mass.gogpu.cn/v1 + sk-
OpenClaw 镜像捷智算云主机体验额度 / Ollama / mass.gogpu.cn
Hermes自管服务器/云主机官方文档 + 可选 mass.gogpu.cn
Dify 等平台或自建应用里配置捷智算为模型供应商

MCP 用于连接外部工具与数据；模型 API 用于调用大模型。OpenClaw、Hermes、Cursor 等可同时配置 MCP 与捷智算模型 API。

常见问题

OpenClaw 里配置了 sk-，为什么控制台没用量？

确认 baseUrl 为 https://mass.gogpu.cn/v1（不要漏 /v1）；模型 id 与控制台完全一致；密钥未作废；套餐有余量或按量余额大于 0。

能否只用 OpenClaw 镜像、不买模型 API？

可以。镜像 MiniMax 体验额度 或 Ollama 不经过 mass.gogpu.cn，不会出现在 模型 API 调用统计 里；这是正常现象。

Hermes 和 OpenClaw 必须二选一吗？

不必。两者是不同框架，可按官方文档在同一台或不同云主机部署；大模型均可指向捷智算 模型 API（若该框架支持 OpenAI 兼容配置）。

更多 OpenClaw 镜像问题？

见 OpenClaw 部署指南（端口 18789、WebVNC、飞书/钉钉接入等）。

相关文档

文档内容
OpenClaw 部署指南购买云主机、ubuntu22-openclaw 镜像、Ollama
快速开始直接调模型 API
API 调用指南地址、密钥、报错
AI 应用概念入门Agent、MCP、RAG、Skill
计费方式说明套餐与按量
复制 MD