Agent 配置管理器

对 OpenClaw Agent 配置进行安全管控，支持校验与回滚。

快速上手

列出所有 Agent

scripts/list_agents.sh

更新 Agent 模型

scripts/set_agent_model.sh cybercodeur openrouter/google/gemini-2.5-flash

测试配置（预演模式）

scripts/test_config.sh --dry-run

备份与恢复

scripts/backup_config.sh
scripts/restore_config.sh 

核心操作

切换 Agent 模型

scripts/set_agent_model.sh  
# 示例：
scripts/set_agent_model.sh snake google/gemini-2.5-flash
scripts/set_agent_model.sh all moonshotai/kimi-k2.5  # 将全部 Agent 设置为同一模型

校验项：

• 模型是否存在于已配置的模型列表中？ ✓
• 模型格式是否正确（provider/model）？ ✓
• 配置语法是否有效（通过 jq 校验）？ ✓

添加回退链（Fallback Chain）

scripts/add_fallback.sh cybercodeur 
  --primary google/gemini-2.5-flash 
  --fallback1 deepseek/deepseek-v3.2 
  --fallback2 moonshotai/kimi-k2.5

批量更新多个 Agent

scripts/bulk_update.sh 
  --agents cybercodeur snake picsou 
  --model qwen/qwen3-coder-plus

工作流：方案 2（启用回退机制）

如需实现方案 2（在触发速率限制时自动启用回退）：

scripts/add_fallback.sh cybercodeur 
  --primary qwen/qwen3-coder-plus 
  --fallback1 deepseek/deepseek-v3.2 
  --fallback2 google/gemini-2.5-flash

scripts/test_config.sh --validate
openclaw gateway restart

安全特性

• 预演模式（Dry-run mode）：仅模拟变更，不实际应用
• 自动备份：每次变更均自动备份至 /tmp/openclaw-config.bak
• 配置校验：检查语法有效性及模型是否存在
• 一键回滚：数秒内即可恢复至上一版配置

相关文件

• scripts/list_agents.sh — 列出所有 Agent 配置
• scripts/set_agent_model.sh — 更新单个 Agent 的模型
• scripts/add_fallback.sh — 配置回退链（Fallback Chain）
• scripts/bulk_update.sh — 批量更新多个 Agent
• scripts/test_config.sh — 校验配置有效性
• scripts/backup_config.sh — 手动触发备份
• scripts/restore_config.sh — 从备份中恢复配置