Agent Config Manager
Manage and update OpenClaw agent models, bindings, and configs with validation, dry-run, backup, restore, and rollback support.
Agent Config Manager
Safe management of OpenClaw agent configurations with validation and rollback.
Quick Start
List all agents
scripts/list_agents.sh
Update agent model
scripts/set_agent_model.sh cybercodeur openrouter/google/gemini-2.5-flash
Test configuration (dry-run)
scripts/test_config.sh --dry-run
Backup & restore
scripts/backup_config.sh
scripts/restore_config.sh <backup_date>
Core Operations
Change Agent Model
scripts/set_agent_model.sh <agent_id> <new_model>
# Examples:
scripts/set_agent_model.sh snake google/gemini-2.5-flash
scripts/set_agent_model.sh all moonshotai/kimi-k2.5 # Set all to same model
Validation:
- Model exists in configured list? ✓
- Model format correct (provider/model)? ✓
- Config syntax valid (jq)? ✓
Add Fallback Chain
scripts/add_fallback.sh cybercodeur \
--primary google/gemini-2.5-flash \
--fallback1 deepseek/deepseek-v3.2 \
--fallback2 moonshotai/kimi-k2.5
Update Multiple Agents
scripts/bulk_update.sh \
--agents cybercodeur snake picsou \
--model qwen/qwen3-coder-plus
Workflow: Solution 2 (Fallbacks)
To implement Solution 2 (automatic fallback on rate limit):
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
Safety Features
- Dry-run mode: Test changes without applying
- Automatic backup: Every change backs up to
/tmp/openclaw-config.bak - Validation: Syntax & model existence checks
- Rollback: Restore previous config in seconds
Files
- scripts/list_agents.sh - List agent configs
- scripts/set_agent_model.sh - Update single agent model
- scripts/add_fallback.sh - Configure fallback chains
- scripts/bulk_update.sh - Update multiple agents
- scripts/test_config.sh - Validate config
- scripts/backup_config.sh - Manual backup
- scripts/restore_config.sh - Restore from backup
Related skills
- Downloads
- 681All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
