~/.openclaw/openclaw.json

{  "models": {    "providers": {      "openai": {        "apiKey": "${OPENAI_API_KEY}"      }    }  }}

{  "agents": {    "list": [{      "id": "my-agent",      "groupChat": {        "mentionPatterns": ["机器人", "助手", "@my_bot"]      }    }]  }}

{  "channels": {    "telegram": {      "enabled": true,      "botToken": "YOUR_BOT_TOKEN",      "dmPolicy": "pairing",      "groupPolicy": "open",      "allowFrom": ["123456789"],      "groups": {        "-1001234567890": {          "requireMention": true,          "enabled": true        }      },      "accounts": {        "default": {          "botToken": "BOT_TOKEN_1"        },        "scholar": {          "botToken": "BOT_TOKEN_2"        }      }    }  }}

{  "channels": {    "discord": {      "token": "YOUR_DISCORD_BOT_TOKEN",      "dmPolicy": "pairing",      "guilds": {        "GUILD_ID": {          "enabled": true,          "ignoreOtherMentions": true        }      },      "voice": {        "enabled": true,        "autoJoin": true      }    }  }}

{  "channels": {    "whatsapp": {      "enabled": true,      "dmPolicy": "pairing",      "accounts": {        "default": {          "sendReadReceipts": true        }      }    }  }}

{  "channels": {    "telegram": {      "defaultAccount": "default",      "accounts": {        "default": {          "botToken": "TOKEN_1"        },        "butler": {          "botToken": "TOKEN_2"        },        "scholar": {          "botToken": "TOKEN_3"        }      }    }  }}

provider/model-id

{  "agents": {    "defaults": {      "model": "freeapi/gpt-5.2",      "imageModel": "openai/gpt-4o",      "pdfModel": "anthropic/claude-sonnet-4-6"    }  }}

{  "agents": {    "defaults": {      "models": {        "anthropic/claude-opus-4-6": {          "alias": "opus",          "params": {            "temperature": 0.7,            "maxTokens": 4096          }        },        "openai/gpt-5.4": {          "alias": "gpt"        }      }    }  }}

{  "agents": {    "defaults": {      "model": {        "primary": "anthropic/claude-opus-4-6",        "fallbacks": ["openai/gpt-5.4", "google/gemini-3.1-pro-preview"]      }    }  }}

{  "models": {    "mode": "merge",    "providers": {      "my-custom-provider": {        "baseUrl": "https://api.example.com/v1",        "apiKey": "${MY_API_KEY}",        "api": "openai-completions",        "models": [          {            "id": "my-model",            "contextWindow": 128000,            "maxTokens": 8192          }        ]      }    }  }}

{  "agents": {    "defaults": {      "workspace": "~/.openclaw/workspace",      "repoRoot": "/path/to/repo",      "model": "provider/model-id",      "maxConcurrent": 1,      "timeoutSeconds": 1800,      "contextTokens": 1000000,      "imageMaxDimensionPx": 1200,      "userTimezone": "Asia/Shanghai",      "timeFormat": "auto"    }  }}

{  "agents": {    "defaults": {      "skipBootstrap": false,      "bootstrapMaxChars": 20000,      "bootstrapTotalMaxChars": 150000    }  }}

{  "agents": {    "list": [      {        "id": "main",        "default": true,        "workspace": "~/.openclaw/workspace-main",        "groupChat": {          "mentionPatterns": ["诺玛", "@main_bot"]        }      },      {        "id": "butler",        "workspace": "~/.openclaw/workspace-butler",        "groupChat": {          "mentionPatterns": ["管家", "@butler_bot"]        }      },      {        "id": "scholar",        "workspace": "~/.openclaw/workspace-scholar",        "groupChat": {          "mentionPatterns": ["学霸", "@scholar_bot"]        }      }    ]  }}

{  "bindings": [    {      "agentId": "main",      "match": {        "channel": "telegram",        "accountId": "default"      }    },    {      "agentId": "butler",      "match": {        "channel": "telegram",        "accountId": "butler"      }    },    {      "agentId": "scholar",      "match": {        "channel": "telegram",        "accountId": "scholar"      }    }  ]}

{  "agents": {    "defaults": {      "heartbeat": {        "every": "30m",        "suppressToolErrorWarnings": true,        "directPolicy": "allow",        "lightContext": true      }    }  }}

{  "agents": {    "defaults": {      "compaction": {        "mode": "safeguard",        "identifierPolicy": "strict",        "model": "anthropic/claude-sonnet-4-6",        "memoryFlush": {          "enabled": true,          "softThresholdTokens": 6000        }      }    }  }}

{  "agents": {    "defaults": {      "sandbox": {        "mode": "off",        "workspaceAccess": "rw",        "scope": "agent",        "docker": {          "image": "openclaw-sandbox:latest",          "network": "none",          "binds": ["/host/path:/container/path"]        }      }    }  }}

{  "messages": {    "tts": {      "auto": "always",      "provider": "edge"    }  }}

{  "messages": {    "tts": {      "auto": "always",      "provider": "edge",      "edge": {        "enabled": true,        "voice": "zh-CN-XiaoxiaoNeural",        "lang": "zh-CN",        "outputFormat": "ogg-24khz-16bit-mono-opus",        "rate": "+0%",        "pitch": "+0%",        "volume": "+0%"      }    }  }}

{  "messages": {    "tts": {      "auto": "always",      "provider": "openai",      "openai": {        "voice": "alloy",        "model": "tts-1"      }    }  }}

