命令和诊断
/codex 斜杠命令交互面及其周边的诊断路径。属于 Codex harness 指南的一部分;各章节迁移位置 列出了每个章节。
命令与诊断¶
codex 插件会在任何支持 OpenClaw 文本命令的频道上将 /codex 注册为斜杠命令。
原生执行、控制以及主机级检查需要所有者或 operator.admin Gateway 客户端。这包括绑定或恢复线程、发送或停止轮次、更改模型、快速模式或许可状态、压缩或审查、解除绑定,以及检查账户详情、主机状态、原生线程、配对节点会话、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.admingateway 客户端。/codex computer-use [status|install]管理 Codex Computer Use。/codex help列出完整命令树。
当 /codex resume 附加一个没有现有已验证 harness 绑定的线程时,其下一个轮次会检查原生线程存储的工具目录,并在继续之前应用当前 harness 配置。这种首次附加需要本地 stdio 应用服务器及其每个代理的 Codex 主目录。目标原生线程必须处于空闲状态。OpenClaw 协调该线程的附加、恢复和释放;无关的聊天和目录读取可以继续在同一应用服务器上进行。如果目标线程处于活动状态,请等待其轮次完成,然后重试。使用 Codex supervision 或原生 Codex 在共享用户主目录中或另一应用服务器上继续线程。
由父线程控制的原生子线程无法通过 /codex resume 或 /codex bind 附加。OpenClaw 会报告该限制并保留当前绑定。请改为通过其原生父线程继续子线程。
Codex 无法在恢复期间替换线程的动态工具目录。如果该目录与当前 harness 工具不同、其元数据无法读取,或者 Codex 无法确认已应用该配置,OpenClaw 会报告问题并保持所选原生线程不变。它不会静默启动另一个线程。使用 /new 以当前 harness 工具开始,或在原生 Codex 中继续保留的线程。
如果普通的 OpenClaw 管理原生线程已被删除,下一个轮次将启动一个新的原生线程,同时保留所选模型和提供者。这种恢复会保留挂起的手动附加和原生模型拥有的线程。它不会重放原生结果不确定的轮次。
共享 Fast 模式与 Codex fast 模式¶
/fast 控制共享的 OpenClaw 策略。仅指令形式的 /fast off 会在 OpenClaw 会话中持久化 off,并在受影响的 Codex harness 轮次中发送 null,以清除 OpenClaw 拥有的服务层级覆盖。/fast default 仅清除该会话层,因此较低优先级的共享默认值仍可能解析为 on、off、auto 或 ultrafast。
/codex fast 则更改绑定的原生 Codex 会话偏好。/codex fast off 为后续绑定会话的原生轮次存储 flex;它不是 /fast off 的同义词,也不会更改共享的 OpenClaw 会话策略。当共享 Fast 模式运行控制到达 Codex harness 轮次时,它会取代 plugins.entries.codex.config.appServer.serviceTier 以及任何适用于该轮次的绑定偏好:Fast on 从 priority 开始,Fast off 发送 null,auto 则为每次模型调用决定。仅在未提供共享运行控制时,才使用已配置或绑定的原生层级。
Ultrafast 需要一个有效的共享 "ultrafast" 选择,该选择来自会话、运行控制或已编写的 fastModeDefault: "ultrafast",并且需要一个已认证的 app-server 目录,该目录为所选原生模型声明该选项。未设置 appServer.enableUltrafast 或值为 true 时,允许该选择;false 则改为发送普通 Fast(priority),并跳过 Ultrafast 目录检查。Fast、激活的 Auto 以及未指定的控制项永远不会自动升级。原生 serviceTier:
"ultrafast" 也会从 priority 开始,直到共享选择请求它。Standard 和未激活的 Auto 保持关闭。
有关目录检查和回退行为,请参阅 app-server 传输。
/codex fast status 和 /codex binding 报告的是原生偏好状态,而不是处理已完成 provider 请求的上游层级。
对于大多数支持报告,请从发生问题的会话中的 /diagnostics [note] 开始。它会创建一个 Gateway 诊断报告,并且对于 Codex harness 会话,会请求批准以发送相关的 Codex 反馈包。有关隐私模型和群聊行为,请参阅 诊断导出。只有当你确实希望上传当前附加线程的 Codex 反馈,而不需要完整的 Gateway 诊断包时,才使用 /codex diagnostics [note]。
在本地检查 Codex 线程¶
检查异常 Codex 运行的最快方式通常是直接打开原生 Codex 线程:
从已完成的 /diagnostics 回复、/codex binding 或 /codex threads [filter] 中获取线程 ID。
有关上传机制和运行时级别的诊断边界,请参阅 Codex harness 运行时。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw