agent

3 核心模块详解 3.1 agents - 代理默认配置 agents 模块定义了 AI 代理的默认行为，包括模型选择、并发控制等。简单说，就是告诉你的 AI 助手该怎么干活：

{ “agents”: { “defaults”: { “model”: { “primary”: “bailian/qwen3.5-plus”, “fallbacks”: [“bailian/qwen3-max”] }, “maxConcurrent”: 4, “subagents”: { “maxConcurrent”: 8 }, “workspace”: “C:\Users\xxx\.openclaw\workspace” } } } 关键字段说明：

primary

• 主用模型，日常对话默认使用（正宫娘娘） fallbacks
• 备用模型列表，主模型失败时自动切换（备胎团） maxConcurrent
• 最大并发请求数，避免 API 限流（别太贪心） workspace
• 工作区路径，存放记忆和技能文件（AI 的家） 💡 建议根据 API 提供商的限流策略调整并发数，百炼/Qwen 系列一般 4-8 比较安全。设太高容易被 API 方"请喝茶"。

4 高频修改场景 4.1 切换模型提供商 想从百炼切换到 MiniMax？修改 agents.defaults.model：

“agents”: { “defaults”: { “model”: { “primary”: “minimax/MiniMax-M2.5-highspeed”, “fallbacks”: [“bailian/qwen3-max”] } } } 💡 确保目标模型已在 models.providers 中正确配置，否则会报错。别玩"无中生有"！