AI精品店

Appearance

OpenClaw UI 界面配置（Codex） ​

OpenClaw 提供了可视化管理界面，无需手动编辑 JSON 文件，通过图形界面即可完成服务商配置。

还没装过 OpenClaw？

先运行官方一键安装，再回来配置：

bash
curl -fsSL https://openclaw.ai/install.sh | bash

下载安装 ​

macos 可能会无法打包报错，请使用 sudo xattr -d com.apple.quarantine /Applications/OpenClaw Manager.app/ 跳过一下安全信任。

下载后按正常应用安装流程安装即可。Windows 和 macOS 的配置方式完全一样。

第一步：打开软件 → 环境检查 ​

安装完成后打开软件，进入主界面后先做环境检查。软件需要 Node.js 和 OpenClaw 环境才能正常运行。

环境检查界面

如果提示缺少 nodejs 或 openclaw，直接点击对应的安装按钮，软件会自动完成安装。

第二步：配置 AI 模型 ​

1. 点击「添加 provider」 ​

环境检查通过后，点击「添加 provider」按钮开始添加服务商。

点击添加 provider

2. 选择 OpenAI ​

在服务商类型列表中选择 OpenAI（codexzh 使用 OpenAI 兼容协议）。

选择 OpenAI

3. 填写配置信息 ​

按照下图填写各项配置：

填写配置信息

各字段说明：

  • Provider 名称：随便填，建议填 codexzh 方便识别
  • API 地址：填 https://api.codexzh.com/v1（末尾带 /v1）
  • API Key：登录 codexzh 控制台 复制你的 API Key（sk- 开头）
  • API 类型：暂时选 openai-completions，后续我们会手动改成 openai-responses
  • 自定义模型：添加 gpt-5.4（或其他你想用的模型）

填写完成后点击保存。

4. 设置主模型 ​

保存后，在模型列表中找到刚才添加的 gpt-5.4，点击设为主模型。

设置主模型

第三步：修改配置文件（重要！） ​

⚠️ 这一步不能跳过。

UI 界面目前只支持选择 openai-completions 协议，但这个协议对工具调用支持不好。codexzh 支持更好的 openai-responses 协议，需要手动改一下配置文件。

找到配置文件 ​

  • Windows：C:\Users\你的用户名\.openclaw\openclaw.json
  • macOS / Linux：~/.openclaw/openclaw.json

修改协议字段 ​

用文本编辑器打开 openclaw.json，找到 "api": "openai-completions" 这一行，改成：

json
"api": "openai-responses"

修改后示例（只需关注 api 字段）：

修改配置文件

保存文件后重启 gateway 生效：

bash
openclaw gateway stop
openclaw gateway --port 18789

第四步：配置消息渠道（可选） ​

如果你需要 Telegram 等通知功能，可以在软件的「消息渠道」页面按说明配置，操作非常简单。

消息渠道配置

配置完成 ​

完成以上步骤后，OpenClaw 已经成功接入 codexzh。

启动命令：

bash
openclaw config set gateway.mode local
# 如果需要远程访问将local 改成 remote
# openclaw config set gateway.mode remote
openclaw gateway --port 18789

之后在 Codex 中将 API 地址指向 http://localhost:18789 即可使用。

如需进一步了解配置文件结构，请查看手动配置文档。