C Codex + OpenClaw 安装配置综合指南 选择系统

官方原版安装

Codex 与 OpenClaw 安装配置综合指南

前半部分按 Windows、Linux/macOS 两条系统路径整理 Codex 安装与配置；后半部分单独整理 OpenClaw 接入配置和常见问题。

按系统开始 配置 OpenClaw
⌘ macOS / Linux 终端安装、创建 ~/.codex、验证 codex -V ⊞ Windows PowerShell 安装、配置 C:\Users\你的用户名\.codex OC 配置 OpenClaw 已安装 Codex 后，再配置 OpenClaw 的模型接入

macOS / Linux

Codex 官方原版安装

此流程使用官方原版安装包。系统要求为 macOS 10.15+ 或主流 Linux 发行版。

03

安装 Codex 官方原版包

npm install -g @openai/codex

# 或者 macOS 使用 Homebrew
brew install codex
04

创建配置目录

删除旧配置目录后重新创建，避免旧文件影响新配置。

rm -rf ~/.codex
mkdir ~/.codex
05

创建 auth.json

在 API 密钥页面创建并复制新的 API Key，然后写入 ~/.codex/auth.json。

{
  "OPENAI_API_KEY": "你的 API_KEY"
}
06

创建 config.toml

删除已存在的 config.toml 后新建文件，内容直接复制下方配置。

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.eidolon-ai.com/v1"
wire_api = "responses"
requires_openai_auth = true
07

重启终端并验证

重启终端后运行版本命令。安装完成后可在任意项目目录启动 Codex。

codex -V
cd your-project-folder
codex

Windows

PowerShell 安装 Codex

系统要求为 Windows 10 1809（build 17763）及以上。安装前先完成 Git 和 Node.js，再继续 Codex 配置流程。

03

验证安装情况

打开 Windows PowerShell（蓝色图标），执行以下命令验证。

node -v
npm -v
04

安装 Codex 官方原版包

国内网络访问 npm 较慢时，可使用 npm 镜像源。

npm install -g @openai/codex

npm i -g @openai/codex --registry=https://registry.npmmirror.com
05

创建配置目录

先删除旧目录（若有），再重新创建 C:\Users\你的用户名\.codex。

C:\Users\你的用户名\.codex
06

创建 auth.json

在 API 密钥页面创建并复制新的 API Key，写入 auth.json。

{
  "OPENAI_API_KEY": "你的 API_KEY"
}
07

创建 config.toml

删除已有文件后新建，内容原封不动粘贴。

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.eidolon-ai.com/v1"
wire_api = "responses"
requires_openai_auth = true
08

重启终端并验证

codex -v
cd your-project-folder
codex

独立配置模块

配置 OpenClaw 接入 Codex API

OpenClaw 配置不是 Codex 安装步骤的一部分。前面完成 Codex 安装和 API 配置后，这里只处理 OpenClaw 的安装、自检和模型接入。

前置条件

先完成 Codex 安装配置

确认 Codex 能正常启动，并且 .codex/auth.json 与 .codex/config.toml 已经写好。

codex -V
codex
OpenClaw 安装

按系统安装 OpenClaw

这是 OpenClaw 自身安装流程，和前面的 Codex CLI 安装分开处理。

curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
自检

确认 OpenClaw 可用

安装后先检查 OpenClaw 自身状态，再进入模型配置。

openclaw --version
openclaw doctor
openclaw status
openclaw dashboard
openai-responses

配置 OpenClaw 的 models

如果已安装 OpenClaw，仅想接入本站 API，可打开 OpenClaw 配置文件，将其中 models 部分替换为下面内容，并把 apiKey 换成自己的 Key。

macOS/Linux：~/.openclaw/openclaw.json

Windows：C:\Users\你的用户名\.openclaw\openclaw.json

{
  "models": {
    "providers": {
      "aicodemirror-gpt": {
        "baseUrl": "https://www.fluapi.com/v1",
        "apiKey": "替换为你自己的 key",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "gpt-5.4",
            "reasoning": true,
            "input": ["text", "image"]
          }
        ]
      }
    }
  }
}

也可以让 Codex 辅助写入 OpenClaw 配置

如果 OpenClaw 配置不顺，可以先启动 Codex，然后输入下面这句话。保存后执行 openclaw doctor 检查。

codex

请把用户目录下.codex api 配置到openclaw中，注意是response格式。

openclaw doctor

FAQ

常见问题

codex 命令未找到

检查 npm 全局安装路径，并确认该路径已加入系统 PATH。Windows 默认通常是 C:\Users\你的用户名\AppData\Roaming\npm。

npm config get prefix

安装时权限不足

Windows 可尝试以管理员身份运行 PowerShell。macOS/Linux 可检查 npm 全局目录权限，或使用 Node.js 版本管理工具重新安装。

API 连接失败

确认 base_url、wire_api、model_provider 和 auth.json 中的 API Key 都正确。

echo $env:OPENAI_BASE_URL
echo $env:OPENAI_API_KEY

Node.js 版本过低

查看当前版本。如果版本过低，请到 Node.js 官网安装最新 LTS 版本。

node --version