OpenClaw 配置文件 openclaw.json 完整参数说明

发布时间：2026-04-13 11:07:24 作者：SP八岐大兔

文章详细介绍了OpenClaw配置文件openclaw.json的各项参数配置,包括系统版本信息、配置向导记录、认证方式、模型服务配置、智能体默认配置、工具集配置、命令权限、会话策略、日志钩子、飞书通道配置、网关服务配置和插件配置等内容，感兴趣的朋友一起看看吧

注：修改配置后必须执行：openclaw gateway restart
编辑配置文件命令：

nano ~/.openclaw/openclaw.json

1. meta 配置段

"meta": {
    "lastTouchedVersion": "2026.3.13",
    "lastTouchedAt": "2026-03-16T05:36:26.133Z"
}

说明

lastTouchedVersion：OpenClaw 版本号
lastTouchedAt：配置最后修改时间
系统自动生成，禁止手动修改

2. wizard 配置段

"wizard": {
    "lastRunAt": "2026-03-16T05:10:35.535Z",
    "lastRunVersion": "2026.3.13",
    "lastRunCommand": "configure",
    "lastRunMode": "local"
}

说明

记录配置向导最后运行信息
无需修改，系统自动维护

3. auth 认证配置段

"auth": {
    "profiles": {
        "minimax:cn": {
            "provider": "minimax",
            "mode": "api_key"
        },
        "ollama:local": {
            "provider": "ollama",
            "mode": "api_key"
        }
    }
}

说明

定义模型服务商的认证方式
minimax：云端千问模型，API Key 认证
ollama：本地模型，模拟认证
mode 可选值：api_key / none

4. models 模型服务配置（核心）

"models": {
    "mode": "merge",
    "providers": {
        "minimax": {
            "baseUrl": "https://api.minimaxi.com/anthropic",
            "api": "anthropic-messages",
            "authHeader": true,
            "models": [
                {
                    "id": "MiniMax-M2.5",
                    "name": "MiniMax M2.5",
                    "reasoning": true,
                    "input": [
                        "text"
                    ],
                    "cost": {
                        "input": 0.3,
                        "output": 1.2,
                        "cacheRead": 0.03,
                        "cacheWrite": 0.12
                    },
                    "contextWindow": 200000,
                    "maxTokens": 8192
                }
            ]
        },
        "ollama": {
            "baseUrl": "http://127.0.0.1:11434",
            "api": "ollama",
            "apiKey": "ollama-local",
            "authHeader": true
        }
    }
}

说明

mode：模型加载策略
- merge：合并所有服务商模型（默认）
- override：仅使用配置内模型
ollama.baseUrl：Ollama 本地地址（固定 127.0.0.1:11434）
ollama.apiKey：本地任意填写，无需真实密钥

5. agents 智能体默认配置（最常改）

"agents": {
    "defaults": {
        "model": {
            "primary": "ollama/qwen2.5:7b",
            "fallbacks": ["minimax/MiniMax-M2.5"]
        },
        "models": {
            "minimax/MiniMax-M2.5": {
                "alias": "Minimax"
            },
            "ollama/qwen2.5:7b": {
                "alias": "Ollama-Qwen"
            }
        },
        "workspace": "/home/ubuntu24/.openclaw/workspace"
    }
}

说明

primary：默认使用模型
- ollama/qwen2.5:7b = 本地Ollama模型
- minimax/MiniMax-M2.5 = 云端模型
fallbacks：主模型不可用时自动切换
alias：模型显示别名，可自定义
workspace：文件操作工作目录，可修改

6. tools 工具集配置

"tools": {
    "profile": "coding"
}

说明

工具集类型
可选值：coding / basic / full

7. commands 命令权限配置

"commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true
}

说明

native：系统命令执行权限
- auto：智能判断（默认）
- allow：允许
- deny：禁止
restart：崩溃自动重启（true/false）

8. session 会话策略配置

"session": {
    "dmScope": "per-channel-peer"
}

说明

会话上下文隔离策略
可选值：
- per-channel-peer：按对话场景独立（推荐）
- global：全局共享会话

9. hooks 日志钩子配置

"hooks": {
    "internal": {
        "enabled": true,
        "entries": {
            "command-logger": {
                "enabled": true
            }
        }
    }
}

说明

系统内部日志钩子
command-logger：命令日志记录
默认开启即可，无需修改

10. channels 飞书通道配置

"channels": {
    "feishu": {
        "enabled": true,
        "connectionMode": "websocket",
        "verificationToken": "xxxxxxxxxxx",
        "dmPolicy": "pairing",
        "accounts": {
            "main": {
                "appId": "xxxxxxxxxxxxx",
                "appSecret": "xxxxxxxxxxxx",
                "botName": "xxxxxxx"
            }
        }
    }
}

说明

enabled：是否启用飞书机器人（true/false）
botName：机器人显示名称，可修改
appId / appSecret 禁止修改

11. gateway 网关服务配置

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
        "mode": "token",
        "token": "xxxx"
    },
    "tailscale": {
        "mode": "off",
        "resetOnExit": false
    },
    "nodes": {
        "denyCommands": [
            "camera.snap",
            "camera.clip",
            "screen.record",
            "contacts.add",
            "calendar.add",
            "reminders.add",
            "sms.send"
        ]
    }
}

说明

port：网关端口，可自定义
mode：访问范围
- local：仅本机访问
- network：局域网可访问
auth.mode：认证方式
- token：令牌认证（安全）
- none：无认证

12. plugins 插件配置

"plugins": {
    "entries": {
        "feishu": {
            "enabled": true
        }
    }
}

说明

插件开关
feishu.enabled：飞书插件启用/禁用

✅ 修改配置后必须执行

openclaw gateway restart

到此这篇关于OpenClaw 配置文件 openclaw.json 完整参数说明的文章就介绍到这了,更多相关OpenClaw 配置文件 openclaw.json 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

Tag：配置文件 OpenClaw openclaw.json

OpenClaw CLI 和配置文件参考完整指南
这篇文章主要介绍了OpenClaw CLI 和配置文件参考完整指南,本指南全面涵盖了这两方面,首先介绍配置文件：格式、结构以及每个主要部分的示例，需要的朋友可以参考下
2026-03-23
OpenClaw主配置文件参数使用大全
OpenClaw 使用 JSON/JSON5 格式的配置文件来管理系统所有组件的设置，支持灵活的配置覆盖、环境变量注入、多配置文件合并、热重载等功能,本文就来详细的介绍一下OpenClaw主
2026-03-10