X-AIO Coding Helper

CLI 工具，用于配置 AI 编程助手（Claude Code、OpenCode、Codex、OpenClaw、WorkBuddy）的 API 端点和模型。

功能

• 统一管理多个 AI 编程工具的配置
• 交互式配置向导
• 支持自定义 API 端点和模型
• 多语言支持（中文/英文）

安装

npm install -g @x-all-in-one/coding-helper
# 或
pnpm add -g @x-all-in-one/coding-helper

使用

# 启动交互式配置向导
xaio-chelper

# 查看帮助
xaio-chelper --help

# 切换语言
xaio-chelper lang

支持的工具

• Claude Code - Anthropic 官方 CLI
• OpenCode - 开源 AI 编程助手
• Codex - OpenAI CLI
• OpenClaw - 可扩展的个人 AI 助手
• WorkBuddy - 腾讯桌面级 AI 智能体

Codex 配置

helper 按 PATH 中 codex --version 的结果选择认证方式：0.48.0+ 使用 config.toml 中 provider 的 experimental_bearer_token，并设置 requires_openai_auth = false；更早版本或无法识别版本时使用 auth.json 的 OPENAI_API_KEY。新版方式保留官方登录和凭据存储设置，配置文件权限为 0600。

近期真正的行为变更发生在 0.148.0 → 0.149.0：requires_openai_auth = false 的 provider 不再继承全局认证；旧的 requires_openai_auth = true 配合 auth.json 仍受支持。源码提交、CC Switch 对照及升级/降级恢复规则见 Codex 认证兼容说明。运行 pnpm run verify:codex-config 可验证新旧版本配置。

WorkBuddy 配置

向导可以将 X-AIO 的全部可用模型装载到 WorkBuddy，并在之后刷新或卸载这些模型。默认配置路径在 macOS/Linux 上是 ~/.workbuddy/models.json，Windows 上是 %USERPROFILE%\.workbuddy\models.json；也遵循 WorkBuddy 的 WORKBUDDY_CONFIG_DIR 和旧版 CODEBUDDY_CONFIG_DIR 目录覆盖。

每个模型使用完整的 https://llm-api.x-aio.com/v1/chat/completions 端点。刷新会替换使用该端点的旧 X-AIO 条目，同时保留其他供应商或端点的模型；卸载只删除使用该端点的条目。配置包含 API Key，因此 helper 以仅当前用户可读写的权限原子写入文件，并拒绝覆盖损坏的 JSON。字段和自定义模型行为以 WorkBuddy 官方模型配置文档 为准。

OpenClaw 配置

向导默认将 OpenClaw 配置写入 ~/.openclaw/openclaw.json，并兼容已有的 .clawdbot 配置路径。OpenClaw 使用 JSON5，因此已有的注释和尾随逗号可以正常读取；helper 写回为缩进 JSON（因此注释和尾随逗号不会保留），配置文件权限会按仅用户可读写创建。也可以使用 OpenClaw 官方支持的环境变量覆盖路径：

• OPENCLAW_CONFIG_PATH：指定完整配置文件路径
• OPENCLAW_STATE_DIR：指定状态目录
• OPENCLAW_HOME：指定 OpenClaw 的主目录
• OPENCLAW_PROFILE：使用命名 profile；未显式覆盖状态目录时默认使用 ~/.openclaw-<profile>

生成的自定义 provider id 为 x-aio，凭据位于 models.providers.x-aio.apiKey，默认模型引用位于 agents.defaults.model.primary（格式为 x-aio/<model>）。如果 provider 已使用有效的 OpenClaw SecretRef，helper 会保留该引用，不会用明文 API key 覆盖。

模型发现使用两个经过同一 API key 鉴权的端点：/v1/models 是用户可用模型 ID 的权威来源，Dashboard 模型列表按字段补充 context、max output、tags 和 upstream type，共享 profile 再由 tags 派生输入模态与推理能力。元数据优先于共享 profile 的兼容规则；Dashboard 不可用或缺少单模型详情时仍保留 /v1/models 的基础模型，并使用共享默认值。协议可以是 openai-completions 或 openai-responses，同一 provider 下的模型可以分别指定协议。

helper 可以读取 OpenClaw JSON5，但配置包含 $include 时不会尝试展开或重写，任何修改操作都会被拒绝；OPENCLAW_NIX_MODE=1 下同样保持只读。此时应修改拥有该配置的 include 文件或 Nix 源。

OpenClaw 当前配置格式和 provider 字段请以官方模型 provider 文档为准。项目只配置主模型：主模型候选和 helper 管理的 X-AIO provider 目录会排除 embedding 模型，并在保存或刷新时清理其中可识别的旧 embedding 条目；不会创建、改写或删除用户已有的 memory.search、agents.entries.*.memory.search 或旧版 memorySearch 配置，其他 provider 也不会受影响。

首次安装和升级请参考 OpenClaw 安装文档 与 升级文档；向导首次安装使用 npm install -g openclaw@latest（npm >= 11.16 时自动追加 --allow-scripts=openclaw），升级调用 openclaw update。本适配按 OpenClaw 2026.8.1（源码 commit 880a2a6）验证；该版本要求 Node.js 22.22.3+、24.15+ 或 25.9+（推荐 Node.js 26），安装 @latest 时请以官方 Node.js 文档为准。

开发者可以运行以下检查验证模型元数据和 OpenClaw 配置合并逻辑：

pnpm run verify:model-profile
pnpm run verify:fetch-models
pnpm run verify:openclaw
pnpm run verify:workbuddy

License

MIT