{  "enabled": true,  "provider": "edge",  "maxLength": 10000,  "summarize": false}

/tts on          # 开启 TTS（等同于 /tts always）/tts off         # 关闭 TTS/tts always      # 总是生成语音/tts inbound     # 只在收到语音后回复语音/tts tagged      # 只在标记时生成语音/tts audio       # 生成一次性语音回复/tts limit 5000  # 设置长度限制

这是中文内容。[[tts:voice=en-US-JennyNeural]][[tts:text]]This is English content.[[/tts:text]]继续中文内容...

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

{  "session": {    "reset": {      "mode": "idle",      "idleMinutes": 30    },    "resetByType": {      "direct": {        "mode": "idle",        "idleMinutes": 30      },      "group": {        "mode": "idle",        "idleMinutes": 60      }    }  }}

{  "tools": {    "allow": ["*"],    "deny": ["exec", "process"],    "profile": "coding"  }}

{  "tools": {    "web": {      "search": {        "enabled": true,        "provider": "brave",        "maxResults": 10      },      "fetch": {        "enabled": true,        "maxCharsCap": 50000      }    }  }}

{  "tools": {    "agentToAgent": {      "enabled": true,      "allow": ["main", "butler", "scholar"]    }  }}

{  "tools": {    "exec": {      "host": "gateway",      "security": "full"    },    "elevated": {      "enabled": true,      "allowFrom": {        "telegram": ["123456789"]      }    }  }}

{  "browser": {    "enabled": true,    "defaultProfile": "openclaw",    "executablePath": "/usr/bin/chromium"  }}

{  "browser": {    "profiles": {      "openclaw": {        "color": "orange",        "cdpPort": 18800      },      "work": {        "color": "blue",        "cdpPort": 18801      }    }  }}

{  "browser": {    "profiles": {      "browserless": {        "cdpUrl": "wss://chrome.browserless.io?token=YOUR_TOKEN"      }    }  }}

# 查看状态openclaw browser status# 截图openclaw browser screenshot --full-page# AI 快照openclaw browser snapshot# 交互模式快照（带 ref）openclaw browser snapshot --interactive# 点击元素openclaw browser click 12        # AI snapshot 数字 refopenclaw browser click e12       # Role snapshot ref# 输入文字openclaw browser type 23 "hello" --submit# 导航openclaw browser navigate https://example.com

{  "tools": {    "media": {      "audio": {        "enabled": true,        "maxBytes": 20971520,        "maxChars": null,        "echoTranscript": false,        "models": [          {            "provider": "openai",            "model": "gpt-4o-mini-transcribe"          }        ]      }    }  }}

{  "channels": {    "telegram": {      "groups": {        "-1001234567890": {          "requireMention": true,          "disableAudioPreflight": false        }      }    }  }}

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

~/.openclaw/hooks/my-hook/├── HOOK.md└── handler.ts

---emoji: "📝"events:  - command:new  - command:reset---# My Custom HookDescription of what this hook does.

import { HookHandler } from 'openclaw';const handler: HookHandler = async (event, context) => {  // 处理事件  console.log('Event:', event);};export default handler;

# 列出所有 Hooksopenclaw hooks list# 查看 Hook 详情openclaw hooks show session-memory# 启用/禁用 Hookopenclaw hooks enable session-memoryopenclaw hooks disable session-memory# 检查 Hook 是否符合条件openclaw hooks check session-memory

{  "cron": {    "enabled": true,    "store": "~/.openclaw/cron/jobs.json",    "sessionRetention": "24h",    "runLog": {      "maxBytes": 2000000,      "keepLines": 2000    },    "jobs": [      {        "id": "daily-summary",        "enabled": true,        "schedule": {          "kind": "cron",          "expr": "0 9 * * *",          "tz": "Asia/Shanghai"        },        "sessionTarget": "isolated",        "payload": {          "kind": "agentTurn",          "message": "Generate daily summary"        },        "delivery": {          "mode": "announce",          "channel": "telegram",          "to": "123456789"        }      }    ]  }}

# 查看状态openclaw cron status# 列出任务openclaw cron list# 添加一次性任务openclaw cron add --at "2026-03-15T09:00:00+08:00" --message "Reminder"# 添加重复任务openclaw cron add --every 30m --message "Check status"# 添加 cron 任务openclaw cron add --cron "0 9 * * *" --message "Daily task"# 编辑任务openclaw cron edit <jobId> --message "New message"# 删除任务openclaw cron remove <jobId># 立即运行任务openclaw cron run <jobId># 查看运行历史openclaw cron runs --id <jobId>

{  "gateway": {    "port": 18789,    "mode": "local",    "bind": "loopback",    "auth": {      "mode": "token",      "token": "your-secure-token"    }  }}

{  "gateway": {    "tls": {      "enabled": true,      "autoGenerate": true    }  }}

curl http://127.0.0.1:18789/health# 返回：{"ok":true,"status":"live"}

{  "commands": {    "native": "auto",    "restart": true,    "bash": false,    "config": false,    "ownerDisplay": "raw"  }}

# 检查配置问题openclaw doctor# 自动修复问题openclaw doctor --fix# 查看日志openclaw logs# 健康检查openclaw health# 运行状态openclaw status

/tmp/openclaw/openclaw-YYYY-MM-DD.log~/.openclaw/logs/commands.log

{  "agents": {    "defaults": {      "model": "anthropic/claude-sonnet-4-6"    }  },  "channels": {    "telegram": {      "botToken": "YOUR_BOT_TOKEN",      "dmPolicy": "pairing"    }  }}