openclaw.json 配置教程 OpenClaw 核心模块参数及修改规范

本文详细梳理 openclaw.json 配置文件的全量配置项，涵盖 meta、wizard、auth 等 12 个核心模块，明确各配置段的功能、参数含义及修改规范。其中 models 模型服务、agents 智能体配置为核心重点，auth 认证、gateway 网关等模块需严格遵循说明设置，所有配置修改后，务必执行重启命令，确保配置生效。

编辑 openclaw.json 配置文件命令：

nano ~/.openclaw/openclaw.json

1. meta 配置段

"meta": {
    "lastTouchedVersion": "2026.4.13",
    "lastTouchedAt": "2026-04-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": "",
            "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.json 各配置段分工明确，核心模块需重点关注参数准确性，非指定可修改项禁止手动改动。请严格按照各模块说明完成配置调整，牢记修改后必须执行openclaw gateway restart命令，保障 OpenClaw 服务正常运行，避免因配置失误或未重启导致服务报错、无法正常使用。

以上关于openclaw.json 配置教程 OpenClaw 核心模块参数及修改规范的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。