Codex 接入聚星逸 · OpenClaw Skill

让 Codex 桌面版/CLI 使用聚星逸网关调用 50+ 大模型，并让 AI Agent 感知 Codex 的工作状态。

前置条件

• macOS（ChatGPT 桌面版仅支持 macOS/Windows）
• jq 已安装（brew install jq）
• curl 已安装（macOS 自带）
• 聚星逸 API Key（在 https://fireworks-simulator.huo15.com/app/ 控制台创建，fsk- 开头）

环境变量

使用方式

步骤 1：安装 Codex

bash skills/codex-juxingyi-setup/scripts/install.sh

检测并安装：

• ChatGPT 桌面版（含 Codex 面板）：检测 /Applications/ChatGPT.app，未安装则引导 brew install --cask chatgpt 或手动下载
• Codex CLI：检测 which codex，未安装则 npm install -g @openai/codex

已安装则报告版本并跳过。

步骤 2：配置聚星逸接入

# 交互式配置（会询问 API Key 和模型选择）
bash skills/codex-juxingyi-setup/scripts/configure.sh

# 非交互式（CI/自动化场景）
JUXINGYI_API_KEY="fsk-xxxx" JUXINGYI_MODEL="deepseek-v4-flash" \
  bash skills/codex-juxingyi-setup/scripts/configure.sh

配置过程：

1. 备份现有 ~/.codex/config.toml
2. 从聚星逸 GET /v1/models 拉可用模型列表
3. 写入聚星逸 provider 配置（保留原有 plugins/mcp_servers/projects 段）
4. 验证连通性（用配置的 key 调一次 /v1/models）

写入的配置段：

model_provider = "juxingyi"
openai_base_url = "https://fireworks-simulator-api.huo15.com/v1"
model = "deepseek-v4-flash"

步骤 3：Agent 感知 Codex 工作

# 查看 Codex 当前状态（模型、provider、最近会话、活跃项目）
bash skills/codex-juxingyi-setup/scripts/codex-status.sh

# 列出最近 10 条会话
bash skills/codex-juxingyi-setup/scripts/codex-sessions.sh --limit 10

# 查看某条会话详情
bash skills/codex-juxingyi-setup/scripts/codex-sessions.sh --detail <session_id>

# 聚合全部上下文（供 Agent 一次性读取）
bash skills/codex-juxingyi-setup/scripts/codex-context.sh

Agent 感知内容：

复用说明

其他 OpenClaw 实例复用本 skill：

1. 复制目录：cp -r skills/codex-juxingyi-setup /目标路径/
2. 设置环境变量（可选）：

   export JUXINGYI_API_BASE="https://your-gateway.example.com/v1"  # 自定义网关
   export CODEX_HOME="$HOME/.codex"  # 自定义 Codex 目录
   

3. 运行：按上述三步执行即可
4. 无需修改：脚本不硬编码任何用户私有信息，所有参数通过环境变量/交互输入

Codex 配置参考

聚星逸网关已原生支持 Responses API（POST /v1/responses），Codex v0.84+ 强制要求该协议，无需额外代理。

完整 config.toml 示例：

model = "deepseek-v4-flash"
model_provider = "juxingyi"
openai_base_url = "https://fireworks-simulator-api.huo15.com/v1"
model_reasoning_effort = "medium"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

故障排查