Agent Config Manager#

Safe management of OpenClaw agent configurations with validation and rollback.

Quick Start#

List all agents#

bash

scripts/list_agents.sh

Update agent model#

bash

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

Test configuration (dry-run)#

bash

scripts/test_config.sh --dry-run

Backup & restore#

bash

scripts/backup_config.sh
scripts/restore_config.sh <backup_date>

Core Operations#

Change Agent Model#

bash

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#

bash

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

Update Multiple Agents#

bash

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):

bash

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