模型接入指南
GPT-6 Astra 接入 OpenClaw 和 Hermes:模型 ID、价格与配置
GPT-6 Astra 是 OpenAI 面向高难度推理、编程、研究和电脑操作的新旗舰模型。API 现在已经可以调用,OpenRouter 也已上架。真正容易踩坑的是 OpenClaw:2026.9.2 之前的版本没有在内置目录中收录 Astra,在这些版本上只填模型 ID 会直接报 Unknown model。下面分别给出两个框架中可用的配置、最新价格,以及 Astra 对提示词提出的新要求。
9 月 29 日更新:OpenAI 发布了 GPT-6.1 Sol,定位为以更低成本提供接近 Astra 的表现:每百万 token 输入 2 美元、输出 10 美元,只有 Astra 的五分之一。它也可以通过 ChatGPT 订阅在 Hermes Agent 上使用。为 Astra 付费之前,建议先在自己的任务上对比两者。
OpenAI 这次发布了什么
OpenAI 把 GPT-6 Astra 定位为复杂推理、编程、电脑操作、研究和文档生成领域能力最强的模型。 官方模型页给出的上下文窗口是 1,050,000 token,最大输出 128,000 token,知识截止日期是 2026 年 4 月 30 日。它可以接收文字和图片并输出文字,不支持音频或视频输入。
9 月 3 日,OpenAI 先向一小批组织开放,并表示随后几天会扩展到 ChatGPT Plus、Pro、Business、Enterprise,以及 OpenAI API、Microsoft Azure 和 AWS Bedrock。两天后,API 路线显然已经打通:OpenRouter 于 9 月 4 日上架 Astra,并通过 OpenAI 和 Azure 两种线路转发,ChatGPT 的高档付费计划也已经可以使用。目前主要还在等待的是 Plus,OpenAI 的更新日志同样没有把 Astra 标为全面可用。因此,能否使用取决于自己的账号,不能只看发布日期。
GPT-6 Astra 参数与价格
| 项目 | GPT-6 Astra |
|---|---|
| 模型 ID | gpt-6-astra |
| 上下文窗口 | 1,050,000 token |
| 最大输入 | 922,000 token |
| 最大输出 | 128,000 token |
| 输入 / 百万 token | 10 美元 |
| 缓存输入 / 百万 token | 1 美元 |
| 缓存写入 / 百万 token | 12.50 美元 |
| 输出 / 百万 token | 50 美元 |
| Batch / Flex | 标准价格的 50% |
| 推理等级 | low、medium、high、xhigh、max |
| 知识截止 | 2026 年 4 月 30 日 |
百万上下文不能只看容量,还要看计费门槛。输入超过 272,000 token 后,OpenAI 会对整个请求按 2 倍输入与缓存价格、1.5 倍输出价格计费。Batch 和 Flex 是标准价格的 50%,Fast 是标准价格的 2 倍。日常 Agent 建议先限制上下文,只有确实需要读取大型代码库或资料集时再放宽。
在 OpenClaw Launch 上配置
本指南发布时,已确认可用的托管路线是 Hermes Agent。OpenAI key 会作为用户凭据保存,不会与其他客户共享。
- 打开 API Keys,添加自己的 OpenAI API key。
- 打开运行中 Hermes Agent 实例的模型选择器。
- 在自定义模型字段里选择平台
openai,模型 ID 填gpt-6-astra。 - 应用修改。Hermes Agent 需要新建会话,才会使用新的默认模型。
托管 OpenClaw 目前还用不了 Astra。OpenClaw 解析模型时,只认编译进当前发布版的目录。截至 2026.9.1,所有版本都没有收录 Astra,因此托管实例也需要添加下面自托管部分提到的 provider 模型声明,才能解析模型名。在这条声明进入托管镜像前,强行在托管 OpenClaw 实例中填写这个 ID,只会得到一个首次对话就报错的 bot。请等模型选择器的 OpenAI 分区出现 Astra。
如果 OpenAI 返回 model not found、permission 或 organization access 错误,不要反复改模型拼写。请确认这个 key 所属的同一个 API 组织已经看到 Astra;分阶段开放期间,尚未轮到账号时只能等待。
自托管 OpenClaw 配置
这一步最容易写错,值得展开说明。OpenClaw 引用模型时必须带提供商前缀。内置 OpenAI 提供商会读取 OPENAI_API_KEY,并调用 Responses API;Astra 的引用值是 openai/gpt-6-astra。在 2026.9.2 及更新的版本上,只写这个字符串就能运行,因为该版本已经把 Astra 加入内置 OpenAI 目录。更早的版本则不行:2026.7.1 和 2026.9.1 中最新的 OpenAI 条目仍是 GPT-5.6 系列,必须补上下面这条注册声明。
设置时看起来已经成功,错误会在第一轮对话时出现:
Unknown model: openai/gpt-6-astra. Found agents.defaults.models["openai/gpt-6-astra"],
but no matching models.providers["openai"].models[] entry. Add
{ "id": "gpt-6-astra", "name": "gpt-6-astra" } to models.providers["openai"].models[]
to register this provider model.OpenClaw 已经把解决办法写在报错里了:先把模型注册到内置 OpenAI 提供商,再设为默认。--merge 不能省略。models.providers 是受保护路径,如果不加 --merge 就直接赋值,已有的 provider 模型会被清空。
export OPENAI_API_KEY="sk-..."
openclaw onboard --auth-choice openai-api-key
# 把 Astra 注册到内置 OpenAI 提供商
openclaw config set models.providers.openai.models \
'[{"id":"gpt-6-astra","name":"GPT-6 Astra"}]' --strict-json --merge
# 再设为默认模型
openclaw models set openai/gpt-6-astraopenclaw.json 里对应的是两段配置一起写:
{
"models": {
"providers": {
"openai": {
"models": [{ "id": "gpt-6-astra", "name": "GPT-6 Astra" }]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "openai/gpt-6-astra"
}
}
}
}加上这条后,请求才会真正发往 https://api.openai.com/v1/responses。这个信号很有用,可以区分本地的模型名问题和其他问题。Unknown model 是 OpenClaw 自己抛出的,说明请求根本没有发出,换 key 也没用。只要回复中带有 OpenAI 的 request ID,就说明模型引用已经在本地解析成功。接下来根据返回内容判断——鉴权、组织权限、限流、请求参数,或者临时的服务端错误。升级到 2026.9.2 或更新的版本后,目录里已经带有 Astra,就可以删除这条声明。
自托管 Hermes Agent 配置
Hermes Agent 把提供商和模型名分开保存。先把 key 写入 ~/.hermes/.env:
OPENAI_API_KEY=sk-...再编辑 ~/.hermes/config.yaml:
model:
provider: "openai-api"
default: "gpt-6-astra"也可以运行 hermes model 配置 OpenAI 直连提供商。旧的 LLM_MODEL 环境变量已经不是配置来源。现有会话会继续使用旧模型,所以修改后请新建 Hermes 会话。
不要混用两套模型格式
| 框架 | 提供商 | 模型值 |
|---|---|---|
| OpenClaw | 内置 OpenAI 提供商,另加一条 models.providers.openai.models 声明 | openai/gpt-6-astra |
| Hermes Agent | openai-api | gpt-6-astra |
| OpenClaw Launch — Hermes Agent | openai | gpt-6-astra |
| OpenClaw Launch — OpenClaw | 等待托管端支持 | 等 OpenAI 分区出现 Astra |
| OpenClaw 走 OpenRouter | OpenRouter | openrouter/openai/gpt-6-astra |
| Hermes Agent 走 OpenRouter | openrouter | openai/gpt-6-astra |
Agent 工具能力与迁移注意事项
Astra 支持流式输出、函数调用和结构化输出。OpenAI 的 官方使用指南说明,网页与文件搜索、代码解释器、托管 Shell、电脑操作、MCP、Skills 和工具搜索等 Agent 能力要通过 Responses API 使用。Chat Completions 可以生成文字,但不能使用 Astra 的工具能力。
- 没有
none推理模式:原来使用none或minimal的工作流应改成low。 - 启用推理时移除采样参数:迁移时删除
temperature、top_p和top_logprobs;Chat Completions 还要删除logprobs。 - 检查 Skills 和 Agent 指令:Astra 会更严格地遵循仓库和 skill 文件,而且能操作强力工具。请缩小权限范围,对重要操作保留审批,并在无人值守前测试完整流程。
- 旧封装可能只支持部分新能力:Astra 新增异步工具调用、运行中引导、配置更新和监控。框架需要更新后,才能完整暴露这些能力。
切换前先精简 AGENTS.md 和 skills
Astra 执行指令文件时比以前的模型更严格,相当于一夜之间把宽松的提示词变成了严格的提示词。以前被忽略的规则,现在会被逐条执行;规则写得含糊,它会停下来找你确认;两条规则互相冲突,甚至可能让它卡住。OpenAI 给出的迁移建议是做减法:检查 AGENTS.md、SOUL.md 和 skill 文件,删掉当年为了迁就弱模型而添加的约束,别再继续往上堆。
OpenAI 还建议直接问模型,究竟是哪个 skill、哪一条指令让它停下来或改变方向。对于安装了大量 skill 的 bot,这是找出沉默规则和冲突规则最快的方法,对 OpenClaw 的 workspace 和 Hermes 的 skill 目录同样适用。
- 它更爱问问题: Astra 可能做到一半就停下来确认。如果提示词本身已经包含授权,就把话写清楚——告诉它,“能不能……”“帮我……”这类说法就是让它动手;可逆的工作先做完,再来请示。
- 它偏爱排版: Astra 默认会大量使用列表、表格和 Markdown。Telegram、WhatsApp 这类聊天渠道更适合成段的文字,可以要求它按段落写,只有内容确实平行时才使用列表。
- 用词会影响它的行为: 早期用户发现,要求它做到“很好”,它会继续推进;要求做到“完美”,则容易钻牛角尖。给它一个能够达到的标准。
- 它会拆给子智能体: Astra 的训练采用了并行子智能体协作。如果框架支持,最好明确调整它的拆分力度,不要任由它使用默认值。
- 推理档位可以中途改: 通过
configuration_update输入项就能提高或降低推理强度,无须重写提示词开头,缓存前缀也不会失效。
上线初期排错
- OpenClaw 报
Unknown model: openai/gpt-6-astra: 问题出在目录缺失,与 key 无关,且只会出现在 2026.9.2 之前的版本上。按上面的说明补充一条models.providers.openai.models声明。出现这个报错时,请求根本没有发出,换多少个 key 都没用。 - OpenAI 返回找不到模型或无权限: 先确认 API key 属于哪个组织。正确拼写是
gpt-6-astra。只要 OpenClaw 不再报Unknown model,就说明模型引用已经在本地解析成功。接下来应查看 OpenAI 的返回,无须再纠结模型名。 - 框架列表里没有:升级框架,检查提供商模型列表;如果产品支持,可使用自定义模型字段。
- 工具不执行:确认集成走 Responses API。Astra 的 Chat Completions 路线不提供工具调用。
- OpenRouter 调用失败: slug 是
openai/gpt-6-astra。如果填的是openai/gpt-6-astra-pro,请注意,OpenAI 的 API 文档只公布了gpt-6-astra这一个快照,回退到它即可。 - 账单突然变高:检查输入长度。超过 272,000 token 后,整个请求会按长上下文倍率计费。
一手资料
- OpenAI GPT-6 Astra 模型说明
- OpenAI GPT-6 Astra 使用与迁移指南
- OpenAI GPT-6 Astra 安全说明
- OpenClaw 模型提供商文档
- Hermes Agent 提供商文档
GPT-6 Astra 常见问题
GPT-6 Astra 真的上线了吗?
是,API 路线已经正常服务。OpenAI 于 2026 年 9 月 3 日发布 Astra,此后开放范围持续扩大。OpenRouter 已经上架 openai/gpt-6-astra,并通过 OpenAI 和 Azure 两条线路转发;ChatGPT 的高档付费计划也已经获得权限。OpenAI 自己的更新日志仍将这次上线描述为有限开放,目前主要还在等待的是 ChatGPT Plus。开放会按组织逐个推进,因此即使模型名拼写正确,尚未获得权限的账号仍会返回无权限。
OpenClaw 和 Hermes 分别用什么模型 ID?
OpenClaw 使用 openai/gpt-6-astra;Hermes Agent 则把提供商设为 openai-api,模型填 gpt-6-astra。OpenClaw 的值带提供商前缀,Hermes 的模型字段不带。OpenClaw 分版本:2026.9.2 及更新的版本已经把 Astra 收进内置目录,只写 ID 即可。更早的版本还不行,需要在 models.providers.openai.models 中额外注册一次,否则运行时会报 Unknown model。
Hermes Agent(爱马仕)能用 GPT-6 Astra 吗?
能。使用 Hermes Agent 的 OpenAI 直连提供商,把 OPENAI_API_KEY 写入 ~/.hermes/.env,再在配置中使用 openai-api 和 gpt-6-astra。改完要新建会话,而且该 OpenAI API 账号必须已经获得 Astra 权限。
可以直接用 ChatGPT 订阅驱动 GPT-6 Astra 吗?
Hermes Agent 可以,前提是账号已经开放。Hermes 直接从 ChatGPT 账号读取 Codex 模型目录,不读取发布版中写死的列表。因此账号一旦开放,Astra 就能选择。在 OpenClaw Launch 上,Hermes 的模型卡片读取的也是这份实时目录,会把 Astra 和已收录的订阅模型一起列出。OpenClaw 需要更新的版本,还多一个条件:OpenAI 会拒绝 OpenClaw 自带的内置 agent 调用 Astra,无论订阅是哪一档,所以这一轮必须交给 2026.9.2 起随附的 Codex app-server 来执行——它呈现的是真正的 Codex 客户端,而模型开关读取的正是这一点。在 OpenClaw Launch 上,只要机器人本身运行 2026.9.2 或更新的版本,订阅分组里就会出现这一行,选中它会同时写入该模型所需的 app-server 配置;仍在旧版本上的机器人看不到这一行,需要先升级。
OpenRouter 已经有 GPT-6 Astra 吗?
已经有了。OpenRouter 于 2026 年 9 月 4 日上架 Astra,目前共有四个 slug:openai/gpt-6-astra、openai/gpt-6-astra:batch、openai/gpt-6-astra-pro 和 openai/gpt-6-astra-pro:batch,流量同时经由 OpenAI 和 Azure 两条线路。标准价格与 OpenAI 官方一致,:batch 版本为半价。需要注意,OpenAI 的 API 模型文档只列出了 gpt-6-astra 这一个快照,pro 级算力通过推理模式提供,因此 -pro 更像是 OpenRouter 的路由写法。
GPT-6 Astra API 多少钱?
标准价格为每百万输入 token 10 美元、缓存输入 1 美元、缓存写入 12.50 美元、输出 50 美元。Batch 和 Flex 按这个价格的 50% 计费,Fast 则是 2 倍。单次请求的输入超过 272,000 token 后,整个请求都会采用更高的长上下文倍率。