Package Exports

openclawapi
openclawapi/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (openclawapi) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

OpenClaw Config Manager

🔧 跨平台 OpenClaw/Clawdbot 配置管理工具

一个交互式命令行工具，用于管理 OpenClaw 的中转站配置、模型切换、API Keys 等设置。

说明：本工具默认只对 Claude / GPT 预设做优化与保障，其他模型保留入口但不保证可用，建议走 OpenClaw 配置页面或官方流程。

特性

✅ 跨平台支持: macOS、Linux、Windows 通用
🔄 中转站管理: 添加、编辑、删除、切换中转站
🤖 模型配置: 主模型切换、备用模型管理
🧭 端点切换: 一键切换中转 API 接入点
🧩 模型切换: 快速切换模型型号（仅 GPT/Claude 预设）
🔑 API Key 管理: 安全地添加、查看、删除 API Keys
⚙️ 高级设置: 并发数、工作区路径等配置
📋 配置查看: 一键查看当前完整配置
🎨 友好界面: 彩色交互式菜单

安装

方式 1: 使用 npx (推荐)

无需安装，直接运行：

npx openclawapi

方式 2: 全局安装

cd /Users/mx/Documents/自动化/OpenClaw/Service/OpenClawApi
npm install -g .

然后运行：

openclawapi

方式 3: 本地运行

cd /Users/mx/Documents/自动化/OpenClaw/Service/OpenClawApi
npm install
npm start

前置要求

Node.js >= 14.0.0
已安装并初始化 OpenClaw（openclaw onboard）或 Clawdbot（clawdbot onboard）

使用指南

启动工具

npx openclawapi

给客户看的：安装 OpenClaw 后如何接入我们的 API

建议优先用本工具配置（云逸 Claude/GPT 中转在网页端校验较严格，容易报 invalid config）。

步骤 1：完成 OpenClaw 初始化

openclaw onboard

步骤 2：运行本工具并选择快速配置向导

npx openclawapi

进入后选择 「🚀 快速配置向导」，按提示填写：

Claude（Anthropic Messages）

API：anthropic-messages
Base URL（任选其一，必须完整路径）
https://yunyi.skem.cn/claude/v1/messages
https://yunyi.cfd/claude/v1/messages
模型：claude-opus-4-5 / claude-sonnet-4-5 / claude-haiku-4-5
API Key：Claude 专用 Key（与 Codex 不通用）

Codex / GPT（OpenAI Responses）

API：openai-responses
Base URL（任选其一，必须完整路径）
https://yunyi.skem.cn/codex/response
https://yunyi.cfd/codex/response
模型：gpt-5.2 / gpt-5.2-codex
API Key：Codex 专用 Key（与 Claude 不通用）

需要多个节点可用时，可在向导里添加备用端点，或后续使用“端点切换/测速切换”。

步骤 3：重启网关

openclaw gateway restart

步骤 4：验证

打开 OpenClaw 网页端 Chat 测试
或执行 openclaw doctor

主菜单

🔧 OpenClaw 配置管理工具

? 请选择操作:
  🚀 快速配置向导 (URL/Key/Token/Workspace)
  📡 管理中转站配置
  🧭 快速切换中转端点
  🤖 管理模型配置
  🧩 快速切换模型
  🔑 管理 API Keys / Tokens
  ⚡ 测速并切换中转站
  ⚙️  高级设置
  📄 查看当前配置
  ❌ 退出

1. 管理中转站配置

添加新中转站

选择 "📡 管理中转站配置" → "➕ 添加新中转站"
输入中转站名称（例如：claude-relay-1）
输入 Base URL（例如：https://yunyi.cfd/claude/v1/messages）
选择模型类型（Claude / Codex / 其他）
选择或输入模型 ID
设置上下文窗口大小（默认 200000）
设置最大输出 tokens（默认 8192）

示例配置：

中转站名称: claude-relay-1
Base URL: https://yunyi.cfd/claude/v1/messages
模型类型: Claude (Anthropic)
模型: Claude Sonnet 4.5
上下文窗口: 200000
最大输出: 8192

编辑中转站

修改现有中转站的 URL、上下文窗口、最大输出等设置。

删除中转站

删除不再使用的中转站配置（会同时删除相关的 API Key）。

切换主中转站

快速切换当前使用的主中转站。

2. 管理模型配置

切换主模型

从所有已配置的中转站中选择一个作为主模型。

管理备用模型

选择多个备用模型，按优先级排序。当主模型不可用时，系统会自动切换到备用模型。

3. 管理 API Keys

添加/更新 API Key

选择中转站
输入 API Key（输入时会隐藏显示）
自动保存到 ~/.openclaw/agents/main/agent/auth-profiles.json（或旧版 ~/.clawdbot/agent/auth-profiles.json）

查看已配置的 Keys

显示所有已配置的 API Keys（部分隐藏显示，例如：sk-abc123...xyz789）

删除 API Key

删除指定中转站的 API Key。

4. 高级设置

配置系统级参数：

最大并发任务数: 同时运行的任务数量（默认 4）
子代理最大并发数: 子代理的并发数量（默认 8）
工作区路径: OpenClaw 工作区目录

