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（可填写 /claude 或完整 /claude/v1/messages，工具会自动兼容） https://yunyi.skem.cn/claude
https://yunyi.cfd/claude
模型：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 不通用）

也可以一条命令完成（适合发给客户，建议改成你们的中转地址）：

# Claude
npx openclawapi quick --type claude --base-url https://your-relay.example/claude --model claude-sonnet-4-5 --api-key sk-xxxx

# Codex
npx openclawapi quick --type codex --base-url https://your-relay.example/codex/response --model gpt-5.2 --api-key sk-xxxx

如果你要一次性配置多个 Claude 节点（云逸预设），并自动测速选择主节点：

npx openclawapi preset-claude --api-key sk-xxxx

步骤 3：重启网关

openclaw gateway restart

步骤 4：验证

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

主菜单

🔧 OpenClaw 配置管理工具

? 请选择操作:
  🚀 快速配置向导 (第三方中转)
  🚀 Claude 最快节点一键配置 (云逸预设)
  🔵 选择 Claude 节点
  🟢 选择 Codex 节点
  ⚡ 激活 Claude
  ⚡ 激活 Codex
  🧪 测试连接
  📋 查看当前配置
  🔄 恢复默认配置
  ❌ 退出

预设配置入口（无需记忆）

节点/模型/API 类型的默认配置统一放在：

Service/OpenClawApi/API节点设置.md

以后只要改这个文件（节点、模型、API 参数），CLI 会自动读取并生效。

更多说明文档已整理到：

Service/OpenClawApi/docs/

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

访问 Web Dashboard

本地安装后访问

# 方式1: 自动打开浏览器（推荐）
clawdbot dashboard

# 方式2: 仅显示 URL，手动复制到浏览器
clawdbot dashboard --no-open

访问地址格式：

http://127.0.0.1:18789/?token=<你的token>

⚠️ 必须带 ?token= 参数访问，否则页面会报错。

VPS 远程部署后访问（SSH 隧道）

如果 OpenClaw 部署在 VPS 上，需要通过 SSH 隧道访问：

步骤 1: 建立 SSH 隧道（保持终端运行）

ssh -N -L 18789:127.0.0.1:18789 -i <密钥路径> ubuntu@<服务器IP>

步骤 2: 浏览器访问

http://127.0.0.1:18789/?token=<token>

配置 SSH 快捷方式（推荐）

在 ~/.ssh/config 添加：

Host openclaw
    HostName <服务器IP>
    User ubuntu
    IdentityFile ~/.ssh/openclaw-key
    LocalForward 18789 localhost:18789

然后只需运行 ssh openclaw -N 即可建立隧道。

其他访问方式

方式	命令/地址	适用场景
TUI 终端界面	`clawdbot tui`	无图形界面环境
启动网关	`clawdbot gateway`	手动启动服务
查看状态	`clawdbot status`	检查服务状态
查看日志	`clawdbot logs`	排查问题

Dashboard 访问注意事项

事项	说明
必须带 Token	❌ 不带 token 访问会报错 ✅ 正确: `http://127.0.0.1:18789/?token=xxx`
获取 Token	在服务器运行 `clawdbot dashboard --no-open`
保持终端运行	SSH 隧道断开则无法访问
安全设计	Gateway 默认绑定 127.0.0.1，不直接暴露公网

Gateway API 端点

OpenClaw Gateway 支持以下 HTTP 端点（需在配置中启用）：

端点	配置项	默认状态
`/v1/chat/completions`	`gateway.http.endpoints.chatCompletions.enabled`	关闭
`/v1/responses`	`gateway.http.endpoints.responses.enabled`	关闭
`/tools/invoke`	-	内部使用

注意：本工具的测试功能直接调用中转 API，不依赖 Gateway HTTP 端点。

故障排除

问题 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.3.14 (2026-02-03)

✅ 测试连接改为通过 Gateway API 端点测试（与 Web Dashboard 使用相同端点）
✅ 测试成功即表示 Web Dashboard 可正常对话

v1.3.13 (2026-02-03)

✅ 测试连接改为：先重启 Gateway，再测试中转 API
✅ 修复 Gateway 重启命令兼容性（支持 openclaw/clawdbot/npx）
✅ 测试问题改为"你是什么模型？"获取更详细回复

v1.0.0 (2026-02-01)

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