14-OpenClaw模型配置与切换指南

我们正在寻找关于
openclaw.json文件的完整
配置信息。根据用户提供的引用，该文件通常位于~/.
openclaw/
openclaw.json或~/.clawdbot/clawdbot.json。 引用[1]中提供了一个
配置片段，展示了models和
agents部分的
配置。引用[3]中提到了在
配置文件中查找token的方法，表明
配置文件中包含token字段。 由于引用中并没有给出完整的
配置文件示例，我们只能根据这些片段和一般
配置文件的常规模板进行整理。 注意：由于是用户
配置文件，可能包含很多可选字段，我们尽量根据已有信息和常规
配置构建一个完整的示例。 假设结构： 1. models: 定义
模型相关
配置，包括
模型提供者和
模型列表。 2.
agents: 定义代理（如默认代理）使用的
模型。 3. mode: 可能还有全局模式设置（如引用[1]中的”mode”: “merge”在models部分，但引用[3]中出现了”mode”: “token”，说明可能在其他部分也有mode）。 4. token: 用于认证的令牌（如引用[3]所示）。 我们将根据引用[1]的
配置片段，并补充其他常见
配置字段（如server, server.port, logging等）构建一个示例。注意，有些字段可能是可选的。 另外，引用[4]提到安装时需要编译llama.cpp，所以可能涉及本地
模型路径的
配置，但上述引用中未出现在
配置片段里。因此，我们可能还需要参考
OpenClaw文档中关于
配置的说明，但由于没有完整的文档，我们只能结合片段和常见情况构建。 构建一个相对完整的
openclaw.json
配置示例（注意：这只是一个示例，实际
配置可能根据版本和需求有所不同）: 以下是基于
OpenClaw
配置的最佳实践和引用资料整理的 `
openclaw.json` 完整
配置文件示例及说明：
–
–
– `
openclaw.json` 完整
配置示例 json { // 系统运行模式
配置 [^1][^3] “mode”: “token”, // 或 “merge”（多
模型协作模式） “token”: “5d446a33f3884e3981d39beef58xx2e6ad9e27f3548f0xxb”, // API访问令牌 //
模型服务提供商
配置 [^1] “models”: { “mode”: “merge”, //
模型协作模式：single/merge/chain等 “providers”: { “vllm”: { “baseUrl”: “http://127.0.0.1:8000/v1”, // 本地
模型服务地址 “apiKey”: “sk
–local”, // 认证密钥 “api”: “openai
–responses”, // API协议类型 “models”: [ { “id”: “openai/gpt
–oss
–20b”, //
模型唯一标识 “name”: “GPT OSS 20B (Local)”, // 显示名称 “contextWindow”: , // 上下文长度(token) “maxTokens”: 8192 openclaw // 最大输出token数 }, // 可添加多个
模型 { “id”: “llama3
–70b
–instruct”, “name”: “Llama3 70B Instruct”, “contextWindow”: 8000 } ] } } }, // AI
智能体
配置 [^1] ”
agents”: { “defaults”: { “model”: { “primary”: “vllm/openai/gpt
–oss
–20b” // 默认使用
模型 }, “memoryLength”: 10, // 上下文记忆轮次 “temperature”: 0.7 // 生成温度系数 }, “summarizer”: { // 特定任务
agent示例 “model”: “vllm/llama3
–70b
–instruct”, “maxTokens”: 2000 } }, // 服务器设置 [^4] “server”: { “port”: 8420, // 服务监听端口 “host”: “0.0.0.0”, // 绑定地址 “maxConcurrentRequests”: 10 // 并发请求限制 }, // 数据存储
配置 [^2] “database”: { “path”: “~/.
openclaw/data.db”, // 数据库路径 “cacheTTL”: 3600 // 缓存有效期(秒) }, // 日志设置 “logging”: { “level”: “info”, // 日志级别: debug/info/warn/error “path”: “~/.
openclaw/logs/” // 日志目录 } }
–
–
– 关键
配置项说明 |
配置段 | 参数 | 说明 | 示例值 | |
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–|
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–|
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–|
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–
–| | 全局设置 | `mode` | 系统操作模式(认证/协作等) | `”token”`或`”merge”` [^1][^3] | | | `token` | API访问令牌[^3] | 随机生成字符串 | |
模型
配置 | `providers` | 支持的
模型服务列表 | | | (models区域) | `models[].id` | 重要
模型唯一标识符(
agent直接调用此ID) | `”openai/gpt
–oss
–20b”` [^1] | | | `contextWindow` |
模型上下文容量(token数)[^1] | “ | |
智能体
配置 | `
agents.defaults` | 默认
agent
配置 | | | (
agents区域) | `primary` | 关键 设置主调
模型（格式：`providerID/modelID`） | `”vllm/openai/gpt
–oss
–20b”` [^1]| | | `temperature` | 生成结果随机性控制(0
–1.0) | `0.7` | | 硬件资源 | `maxConcurrentRequests` | 最大并发请求数(防止OOM)[^4] | `10` | | (server区域) | `port` | 服务暴露端口 | `8420` |
–
–
–
配置位置和操作 1. 默认路径 bash ~/.
openclaw/
openclaw.json # 主
配置文件 ~/.clawdbot/clawdbot.json # 兼容路径（旧版） 2. 编辑
配置文件 bash nano ~/.
openclaw/
openclaw.json # 使用文本编辑器修改 3. 验证
配置语法 bash jq . ~/.
openclaw/
openclaw.json # 确保JSON格式有效
–
–
– ⚠️ 核心注意事项 1. 修改
模型ID后需重启服务生效 2. 本地部署时`baseUrl`指向`localhost`[^1][^4] 3. 内存不足时优先降低`maxConcurrentRequests`[^4] 4. Token泄漏风险：确保
配置文件权限为`600` bash chmod 600 ~/.
openclaw/
openclaw.json [^1]:
OpenClaw
模型的提供者
配置和代理
模型设置 [^2]:
OpenClaw 数据库和存储路径
配置 [^3]:
OpenClaw 令牌认证模式示例 [^4]:
OpenClaw 服务端资源限制
配置建议