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/ch
ain等 “providers”
: { “vllm”
: { “baseUrl”
: “http
://127.0.0.1
:8000/v1″, // 本地模型服务地址 “apiKey”
: “sk-local”, // 认证密钥 “api”
: “open
ai-responses”, // API协议类型 “models”
: [ { “id”
: “open
ai/gpt-oss-20b”, // 模型唯一标识 “name”
: “GPT OSS 20B
(Local
)“, // 显示名称 “contextWindow”
: , // 上下文长度
(token
) “maxTokens”
: 8192 // 最大输出token数 }, // 可添加多个模型 { “id”
: “llama3-70b-instruct”, “name”
: “Llama3 70B Instruct”, “contextWindow”
: 8000 } ] } } }, //
AI智能体
配置 [^1] ”
agents”
: { “defaults”
: { “model”
: { “primary”
: “vllm/open
ai/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
) | `”open
ai/gpt-oss-20b”` [^1] | | | `contextWindow` | 模型上下文容量
(token数
)[^1] | “ | | 智能体
配置 | `
agents.defaults` openclaw 配置 | 默认
agent
配置 | | |
(
agents区域
) | `primary` | 关键 设置主调模型（格式：`providerID/modelID`） | `”vllm/open
ai/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 服务端资源限制
配置建议