# Worker Model Switch

Switch a Worker Agent's LLM model via agt CLI.

- Repository: https://github.com/agentscope-ai/AgentTeams (5913 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentscope-ai/AgentTeams --skill worker-model-switch -g -a claude-code -y`
Codex: `npx skills add agentscope-ai/AgentTeams --skill worker-model-switch -g -a codex -y`
Cursor: `npx skills add agentscope-ai/AgentTeams --skill worker-model-switch -g -a cursor -y`
Gemini CLI: `npx skills add agentscope-ai/AgentTeams --skill worker-model-switch -g -a gemini-cli -y`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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.