1. OpenClaw自定义中转站配置概述
OpenClaw作为一款开源的AI模型管理工具，其自定义中转站功能允许用户通过配置第三方API服务商（如一步API）来接入多种大语言模型。这个功能本质上是在本地搭建一个代理网关，将用户请求路由到指定的API端点，同时提供统一的交互界面。
为什么要使用自定义中转站？从我实际部署经验来看，主要解决三个问题：
- 模型聚合：不同厂商的API（如OpenAI、Anthropic、Google Gemini）有各自的调用方式和认证机制，中转站统一了这些差异
- 成本控制：通过中转站可以灵活切换不同价位的API服务商
- 隐私保护：敏感对话数据可以不直接发送给模型厂商
最新版OpenClaw(v0.9.3+)对中转站配置做了两项重要改进：
- 新增交互式命令行配置向导（适合新手）
- 支持JSON配置文件热加载（适合批量部署）
提示：配置前请确保已从API服务商处获取有效的访问密钥（如一步API的sk-xxx格式key），这是后续所有操作的前提条件。
2. 环境准备与基础安装
2.1 Node.js环境校验
OpenClaw基于Node.js运行时，需要先检查开发环境：
bash复制node -v # 需v16.0以上
npm -v # 需7.0以上
如果未安装，推荐通过nvm管理多版本：
bash复制curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
nvm install 18
2.2 OpenClaw核心组件安装
全局安装CLI工具和网关服务：
bash复制npm install -g @openclaw/cli @openclaw/gateway
验证安装成功：
bash复制openclaw --version
openclaw-gateway --version
常见安装问题排查：
- 权限错误：在Linux/Mac前加
sudo，Windows用管理员PowerShell - 网络超时：配置npm镜像源
npm config set registry https://registry.npmmirror.com - 版本冲突：先卸载旧版
npm uninstall -g @openclaw/cli
3. 交互式配置向导详解
3.1 启动配置向导
执行交互式配置命令：
bash复制openclaw configure
会依次出现以下配置项：
-
部署模式选择：
- Local（本地开发）
- Cloud（生产环境）
-
模型提供商：
- 选择"Custom Provider"进入自定义配置
-
API基础地址：
code复制https://yibuapi.com/v1注意：不同服务商地址不同，一步API的Claude模型需用根域名/v1，Gemini用/v1beta
-
认证密钥输入：
- 选择"Paste API key now"
- 输入从服务商获取的sk-xxx格式密钥
-
模型端点映射：
- 模型ID：与服务商提供的模型列表一致（如gpt-4o）
- Endpoint ID：保持默认或按服务商要求填写
- 别名：自定义显示名称（如"GPT-4极速版"）
3.2 多模型配置技巧
如需配置多个模型，在向导最后选择"Add another model"重复流程。推荐配置顺序：
- 先配置主要使用的模型（如Claude Opus）
- 再配置备用模型（如GPT-4o）
- 最后配置特殊用途模型（如Gemini Vision）
实测建议：
- 同类模型使用相同Provider（如所有OpenAI模型归到api-proxy-gpt）
- 为每个模型设置易记的alias，方便后续切换
4. 手动配置文件定制
4.1 核心配置文件结构
配置文件位于~/.openclaw/目录，主要包含：
- openclaw.json - 模型路由规则
json复制{
"models": {
"providers": {
"api-proxy-claude": {
"baseUrl": "https://yibuapi.com",
"api": "anthropic-messages",
"models": [
{
"id": "claude-opus-4-6",
"name": "Claude企业版",
"contextWindow": 200000
}
]
}
}
}
}
关键参数说明：
baseUrl：必须与服务商文档一致api：指定协议类型（openai-completions/anthropic-messages等）contextWindow：影响对话记忆长度
4.2 认证配置文件
auth-profiles.json存储敏感密钥：
json复制{
"profiles": {
"api-proxy-claude:default": {
"type": "api_key",
"key": "sk-真实密钥要去服务商后台获取"
}
}
}
安全建议：
- 将该文件加入.gitignore
- 设置400权限：
chmod 400 auth-profiles.json - 使用环境变量替代明文存储（需修改gateway启动脚本）
4.3 网关服务管理
启动网关服务：
bash复制openclaw gateway
常用参数：
--port 18789指定监听端口--log-level debug输出详细日志--watch监听配置变化自动重启
服务验证：
bash复制curl http://localhost:18789/v1/models
应返回已配置的模型列表
5. 高级配置与优化
5.1 负载均衡配置
在openclaw.json中添加多个endpoint实现故障转移：
json复制"api-proxy-gpt": {
"endpoints": [
{ "url": "https://api1.yibu.com/v1", "weight": 60 },
{ "url": "https://api2.yibu.com/v1", "weight": 40 }
]
}
5.2 请求限流设置
防止超额调用：
json复制"rateLimits": {
"gpt-4o": {
"rpm": 100,
"tpm": 40000
}
}
5.3 本地缓存策略
减少重复请求：
json复制"cache": {
"enabled": true,
"ttl": 3600,
"strategy": "content-hash"
}
6. 常见问题排查
6.1 认证失败错误
症状：返回403状态码
解决方案：
- 检查auth-profiles.json密钥是否过期
- 确认服务商后台已启用该密钥
- 验证baseUrl是否包含正确的路径（/v1或/v1beta）
6.2 模型不可用
症状：返回404或503
排查步骤：
- 在服务商后台确认模型ID拼写正确
- 测试直接调用API是否正常：
bash复制curl -X POST https://yibuapi.com/v1/chat/completions \ -H "Authorization: Bearer sk-xxx" \ -d '{"model":"gpt-4o","messages":[{"role":"user","content":"你好"}]}'
6.3 性能调优
慢请求优化方案：
- 在网关启动时添加
--timeout 60000（单位毫秒） - 调整模型参数：
json复制"parameters": { "maxTokens": 512, "temperature": 0.7 }
我在实际部署中发现，当同时接入3个以上模型时，建议：
- 为gateway分配至少2GB内存
- 使用PM2管理进程：
pm2 start openclaw-gateway -- -p 18789