5. 查看当前配置

显示完整的当前配置，包括：

主模型
备用模型列表
所有中转站详情
高级设置

配置文件位置

OpenClaw (macOS / Linux / Windows)

主配置: ~/.openclaw/openclaw.json（JSON5）
API Keys: ~/.openclaw/agents/<agent>/agent/auth-profiles.json（默认 main）

Clawdbot 兼容 (旧版)

主配置: ~/.clawdbot/clawdbot.json
API Keys: ~/.clawdbot/agent/auth-profiles.json

环境变量覆盖

# OpenClaw
OPENCLAW_CONFIG_PATH=/path/to/openclaw.json
OPENCLAW_STATE_DIR=/path/to/.openclaw
OPENCLAW_AGENT_DIR=/path/to/agents/main/agent
OPENCLAW_AGENT=main
OPENCLAW_PROFILE=default

# Clawdbot
CLAWDBOT_CONFIG_PATH=/path/to/clawdbot.json
CLAWDBOT_STATE_DIR=/path/to/.clawdbot
CLAWDBOT_AGENT_DIR=/path/to/agent
CLAWDBOT_AGENT=main

支持范围（本工具预设）

Claude：claude-opus-4-5 / claude-sonnet-4-5 / claude-haiku-4-5
GPT：gpt-5.2 / gpt-5.2-codex
Claude 与 GPT 的 API Key 互不通用，需要分别配置

云逸节点与路径规则

基础域名（任选其一）

https://yunyi.skem.cn
https://yunyi.cfd
https://cdn1.yunyi.cfd
https://cdn2.yunyi.cfd
http://47.99.42.193
http://47.97.100.10

路径

Claude：/claude/v1/messages
Codex：/codex/response

常见使用场景

场景 1: 添加 Claude 中转站

# 运行工具
npx openclawapi

# 选择: 📡 管理中转站配置 → ➕ 添加新中转站
# 输入:
#   名称: claude-relay-1
#   URL: https://yunyi.cfd/claude/v1/messages
#   模型: Claude Sonnet 4.5
#   上下文: 200000
#   最大输出: 8192

# 然后: 🔑 管理 API Keys → ➕ 添加/更新 API Key
# 选择: claude-relay-1
# 输入: sk-your-api-key-here

场景 2: 配置主备中转站

# 1. 添加主中转站
#    名称: claude-main
#    URL: https://yunyi.cfd/claude/v1/messages

# 2. 添加备用中转站
#    名称: claude-backup
#    URL: https://yunyi.skem.cn/claude/v1/messages

# 3. 设置主模型
#    选择: 🤖 管理模型配置 → 🔄 切换主模型
#    选择: claude-main

# 4. 设置备用模型
#    选择: 🤖 管理模型配置 → 📋 管理备用模型
#    勾选: claude-backup

场景 3: 切换到不同的模型

# 选择: 🤖 管理模型配置 → 🔄 切换主模型
# 从列表中选择新的模型

验证配置

配置完成后，运行以下命令验证：

# 检查配置
openclaw doctor

# 启动服务
openclaw gateway

故障排除

问题 1: 找不到配置文件

错误: 配置文件不存在: ~/.clawdbot/openclaw.json

解决: 先运行 clawdbot onboard 初始化配置

问题 2: 权限错误

错误: EACCES: permission denied

解决:

# macOS/Linux
chmod 755 ~/.clawdbot

# 或使用 sudo
sudo npx openclawapi

问题 3: Node.js 版本过低

错误: Requires Node.js >= 14.0.0

解决: 升级 Node.js

# 使用 nvm
nvm install 18
nvm use 18

技术栈

inquirer: 交互式命令行界面
chalk: 彩色终端输出
fs-extra: 增强的文件系统操作

开发

项目结构

Service/OpenClawApi/
├── package.json          # 项目配置
├── cli.js               # 主程序入口
├── lib/
│   ├── config-manager.js # 配置文件管理
│   └── ui.js            # 界面工具函数
└── README.md            # 使用文档

本地开发

cd /Users/mx/Documents/自动化/OpenClaw/Service/OpenClawApi
npm install
node cli.js

调试

# 查看配置文件
cat ~/.clawdbot/openclaw.json

# 查看 API Keys
cat ~/.clawdbot/agents/main/agent/auth-profiles.json

# 备份配置
cp ~/.clawdbot/openclaw.json ~/.clawdbot/openclaw.json.backup

安全提示

⚠️ API Keys 以明文存储在 auth-profiles.json 中
⚠️ 不要将 auth-profiles.json 提交到版本控制
⚠️ 定期更换 API Keys
⚠️ 使用 chmod 600 限制文件权限

chmod 600 ~/.clawdbot/agents/main/agent/auth-profiles.json

许可证

MIT

支持

如有问题，请查看：

更新日志

v1.0.0 (2026-02-01)

✅ 初始版本发布
✅ 支持中转站管理
✅ 支持模型配置
✅ 支持 API Key 管理
✅ 支持高级设置
✅ 跨平台支持（macOS/Linux/Windows）