central-model-switch

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 修改默认模型（请根据实际情况调整）
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

# 测试 API
curl -s http://localhost:18789/health

节点配对救援（如掉线）

节点重新配对

# 删除旧的配对信息
rm ~/.openclaw/node.json

# 重新启动节点
cd ~/.openclaw
npx openclaw node run --host <gateway_ip> --port <gateway_port>

安全建议

1. 始终备份：修改配置前先备份
2. 验证 IP：确认目标服务器 IP 正确
3. 检查 Key：API Key 只在本地使用，勿上传
4. 最小权限：使用 sudo 而非 root 登录
5. 监控日志：查看 /tmp/gateway.log 排查问题

相关文件

• ~/.openclaw/openclaw.json - 配置文件
• /tmp/gateway.log - 运行日志