Skip to main content

worker-model-switch

Switch a Worker Agent's LLM model via agt CLI. Use when the human admin requests changing a Worker's model.

Source facts

Repository
agentscope-ai/AgentTeams
Last source activity
July 21, 2026 at 14:13
Detected SKILL.md language
English
Stars
5,761
Forks
710

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
worker-model-switch
description
Switch a Worker Agent's LLM model via agt CLI. Use when the human admin requests changing a Worker's model.
# Worker Model Switch Switch a Worker's LLM model using the agt CLI. The controller handles all details: model parameter resolution, openclaw.json generation, storage push, and container recreation. ## Usage ```bash agt update worker --name <WORKER_NAME> --model <MODEL_ID> ``` Examples: ```bash agt update worker --name alice --model claude-sonnet-4-6 agt update worker --name alice --model deepseek-chat ``` ## What happens The controller automatically: 1. Updates the Worker CR's `spec.model` 2. Resolves model parameters (contextWindow, maxTokens, reasoning, input modalities) from its built-in model registry 3. Regenerates `openclaw.json` and pushes it to storage 4. Recreates the Worker container You do NOT need to specify context window, reasoning, or any model parameters — the controller knows them. ## On success The CLI prints `worker/<name> configured`. The controller reconciles the change automatically. No manual restart is needed. ## On failure Report the CLI error output to the human admin. Common causes: - Worker name does not exist - Controller API is unreachable ## Unknown models If the admin requests a model not in the controller's built-in registry, the controller uses safe defaults (contextWindow=150000, maxTokens=128000, reasoning=true, input=["text"]). If the admin needs specific parameters for an unknown model, they should update the controller's model registry rather than overriding at the skill level.
View on GitHub