OpenClaw配置最全指南：openclaw.json配置教程，channels、agents、models、cron、bindings详解

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

很多人第一次用，最容易卡在 ~/.openclaw/：字段太多、改错一个就启动失败。

OpenClaw配置最全指南：openclaw.json配置教程，channels、agents、models、cron、bindings详解

这篇文章把官方文档里最常用的配置项按“能用、好理解、少踩坑”的方式重新整理一遍。你可以把它当成：OpenClaw 配置的速查+上手模板。

配置通常由这些模块组成：

channels 主要决定两件事：

1. 接入哪个平台（telegram/discord/slack/whatsapp…）

2. 谁可以来找你（DM 与群聊策略）

2.1 最常用的通用字段（记住这几个就够用）

2.2 DM Policy（私聊策略）怎么选

2.3 Group Policy（群聊策略）怎么选

2.4 渠道示例（照抄再改参数）

WhatsApp 示例（关键是 dmPolicy / allowFrom / textChunkLimit / mediaMaxMb / groups）：

{ "channels": { "whatsapp": { "dmPolicy": "pairing", "allowFrom": ["+"], "textChunkLimit": 4000, "mediaMaxMb": 50, "groups": { "*": { "requireMention": true } } } } }

Telegram 示例（关键是 botToken / groups / streaming）：

{ "channels": { "telegram": { "botToken": ":ABC...", "dmPolicy": "pairing", "groups": { "*": { "requireMention": true } }, "customCommands": [{ "command": "backup" }], "streaming": "partial" } } }

Discord 示例（关键是 token / guilds / threadBindings）：

{ "channels": { "discord": { "token": "...", "guilds": { "": { "requireMention": false, "channels": { "general": { "allow": true } } } }, "threadBindings": { "enabled": true } } } }

Slack 示例（关键是 botToken / appToken / slashCommand）：

{ "channels": { "slack": { "enabled": true, "botToken": "xoxb-...", "appToken": "xapp-...", "slashCommand": { "enabled": true } } } }

agents 用来定义你的 Agent 列表，以及默认行为。

一个典型配置长这样：

{ "agents": { "list": [ { "id": "agent_robot1", "workspace": "~/.openclaw/workspace/robot1", "model": "anthropic/claude-sonnet-4-6", "identity": { "name": "总助", "emoji": "👔" } } ], "defaults": { "model": { "primary": "anthropic/claude-sonnet-4-6" }, "maxConcurrent": 40000 } } }

你需要重点关注：

models 主要做两件事：

示例：

{ "models": { "mode": "merge", "providers": { "anthropic": { "baseUrl": " 
   
     
     
       ", "apiKey": "sk-ant-...", "models": [ { "id": "claude-sonnet-4-6", "contextWindow": , "maxTokens": 8192 } ] }, "openai": { "baseUrl": " 
      
        ", "models": [ { "id": "gpt-4.1", "contextWindow": } ] } } } }

提示：

Gateway 是 OpenClaw 的“入口服务”。最常动的配置是端口和鉴权：

{ "gateway": { "port": 18789, "auth": { "mode": "token", "token": "your-token" }, "reload": { "mode": "hybrid" } } }

热重载模式怎么选（简单版）

想每天 10 点自动写一篇文章？可以写 Cron：

{ "cron": [ { "id": "daily-article", "name": "公众号每日文章", "enabled": true, "schedule": "0 10 * * *", "payload": { "kind": "systemEvent", "text": "写一篇公众号文章" } } ] }

你最需要盯住的字段：

如果你有多个 Agent，就需要 bindings 来指定路由规则：

{ "bindings": [ { "agentId": "agent_robot1", "match": { "channel": "feishu", "accountId": "robot1" } }, { "agentId": "agent_robot2", "match": { "channel": "discord" } } ] }

理解方式：

OpenClaw 支持把 Key 写在 env 里：

{ "env": { "OPENROUTER_API_KEY": "sk-or-...", "ANTHROPIC_API_KEY": "sk-ant-...", "vars": { "GROQ_API_KEY": "gsk-..." } } }

环境变量来源优先级（从高到低）：

1. 系统环境变量

2. ~/.openclaw/.env（全局）

3. ./.env（工作区）

4. 配置文件 env 字段

如果你在多个环境部署，通常建议把 Key 放在系统环境变量或 .env，配置文件里少放敏感信息。

配置改完后，先做验证再重启，能省掉大量排查时间：

# 检查配置有效性 openclaw doctor # 自动修复配置问题 openclaw doctor --fix # 查看 Gateway 状态 openclaw gateway status # 跟踪日志 openclaw logs --follow

OpenClaw 官方文档：https://docs.openclaw.ai

OpenClaw配置最全指南：openclaw.json配置教程，channels、agents、models、cron、bindings详解

相关推荐