Switch a Worker Agent's LLM model via hiclaw CLI. Use when the human admin requests changing a Worker's model.
Switch a Worker's LLM model using the hiclaw CLI. The controller handles all details: model parameter resolution, openclaw.json generation, storage push, and container recreation.
hiclaw update worker --name <WORKER_NAME> --model <MODEL_ID>
Examples:
hiclaw update worker --name alice --model claude-sonnet-4-6
hiclaw update worker --name alice --model deepseek-chat
The controller automatically:
spec.modelopenclaw.json and pushes it to storageYou do NOT need to specify context window, reasoning, or any model parameters — the controller knows them.
The CLI prints worker/<name> configured. The controller reconciles the change automatically. No manual restart is needed.
Report the CLI error output to the human admin. Common causes:
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.