自动切换模型 (Auto Model Switch)#

概述#

当主模型token用完或遇到限流时，自动切换到备用模型，确保对话不中断。

快速开始#

1. 安装依赖#

bash

cd ~/.openclaw/workspace/skills/auto-model-switch
npm install

2. 配置模型#

编辑 config.yaml：

yaml

models:
  - id: primary
    model: custom-maas-coding-api-cn-huabei-1-xf-yun-com/astron-code-latest
    name: "Astron Code"
    daily_limit: 10000000
    priority: 1

  - id: backup-1
    model: zai/glm-5
    name: "GLM-4.5"
    daily_limit: null
    priority: 2

3. 启用心跳检查#

在 HEARTBEAT.md 中添加：

markdown

- 检查模型状态: node ~/.openclaw/workspace/skills/auto-model-switch/heartbeat.js

命令#

命令说明node auto_model_switch.js status查看当前模型状态node auto_model_switch.js switch手动切换模型node auto_model_switch.js heartbeat心跳检查（自动检测和切换）node auto_model_switch.js sync从网关同步token使用量

触发条件#

• 警告：Token使用 > 80%
• 切换：Token使用 > 95% 或 API限流

配置说明#

yaml

models:
  - id: primary              # 模型标识
    model: model-id          # OpenClaw模型ID
    name: "显示名称"          # 友好名称
    daily_limit: 10000000    # 每日token限制（null=无限制）
    priority: 1              # 优先级（数字越小越优先）

auto_switch:
  on_limit_exceeded: true    # token用完时切换
  on_rate_limit: true        # 限流时切换
  retry_delay: 60            # 限流后重试延迟（秒）
  warning_threshold: 0.8     # 警告阈值
  critical_threshold: 0.95   # 切换阈值

notification:
  enabled: true              # 启用通知

与OpenClaw集成#

设置环境变量以启用网关集成：

bash

export OPENCLAW_GATEWAY_URL="http://localhost:3000"
export OPENCLAW_GATEWAY_TOKEN="your-token"

示例输出#

text

📊 模型状态
当前：Astron Code
Token：8.5M / 10M (85%)

备用模型：
- GLM-4.5 (可用)

文件说明#

text

auto-model-switch/
├── SKILL.md              # 本文件
├── config.yaml           # 模型配置
├── auto_model_switch.js  # 主脚本
├── heartbeat.js          # 心跳脚本
├── package.json          # Node.js配置
├── QUICKSTART.md         # 快速开始
└── state/                # 状态目录（自动创建）
    ├── model-switch.json # 当前状态
    └── switch-history.json # 切换历史

---

🔄 让模型切换自动化，对话永不断线