返回 Skill 列表
extension
分类: 其它需要 API Key

OpenClaw Model Switch & Rescue

OpenClaw 模型切换与救援技能。当模型 API 不可用时切换模型,或处理节点配对问题。触发词:模型切换、API 用完、Central 救援、节点掉线。⚠️ 使用前必须配置环境变量,详见变量说明。

person作者: 2233adminhubclawhub

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 - 运行日志