通过结构化 JSON 配置流程管理 Codex CLI 设置、权限、模型、沙箱行为和用户偏好。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install update-cli-config
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 update-cli-config。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 Codex CLI 配置管理器？
此 Openclaw Skills 功能为查看和修改存储在 ~/.cursor/cli-config.json 中的 Codex CLI 配置提供安全、结构化的工作流程。它帮助开发者管理工具权限、审批行为、编辑器偏好、显示设置、沙箱网络、模型选择、发布渠道和其他 CLI 控制项，而无需手动猜测配置架构。
该技能还说明项目级 .cursor/cli.json 文件如何在当前会话中覆盖用户主目录级设置。它区分可编辑偏好与应保持不变的内部缓存字段，帮助用户在保留身份验证、模型选择器和架构状态的同时可靠地应用配置更改。
Codex CLI 配置管理器 应用场景
- 使用
allow和deny模式更改 Codex CLI 工具权限。 - 在以审批为导向的工作流程和自动工具执行模式之间切换。
- 启用 Vim 键绑定、行号、思考块或状态指示器。
- 配置沙箱执行、网络访问策略和域名允许列表。
- 选择
prod、lab或static等发布渠道。 - 启用 max 模式，或配置 Explore 子代理模型的继承、禁用或固定。
- 为基于 SSE 的流式传输配置 HTTP/1.1 代理连接。
- 设置 AWS Bedrock 访问权限、区域、测试模型和团队 IAM 角色设置。
- 控制代理编写的提交和拉取请求是否获得署名。
- 应用项目专用 CLI 覆盖设置，而不更改全局主目录配置。
Codex CLI 配置管理器 工作原理
- 确定请求的更改应写入全局
~/.cursor/cli-config.json文件，还是项目级.cursor/cli.json覆盖文件。 - 在进行更改前读取现有 JSON 配置，以保留无关设置。
- 根据受支持的 Codex CLI 架构验证请求字段，包括布尔值、枚举、数组、权限模式以及嵌套的模型或沙箱对象。
- 只更新相关的可编辑设置，保持
authInfo、privacyCache和模型选择器状态等内部或缓存字段不变。 - 将有效 JSON 写回适当的配置文件。
- 重启 Codex CLI，因为配置更改会在 CLI 重启后生效。
- 在存在项目覆盖时确认优先级：CLI 从 Git 根目录遍历到当前目录，当前会话中更深层的
.cursor/cli.json文件具有更高优先级。
Codex CLI 配置管理器 配置指南
无需安装软件包。该技能操作的是用户环境中已经存在的 Codex CLI JSON 配置。
- 编辑前备份全局配置：
cp ~/.cursor/cli-config.json ~/.cursor/cli-config.json.backup
- 检查当前配置：
cat ~/.cursor/cli-config.json
- 对于项目范围设置，从项目目录检查或创建覆盖文件：
mkdir -p .cursor
touch .cursor/cli.json
将有效的 JSON 更改应用到选定文件。保留必需的
permissions设置，并为approvalMode、sandbox.mode、channel和editor.defaultBehavior等字段使用受支持的值。重启 CLI 前验证 JSON：
python -m json.tool ~/.cursor/cli-config.json
- 重启 Codex CLI 以启用更新后的配置。不要手动修改包括
version、model、selectedModel、modelParameters、privacyCache、authInfo或其他缓存 UI 状态在内的内部字段。
Codex CLI 配置管理器 数据架构与分类体系
配置位置
| 位置 | 范围 | 优先级 |
|---|---|---|
~/.cursor/cli-config.json |
全局用户配置 | 基础配置 |
.cursor/cli.json |
项目和目录专用覆盖 | 当前会话中更深层文件覆盖更浅层文件 |
可编辑设置组
| 组 | 重要字段 | 用途 |
|---|---|---|
permissions |
allow、deny |
匹配允许和拒绝的工具调用，例如 Shell(**) 或 Mcp(server-name, tool-name) |
editor |
vimMode、defaultBehavior |
配置输入键绑定以及默认的 ide 或 agent 行为 |
display |
showLineNumbers、showThinkingBlocks、showStatusIndicators |
控制 CLI 展示和状态可见性 |
channel |
prod、lab、static |
选择发布渠道 |
maxMode |
布尔值 | 启用更高质量的模型响应 |
subagentModels |
explore |
使用、继承、禁用或固定 Explore 子代理模型及其参数 |
approvalMode |
allowlist 或文档所述的非 allowlist 模式 |
控制工具调用是否需要审批 |
sandbox |
mode、networkAccess、networkAllowlist |
限制执行和网络连接 |
network |
useHttp1ForAgent |
为代理连接使用 HTTP/1.1 和基于 SSE 的流式传输 |
bedrock |
enabled、mode、region、testModel、角色字段 |
配置 AWS Bedrock 集成 |
attribution |
attributeCommitsToAgent、attributePRsToAgent |
控制 Git 提交和拉取请求署名 |
webFetchDomainAllowlist |
字符串数组 | 将网页抓取访问限制为已批准的域名 |
受保护的内部状态
不要手动编辑 version、model、selectedModel、modelParameters、hasChangedDefaultModel、privacyCache、authInfo、showSandboxIntro 或 conversationClassificationScoredConversations。这些字段由 CLI、模型选择器、身份验证系统或内部缓存管理。
Codex CLI 配置管理器 高级特性
- 分层项目覆盖允许目录专用行为，同时保持全局设置不变。
- 权限模式支持针对 Shell 命令和 MCP 工具的细粒度允许与拒绝规则。
- Explore 子代理配置支持使用默认、继承、禁用或明确固定的模型，并可设置可选参数和 max 模式。
- 可以保持旧版
exploreSubagentModel兼容性，以便与较旧 CLI 版本同步。 - 沙箱网络策略支持用户配置的默认设置、更广泛的访问权限和明确的域名允许列表。
- AWS Bedrock 配置支持访问密钥和团队角色模式，包括 IAM 角色 ARN 和 STS 外部 ID 设置。
- 网页抓取域名允许列表可以将访问限制为确切域名、通配符子域名或更广泛的模式。
- HTTP/1.1 代理连接可在需要时启用基于 SSE 的流式传输。
- Git 署名控制使代理参与提交和拉取请求的情况明确可见。
- Openclaw Skills 指南将用户可编辑偏好与受保护缓存状态分开，以减少配置损坏。
SKILL.md
加载中
Openclaw 相关技能
精选*
