命令与诊断

/codex 斜杠命令界面及其周边的诊断路径。本文是 Codex 集成框架 指南的一部分；各章节去向 列出了每个章节。

命令与诊断¶

codex 插件会在任何支持 OpenClaw 文本命令的频道上注册 /codex 为斜杠命令。

原生执行、控制以及主机范围的检查需要所有者或 operator.admin Gateway 客户端。这包括绑定或恢复线程、发送或停止回合、更改模型、Fast 模式或权限状态、压缩或审查、解除绑定，以及检查账户详情、主机状态、原生线程、配对节点会话、MCP 服务器或技能。

其他被授权的发送者仍可获得帮助、模型列表，并对其当前会话的绑定、模型、权限、Fast 模式和原生目标进行只读检查。主机范围的读取受到限制，因为它们可能暴露其他会话、私有工作区、账户身份和已连接的服务。

常见形式：

• /codex status 检查应用服务器连通性、模型、账户、速率限制、MCP 服务器和技能。
• /codex models 列出当前可用的 Codex 应用服务器模型。
• /codex threads [filter] 列出最近的 Codex 应用服务器线程。
• /codex goal 读取或更新已附加线程的原生 Codex 目标。Codex 自动目标延续保持禁用；OpenClaw 尚不支持自主的后续回合。
• /codex resume <thread-id> 将当前 OpenClaw 会话附加到现有 Codex 线程。
• /codex bind [thread-id] [--cwd <path>] [--model <model>] [--provider <provider>] 附加当前聊天会话。
• /codex detach（或 /codex unbind）解除当前绑定。
• /codex binding 描述当前绑定。
• /codex stop 停止当前活动回合；/codex steer <text> 引导该回合。
• /codex model <model>、/codex fast [on|off|status] 和 /codex permissions [default|yolo|status] 更改每个会话的状态。权限参数 default（也可用 guardian、guarded 或 approve）选择 guarded；它不会清除会话权限模式。yolo 选择完全访问权限，并且需要 operator.admin，即使发送者是所有者也不例外。仅当未设置会话权限模式时，状态才显示 default。
• /codex compact 运行与 /compact 相同的完成和会话核算流水线，然后报告 Codex 是否压缩了会话以及最终的 token 数量。如果压缩被跳过或失败，回复中会包含原因。
• /codex review 为附加的线程启动 Codex 原生审查。
• /codex diagnostics [note] 在发送关于附加线程的 Codex 反馈前会先询问。
• /codex account 显示所选连接的账户和速率限制状态。原生 Codex 账户与已保存的 OpenClaw 配置文件保持分离，即使它们共享同一个电子邮件地址也是如此。如果两项读取都失败，该命令会报告该连接的错误。
• /codex mcp 列出 Codex 应用服务器的 MCP 服务器状态。
• /codex skills 列出 Codex 应用服务器的技能。
• /codex plugins list 显示已配置的原生插件；/codex plugins available 在绑定的工作区中发现 Codex 市场插件。
• /codex plugins install <plugin>@<marketplace> 安装并授权一个已发现的插件。/codex plugins enable <name> 和 /codex plugins disable <name> 更新其持久化策略。变更操作需要所有者或 operator.admin Gateway 客户端。
• /codex computer-use [status|install] 管理 Codex Computer Use。
• /codex help 列出完整的命令树。

当 /codex resume 附加一个没有已验证集成框架绑定的线程时，该线程的下一个回合会检查原生线程存储的工具目录，并在继续之前应用当前的集成框架配置。此首次附加需要本地 stdio 应用服务器及其为每个代理准备的 Codex 主目录。目标原生线程必须处于空闲状态。OpenClaw 协调该线程的附加、恢复和释放；不相关的聊天和目录读取可以继续在同一应用服务器上进行。如果目标线程处于活动状态，请等待其回合完成后重试。使用 Codex 监督 或原生 Codex 在共享用户主目录或另一应用服务器上继续线程。

由父线程控制的原生子线程无法通过 /codex resume 或 /codex bind 附加。OpenClaw 会报告此限制并保留当前绑定。请改为通过其原生父线程继续子线程。

Codex 无法在恢复期间替换线程的动态工具目录。如果该目录与当前的集成框架工具不同、其元数据无法读取，或 Codex 无法确认它已应用该配置，OpenClaw 会报告问题并保持所选的原生线程完好无损。它不会静默地启动另一个线程。使用 /new 以当前的集成框架工具开始，或在原生 Codex 中继续已保留的线程。

如果某个由 OpenClaw 管理的普通原生线程已被删除，下一个回合将启动一个新的原生线程，同时保留所选的模型和提供方。此恢复会保留待处理的手动附加以及由原生模型拥有的线程。它不会重放原生结果不确定的回合。

共享 Fast 模式与 Codex Fast 模式¶

/fast 控制共享的 OpenClaw 策略。当 /fast off 仅以指令形式使用时，它会在 OpenClaw 会话中持久化 off，并在受影响的 Codex 集成框架回合中发送 null，以清除 OpenClaw 拥有的服务层级覆盖。/fast default 仅清除该会话层，因此优先级较低的共享默认值仍可能解析为 on、off 或 auto。

/codex fast 则更改绑定的原生 Codex 会话偏好。/codex fast off 为后续绑定会话的原生回合存储 flex；它不是 /fast off 的同义词，也不会更改共享的 OpenClaw 会话策略。当共享的 Fast 模式运行控制到达 Codex 集成框架回合时，它会取代 plugins.entries.codex.config.appServer.serviceTier 以及任何适用于该回合的绑定偏好：Fast 开启时发送 priority，Fast 关闭时发送 null，而 auto 则针对每次模型调用自行决定。仅当未提供共享运行控制时，才使用已配置或绑定的原生服务层级。

/codex fast status 和 /codex binding 报告的是本地偏好状态，而不是处理已完成提供商请求的上游层级。

对于大多数支持报告，请从发生问题的会话中的 /diagnostics [note] 开始。它会创建一个 Gateway 诊断报告，并且对于 Codex harness 会话，会请求批准发送相关的 Codex 反馈包。有关隐私模型和群聊行为，请参阅 诊断导出。仅当你确实希望上传当前附加线程的 Codex 反馈，而不需要完整的 Gateway 诊断包时，才使用 /codex diagnostics [note]。

在本地检查 Codex 线程¶

检查异常 Codex 运行的最快方式通常是直接打开原生 Codex 线程：

codex resume <thread-id>

从已完成的 /diagnostics 回复、/codex binding 或 /codex threads [filter] 中获取线程 ID。

有关上传机制和运行时级别的诊断边界，请参阅 Codex harness 运行时。