TokenYep.COM -AI大模型中转站支持一个 Key 调用近 600+ 海内外模型,限时特价模型低至 1 折,欢迎上岸!
openai/* 和 openai-codex/* 的轮次交由 Codex CLI app-server 处理,而不是运行自己的工具循环。启用后,终端命令、文件编辑、沙箱隔离以及 MCP 工具调用均在 Codex 的运行时内执行——Hermes 成为其外层 shell(会话数据库、斜杠命令、gateway、记忆与技能审查)。shell 用于终端/读/写/搜索,apply_patch 用于结构化编辑,update_plan 用于规划,全部在 seatbelt/landlock 沙箱内运行。codex plugin 安装后,会自动迁移并在你的 Hermes 会话中激活。codex app-server 本身一起提供——无需 Hermes 介入,无需 MCP,无需插件。运行时启动后,以下五个工具立即可用:shell — 在沙箱内运行任意 shell 命令。模型通过此工具读取文件(cat、head、tail)、写入文件(echo > foo、heredoc)、搜索文件(find、rg、grep)、浏览目录(ls、cd)、运行构建、管理进程,以及其他任何你在 bash 中能做的事。apply_patch — 以 Codex 的 patch 格式应用结构化的多文件差异。模型将此工具用于非简单的代码编辑(添加函数、跨文件重构);单次写入仍可使用 shell heredoc。update_plan — Codex 的内部待办/计划跟踪器。等同于 Hermes 的 todo 工具,但完全在 Codex 运行时内部管理。view_image — 将本地图像文件加载到对话中,使模型能够查看它。web_search — 配置后 Codex 拥有自己的内置网络搜索。Hermes 也通过下方的回调暴露 web_search(基于 Firecrawl);模型会选择其偏好的那个。:workspace)控制可写范围。codex plugin 安装中自动迁移)plugin/list RPC,并为你已安装的每个插件写入一条 [plugins."<name>@openai-curated"] 配置项。插件本身由 Codex 管理,并通过 Codex 自己的 UI 完成一次性授权。codex plugin marketplace add openai-curated + codex plugin install ... 安装的插件app/list)——这些已通过你的账户认证在 Codex 内部启用。~/.codex/config.toml 中)web_search / web_extract — 基于 Firecrawl;对于结构化内容,通常比直接抓取更干净。browser_navigate / browser_click / browser_type / browser_press / browser_snapshot / browser_scroll / browser_back / browser_get_images / browser_console / browser_vision — 通过 Camofox 或 Browserbase 实现完整的浏览器自动化。vision_analyze — 调用独立的视觉模型检查图像(与 Codex 的 view_image 不同,后者是将图像加载到对话中)。image_generate — 通过 Hermes 的 image_gen 插件链生成图像。skill_view / skills_list — 读取 Hermes 的技能库。text_to_speech — 通过 Hermes 配置的提供商进行 TTS。hermes_tools_mcp_server 子进程,调用通过 model_tools.handle_function_call() 分发(与 Hermes 默认运行时的代码路径相同),结果像其他 MCP 响应一样返回给 Codex。/codex-runtime auto):delegate_task — 生成子 agentmemory — Hermes 的持久记忆存储session_search — 跨会话搜索todo — Hermes 的待办存储(Codex 的 update_plan 是运行时内的等效工具)/goal、kanban、cron)/goal(Ralph 循环)state_meta 中,续接提示通过 run_conversation() 作为普通用户消息回传,Codex 原生执行下一轮次。目标判断器通过辅助客户端运行(在 config.yaml 中通过 auxiliary.goal_judge 配置),与当前活跃的运行时无关。判断器的"受阻,需要用户输入"裁决是 Codex 卡在审批时的干净退出路径。default_permissions = ":workspace"(启用运行时时 Hermes 会自动设置)可避免简单的工作区写操作触发提示。hermes chat -q 子进程,该子进程读取用户配置——这意味着如果全局设置了 model.openai_runtime: codex_app_server,worker 也会在 Codex 运行时上启动。kanban_complete / kanban_block / kanban_comment / kanban_heartbeat — worker 交接工具。这些工具从环境变量中读取 HERMES_KANBAN_TASK(由分发器设置),正确进行访问控制,并写入由 HERMES_KANBAN_DB 固定的每个看板 SQLite 数据库。若回调中没有这些工具,此运行时上的 worker 可以完成任务但无法汇报,会一直挂起直到分发器超时。kanban_show / kanban_list — 只读看板查询,供 worker 检查自身上下文。kanban_create / kanban_unblock / kanban_link — 仅限编排器的操作。供运行在 Codex 运行时上、需要分发新任务的编排器 agent 使用。HERMES_KANBAN_TASK 环境变量进行访问控制——该变量会传播到 Codex 子进程(Codex 继承环境变量),再从那里传播到生成的 hermes-tools MCP server 子进程。因此工具能看到正确的任务 id 并正确进行访问控制。对于 Codex app-server worker,当 HERMES_KANBAN_TASK 存在时,Hermes 还会传入精细的 app-server 沙箱覆盖配置:保持 workspace-write 沙箱,将看板数据库目录以及分发器固定的所有 Kanban 路径作为额外可写根目录添加(HERMES_KANBAN_WORKSPACES_ROOT、HERMES_KANBAN_WORKSPACE、旧版 HERMES_KANBAN_ROOT——去重,数据库目录优先),并默认禁用网络。这避免了脆弱的 :danger-no-sandbox 变通方案,同时允许 kanban_complete / kanban_block 更新看板数据库,并 且允许 worker 在数据库目录之外的工作区挂载点下写入报告/产物(例如独立驱动器上的 /media/.../kanban-workspaces/...——issue #27941)。cronjob → AIAgent.run_conversation 运行,与 CLI 的代码路径相同。如果 cron 任务的配置中有 openai_runtime: codex_app_server,它将在 Codex 上运行。相同的工具可用性规则适用——Codex 内置工具 + 插件 + MCP 回调可用,agent 循环工具(delegate_task、memory、session_search、todo)不可用。如果你的 cron 任务依赖这些工具,请将 cron 限定在使用默认运行时的配置文件中。| Hermes 默认运行时 | Codex app-server(可选启用) | |
|---|---|---|
delegate_task 子 agent | 是 | 不可用——需要 agent 循环上下文 |
memory、session_search、todo | 是 | 不可用——需要 agent 循环上下文 |
web_search、web_extract | 是 | 是(通过 MCP 回调) |
| 浏览器自动化(Camofox/Browserbase) | 是 | 是(通过 MCP 回调) |
vision_analyze、image_generate | 是 | 是(通过 MCP 回调) |
skill_view、skills_list | 是 | 是(通过 MCP 回调) |
text_to_speech | 是 | 是(通过 MCP 回调) |
Codex shell(终端/读/写/搜索/查找/运行) | — | 是(Codex 内置) |
Codex apply_patch(结构化多文件编辑) | — | 是(Codex 内置) |
Codex update_plan(运行时内待办) | — | 是(Codex 内置) |
Codex view_image(将图像加载到对话) | — | 是(Codex 内置) |
| Codex 沙箱(seatbelt/landlock,配置文件) | — | 是(Codex 内置) |
| ChatGPT 订阅认证 | — | 是(通过 openai-codex 提供商) |
| 原生 Codex 插件(Linear、GitHub 等) | — | 是(自动迁移) |
| 用户 MCP server | 是 | 是(自动迁移到 Codex) |
| 记忆 + 技能审查(后台) | 是 | 是(通过事件投影) |
| 多轮对话 | 是 | 是 |
/goal(Ralph 循环) | 是 | 是 |
| Kanban worker 分发 | 是 | 是(通过回调) |
| Kanban 编排器工具 | 是 | 是(通过回调) |
| 所有 gateway 平台 | 是 | 是 |
| 非 OpenAI 提供商 | 是 | 不适用——仅限 OpenAI/Codex |
~/.codex/auth.json。有两种方式填充它:hermes auth login codex 写入 ~/.hermes/auth.json——那是独立的会话。如果你还没有运行过 codex login,请单独运行它。[plugins."<name>@openai-curated"] 条目写入 ~/.codex/config.toml。/codex-runtime codex_app_servercodex CLI 是否已安装(若未安装则阻止并提示安装方法)。model.openai_runtime: codex_app_server 持久化到你的 config.yaml。~/.hermes/config.yaml 迁移到 ~/.codex/config.toml。plugin/list RPC 实现。default_permissions = ":workspace",使沙箱允许在工作区内写入,无需对每次操作进行提示。/codex-runtime on、/codex-runtime off、/codex-runtime auto。/codex-runtime