OpenClaw Model Optimizer

指导用户读取并备份 ~/.openclaw/openclaw.json，列出 models.providers 中已配置的模型，向 agents.defaults.models 补充 input、contextWindow、maxTokens、reasoning 等能力声明，逐项请用户确认模型能力，并提示重启 OpenClaw 生效；另附常见模型能力参考文档。

yay2008

热度 52.77

最近更新 2026-05-11 17:34:59

分类：自动化依赖：读写文件应用场景：工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add openclaw-model-optimizer

Metadata

name: openclaw-model-optimizer
description: Optimize OpenClaw model configuration by declaring missing model capabilities (vision/multimodal input, context window, max output tokens, reasoning). Use when user mentions OpenClaw model optimization, model capabilities not working, image/vision not recognized, context window too small, output truncated, or after adding a new model provider to openclaw.json. Also triggers on "优化openclaw模型配置" or similar requests.

OpenClaw Model Optimizer

Optimize openclaw.json model configurations by declaring model capabilities that OpenClaw cannot auto-detect.

Problem

OpenClaw does not auto-detect model capabilities from providers. Without explicit declarations, features like vision input, large context windows, extended output, and reasoning mode remain disabled — even when the underlying model and API fully support them.

Workflow

Read ~/.openclaw/openclaw.json
Back up the config — copy ~/.openclaw/openclaw.json to ~/.openclaw/openclaw.json.bak before making any changes
Identify all configured models under models.providers
Check if agents.defaults.models exists with capability declarations for each model
For missing or incomplete declarations, ask the user to confirm each model's capabilities
Add the agents.defaults.models block with proper declarations
Remind user to restart OpenClaw for changes to take effect

Capability Fields

Declare capabilities in agents.defaults.models using the provider-id/model-id key format:

{
  "agents": {
    "defaults": {
      "models": {
        "provider-id/model-id": {
          "input": ["text", "image"],
          "contextWindow": 256000,
          "maxTokens": 16384,
          "reasoning": true
        }
      }
    }
  }
}

Field Reference

Field	Type	Description
`input`	`string[]`	Supported input modalities: `"text"`, `"image"`. Default if omitted: `["text"]` only — vision disabled
`contextWindow`	`number`	Max input context in tokens. Default if omitted: conservative fallback — may truncate long conversations
`maxTokens`	`number`	Max output tokens per response. Default if omitted: conservative fallback — long responses get cut off
`reasoning`	`boolean`	Whether model supports extended thinking/CoT. Default if omitted: `false`

Common Model Capabilities

Reference for popular models (always verify with user before applying):

See references/model-capabilities.md for known model defaults.

Important Notes

Always back up openclaw.json to openclaw.json.bak before modifying — never edit the config without a backup
Always confirm capabilities with the user — API endpoints may differ from model defaults
The provider-id/model-id key must match exactly what appears in models.providers and agents.defaults.model.primary
Do not overwrite existing capability declarations without user consent