| name | central-model-switch |
| description | OpenClaw 模型切换与救援技能。当模型 API 不可用时切换模型,或处理节点配对问题。触发词:模型切换、API用完、Central救援、节点掉线。⚠️ 使用前必须配置环境变量,详见变量说明。 |
OpenClaw 模型切换与救援
⚠️ 安全警告:使用前必须配置以下环境变量,勿直接运行!
变量配置
| 变量 | 说明 | 示例值 |
|---|
| CENTRAL_IP | 中央服务器 IP | 从配置文件获取 |
| SSH_KEY | SSH 私钥路径 | ~/.ssh/id_ed25519 |
| API_KEY | 模型 API Key | 从平台获取 |
实施步骤
1. 连接目标服务器
ssh -i $SSH_KEY root@$CENTRAL_IP
2. 检查当前配置
cat ~/.openclaw/openclaw.json | grep -A5 'primary'
3. 更新模型配置
根据你的模型提供商修改配置(以 OpenAI 为例):
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
sed -i 's/"primary": "[^"]*"/"primary": "gpt-4o-mini"/' ~/.openclaw/openclaw.json
或使用 Python:
import json
with open('/root/.openclaw/openclaw.json', 'r') as f:
cfg = json.load(f)
# 修改默认模型
cfg['agents']['defaults']['model']['primary'] = 'your-model-id'
with open('/root/.openclaw/openclaw.json', 'w') as f:
json.dump(cfg, f, indent=2)
4. 重启 Gateway
优先使用 systemd:
sudo systemctl restart openclaw-gateway
如无 systemd:
cd ~/.openclaw
pkill -f openclaw-gateway
nohup npx openclaw gateway > /tmp/gateway.log 2>&1 &
5. 验证
ps aux | grep openclaw-gateway
curl -s http://localhost:18789/health
节点配对救援(如掉线)
节点重新配对
rm ~/.openclaw/node.json
cd ~/.openclaw
npx openclaw node run --host <gateway_ip> --port <gateway_port>
安全建议
- 始终备份:修改配置前先备份
- 验证 IP:确认目标服务器 IP 正确
- 检查 Key:API Key 只在本地使用,勿上传
- 最小权限:使用 sudo 而非 root 登录
- 监控日志:查看
/tmp/gateway.log 排查问题
相关文件
~/.openclaw/openclaw.json - 配置文件
/tmp/gateway.log - 运行日志