O arquivo de configuração openclaw.json
Abra ~/.openclaw/openclaw.json e aprenda como seu formato JSON5 define o comportamento do OpenClaw.
O arquivo de configuração openclaw.json é uma aula grátis de OpenClaw Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de OpenClaw Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de OpenClaw Academy inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
Where Config Lives
OpenClaw reads its settings from a single config file. Edit it and you change how your assistant behaves, all in one place. 🛠️
The Exact Path
The file lives at ~/.openclaw/openclaw.json in your home folder. That hidden folder is where OpenClaw keeps its setup.
cat ~/.openclaw/openclaw.jsonIt Is JSON5
The file uses JSON5, a friendlier flavor of JSON. It allows comments and trailing commas, so the config is easier to read and edit.
Why JSON5 Helps
Because it is JSON5, you can leave yourself notes with comments. That keeps a growing config clear about why each setting is there.
{
// who can message me
channels: {}
}What the File Shapes
This one file shapes your assistant's behavior: which channels connect, who is allowed in, and when it should reply.
The Top-Level Shape
At the root you will mostly see a channels object plus a messages object. Each holds settings grouped by what they control.
{
channels: { },
messages: { }
}Channels Object
The channels object groups settings per platform, like WhatsApp or Telegram. Each platform gets its own block of options.
channels: {
whatsapp: { },
telegram: { }
}Editing Safely
Open the config in any text editor you like. Save your change, then restart OpenClaw so it picks up the new settings.
nano ~/.openclaw/openclaw.jsonKeep It Valid
Even with JSON5, structure matters. A misplaced brace can stop the file from loading, so keep your braces and quotes balanced.
Small Edits Win
Change one setting at a time, then test. Small steps make it easy to see what each option actually does to your assistant.
Your Control Panel
Think of openclaw.json as your control panel. Everything you tune in this course flows from edits to this single file.
Quick Check
Let us confirm where and what the config file is.
Recap
You found OpenClaw's brain: ~/.openclaw/openclaw.json, a JSON5 file. One place to shape channels, access, and replies. Next, who gets in. ✅
Perguntas Frequentes
A aula “O arquivo de configuração openclaw.json” é grátis?
Sim — o texto completo de “O arquivo de configuração openclaw.json” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de OpenClaw Academy, atualize para CoddyKit PRO. O curso de OpenClaw Academy inclui 4 aulas no total.
O que vou aprender em “O arquivo de configuração openclaw.json”?
Abra ~/.openclaw/openclaw.json e aprenda como seu formato JSON5 define o comportamento do OpenClaw. Você pratica OpenClaw Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar OpenClaw Academy?
Nenhuma experiência prévia é necessária. OpenClaw Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “O arquivo de configuração openclaw.json”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de OpenClaw Academy?
Sim. Cada aula de OpenClaw Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- O arquivo de configuração openclaw.json
- Permitir remetentes com allowFrom
- Regras de grupo com requireMention e mentionPatterns
- Padrões quando nada é configurado