在 OpenClaw 的配置架构中,Agent(代理)和 Models(模型列表)分处于不同的逻辑层级。你可以把它们想象成“服务员”与“菜单”的关系。
models 配置一般位于 Channel(渠道)层级,用于定义该渠道(如 OpenAI、Anthropic、自建 API)可提供的原始服务,本质是对模型能力的声明。
作用:告知系统当前 API Key 可调用的具体模型 ID(如 gpt-4o、claude-3-5-sonnet 等)。
配置重点:准确填写官方模型字符串,保证请求路由正确。
核心价值:解决“从哪里调用什么模型”的问题,属于全局基础配置。
配置内容:
- 注册 API 提供商(DeepSeek、Anthropic、Ollama 等)
- 配置 baseUrl、apiKey、协议类型
- 声明模型能力参数(contextWindow、maxTokens、cost)
models 可理解为系统统一的模型库,完成提供商注册后,全系统所有 Agent 均可引用其中模型,本身不主动执行业务逻辑。
Agent是OpenClaw中更高维度的抽象,是封装后的执行单元,而非单一模型,核心为功能封装。
核心能力
- 角色设定:通过System Prompt配置专属人设,如翻译专家、代码助手等。
- 模型绑定:关联底层模型,调用时仅需指定agent_id。
- 知识库/工具挂载:可对接RAG知识库与外部查询工具。
作用
屏蔽底层模型细节,调用者通过ID即可获取具备特定逻辑的AI服务。
核心配置(行为层)
- 模型选型:model.primary / model.fallbacks
- 工作目录:workspace(对应SOUL.md、AGENTS.md等个性化文件)
- 运行环境:sandbox(沙箱隔离级别)
- 通信机制:heartbeat(心跳频率)
- 会话管理:session(上下文管理)
该层用于定义具体AI助手的工作方式。
你可以创建多个 agent,每个 agent 指向不同的模型组合和不同的工作目录,从而实现"一个负责写内容、一个负责跑代码"这样的多角色架构。
modelsagents层级基础设施层:单纯的 API 转发。业务逻辑层、应用层:带有指令和上下文的逻辑体。作用声明可用模型定义 AI 角色行为数量通常少数几个提供商可以有多个不同职责的 agent灵活性固定,由服务商决定。高度自定义,由你决定。修改频率基本固定,换模型时才改model: "gpt-4"经常调整(换人格、换工作区)model: "my-custom-agent-id"包含内容仅模型名称(ID)。模型 ID + 系统提示词 + 参数设置(Temperature等)。
逻辑流转图示
- 用户请求:调用 。
- Agent 处理:注入预设的 Prompt(比如:“请用短句回答”),并检查配置。
- 寻找 Model:根据 Agent 配置,找到对应的 。
- 匹配 Channel:系统在 列表中搜索包含 的可用渠道,完成最终请求。
简单来说:
如果你只是想简单地转发 API,配置 就够了;如果你想建立一个有特定回复风格(比如你喜欢的简短、逻辑清晰的风格)或具备特定功能的接口,就需要配置 。 简单说:models 是"大脑供应商",agents 是"使用大脑的员工",两者层级不同、职责不同。
实际场景举例:你在 models 里注册了 DeepSeek 和 Qwen,然后配两个 agents—— 用 deepseek-chat 写微信文章, 用 deepseek-reasoner 跑自动化脚本,各自有独立的 workspace 和 SOUL.md,互不干扰。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/231303.html