你是否有过这样的经历？

装好了 OpenClaw，配置文件摆在面前，却不敢动一下。生怕改错了什么，整个系统就崩了。我完全理解这种心情——毕竟配置文件中密密麻麻的参数，看得头皮发麻。

但今天我想告诉你：配置文件不是圣旨，它是你的工具箱。敢改、会修，才是真正掌握 OpenClaw 的标志。

这篇文章会带你彻底读懂 OpenClaw 2026.3.13 的配置。每个模块是干什么的、能不能改、怎么改，我会结合实际配置示例，给你讲得明明白白。

---

你的配置里到底有什么

配置文件位于 ~/.openclaw/openclaw.json。这是你的 OpenClaw 大脑，所有定制化都从这里开始。（注：配置文件采用 JSON5 格式，支持注释和尾随逗号）

打开配置文件，看看顶层结构。你会发现它由十几个主要模块组成：gateway、channels、models、agents、session、messages、hooks、logging、skills、plugins、tools、cron、ui……每一个模块管着一摊事。

别被数量吓到。配置文件的逻辑其实很清晰：告诉 OpenClaw 在哪运行（gateway）、用什么渠道聊天（channels）、用哪个模型思考（models）、AI 是谁（agents）、怎么处理会话（session）、怎么回消息（messages）、自动化怎么跑（hooks）、日志往哪记（logging）、技能有哪些（skills）……

接下来，我会挑最核心的模块，一个一个拆开来讲。

---

gateway：OpenClaw 怎么跑，你来定

gateway 模块告诉 OpenClaw 怎么启动、监听哪个端口、用什么方式连接。

一个典型的配置是这样的：

"gateway": {
  "port": 18789
}

这是最简单也是最核心的配置。port 就是 Gateway 监听的端口，OpenClaw 通过这个端口和各个渠道通信。

除了 port，gateway 还有几个常用参数：

mode 决定运行模式，默认是 local，适合个人使用。如果你想让朋友也能访问你的 OpenClaw，可以改成 remote 配合 tailscale 实现远程访问。

bind 控制绑定地址，默认是 loopback，只允许本机访问。改成 0.0.0.0 就能让局域网其他设备访问，不过考虑到安全，一般不建议这么做。

auth 是认证配置。可以设 token 或 password，防止别人随便访问你的 OpenClaw。

tailscale 是近几年最火的远程访问方案。如果你在不同设备、不同网络环境下使用 OpenClaw，配好 tailscale 就能像在本地一样访问，完全不用折腾内网穿透。

⚠️ 记住一句话：port 这种核心配置，改了必须重启 Gateway 才能生效。不是热重载，是真的 restart。命令是 openclaw gateway restart。

---

channels：你在哪里和 AI 聊天

channels 模块配置 OpenClaw 支持哪些聊天渠道。目前支持飞书、WhatsApp、Telegram、Discord、Signal 等主流平台。

以飞书为例，完整配置会包含 appId、appSecret、verificationToken 等字段：

"channels": {
  "feishu": {
    "enabled": true
  }
}

channels 有几个关键参数值得注意：

dmPolicy 控制私聊策略。可以设 allow-all 或 deny-all，决定是否允许陌生人私信。

groupPolicy 控制群聊策略。同理，可以管理哪些群能接入。

allowFrom 是白名单机制。这个特别重要！建议只配置你常用的账号或群，防止有人不小心把你的 OpenClaw 拉到陌生群聊里，造成不必要的消息消耗和经济损失。

简单说：channels 决定 OpenClaw 在哪接消息。配对了地方，AI 才能和你正常聊天。

---

models：用什么脑子思考

models 模块告诉 OpenClaw 用哪个 AI 模型来思考和回答。这是整个系统最核心的配置之一，直接决定 AI 有多聪明。

以上示例用的是火山引擎的 Minimax M2.5 模型：

"models": {
  "mode": "merge",
  "providers": {
    "custom-ark-cn-beijing-volces-com": {
      "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
      "apiKey": "***",
      "api": "openai-completions",
      "models": [
        {
          "id": "minimax-m2.5"
        }
      ]
    }
  }
}

这是国产大模型里表现相当不错的一个，尤其在中文场景下。

mode 有两个选项：merge 和 replace。merge 模式下，你可以配置多个模型供应商，OpenClaw 会根据情况自动选择。replace 模式下，只用指定的模型。

providers 是供应商列表。每个供应商需要配置 baseUrl、apiKey、api 类型和模型列表。

一个常见坑：baseUrl 结尾必须有 /v1。忘了加斜杠，模型就调不通。

如果你想换模型，比如用 Kimi 或者 DeepSeek，只需要在这里添加新的 provider，然后指定使用哪个模型的 id 就够了。

---

agents：你的 AI 是谁

agents 模块定义 Agent 的身份信息。一个 OpenClaw 可以跑多个 AI，每个 AI 有自己的名字、性格、头像。

以上示例配置是这样的：

"agents": {
  "list": [
    {
      "id": "main",
      "identity": {
        "name": "小噜",
        "emoji": "🦊"
      }
    }
  ]
}

id 是 Agent 的唯一标识，identity 里的 name 和 emoji 会出现在各个聊天渠道里。

配置的是「小噜」，狐狸 emoji。这就是 AI 在各渠道的形象。

如果想搞点新花样，比如同时跑两个不同性格的 AI，只需要在 list 里加对象就行。一个负责聊天，一个负责写代码，各干各的。

---

session：会话怎么管理

session 模块控制 OpenClaw 怎么管理会话历史、什么时候重置、怎么清理旧数据。

这部分配置比较长，但都很实用：

"session": {
  "scope": "per-sender",
  "dmScope": "main",
  "reset": {
    "mode": "daily",
    "atHour": 4
  }
}

scope 决定会话范围。per-sender 模式下，每个 sender（发送者）有独立的会话。per-channel 模式下，每个渠道共享会话。

reset 决定什么时候重置会话。daily 模式每天固定时间重置，idle 模式超过一定时间没活动才重置。以上示例配置是每天凌晨 4 点重置。

maintenance 控制存储维护。OpenClaw 会自动清理旧会话，防止磁盘爆满。你可以设保留多少天、最大多少条记录。

简单说：session 帮你管理「记忆」。配对了，AI 记得住上下文；配错了，AI 可能每次都失忆，或者把硬盘撑爆。

---

messages：消息怎么回

messages 模块控制 OpenClaw 怎么回复消息、加不加前缀、怎么标记已读。

以上示例配置：

"messages": {
  "ackReactionScope": "group-mentions"
}

responsePrefix 可以在每条回复前加前缀，比如显示模型名、思考状态。你用的是默认配置，没开这个。

ackReaction 是已读回执的表情。你可以用任何 emoji。

ackReactionScope 决定什么时候标记已读。group-mentions 模式下，群聊里只有 @ 你的消息才会标已读。这个很实用，不然群聊一多，消息列表全是已读，难受。

queue 控制消息队列行为。如果你在多个渠道同时狂聊，队列模式可以避免 AI 手忙脚乱。

---

hooks：自动化流水线

hooks 是 OpenClaw 最强大的特性之一：在 Agent 生命周期的各个阶段自动执行自定义逻辑。

以上示例配置：

"hooks": {
  "entries": {
    "boot-md": { "enabled": true },
    "bootstrap-extra-files": { "enabled": true },
    "session-memory": { "enabled": true },
    "command-logger": { "enabled": true },
    "audit-logger": { "enabled": true }
  }
}

boot-md 启动时加载工作目录里的文档。每次 OpenClaw 启动，会自动读取 AGENTS.md、USER.md 这些文件，了解自己是谁、怎么说话。

session-memory 维持会话记忆。打开这个，AI 才能记得住你们之前聊了什么。关掉试试？每次都是全新对话。

command-logger 记录你用 exec 工具执行的命令。方便回溯、审计。

audit-logger 是安全审计功能。所有命令执行、工具调用都会被记录，关键时刻能救命。

⚠️ 新手别随便关 hook，尤其是 session-memory。关掉之后，AI 就真的变成「金鱼」了。

---

logging：日志与安全 ⭐

logging 配置亮眼的地方在于安全脱敏：

"logging": {
  "level": "info",
  "consoleLevel": "info",
  "consoleStyle": "pretty",
  "redactSensitive": "tools",
  "redactPatterns": ["sk-.*", "eyJ.*"]
}

level 控制文件日志级别。debug 最详细，info 是日常，warn 只记录警告。建议本地开发开 debug，生产环境开 info。

consoleStyle 控制终端输出格式。pretty 是彩色格式，compact 是单行格式。彩色更适合本地调试。

redactSensitive 自动脱敏。设为 tools 时，所有工具参数里的敏感信息都会被隐藏。

redactPatterns 是正则匹配。上例配置会过滤掉所有 sk- 开头的字符串和 eyJ 开头的字符串，防止 API Key 在日志里裸奔。

这就是企业级的安全意识。

---

skills 和 plugins：能力扩展

skills 配置技能开关：

"skills": {
  "entries": {
    "wechat-viral": { "enabled": true },
    "healthcheck": { "enabled": true },
    "node-connect": { "enabled": true },
    "weather": { "enabled": true }
  }
}

以上示例启用了四个技能：写爆款公众号文章、健康检查、节点连接、查天气。每个技能都是独立的能力模块，需要时打开，不需要时关掉。

plugins 配置插件：

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

飞书插件已启用。这是连接飞书的桥梁。

---

还有几个不能乱改的

有些配置是系统管理的，别手欠：

wizard 和 meta 是 OpenClaw 自己维护的元数据。版本号、上次运行时间这些信息都存这里。手动改不一定生效，还可能出问题。

mainKey 是遗留字段，早就被 agents.list 取代了。别管它。

Bridge 模块已经被移除，别找了。

---

真的改了出问题怎么办

说了这么多，你可能还是担心：万一改坏了呢？

放心，有后手。

第一招：热重载。 大部分配置改完保存，OpenClaw 会自动重新加载，不用重启。

第二招：doctor --fix。 这是 OpenClaw 内置的配置医生。运行 openclaw doctor --fix，它会检测配置问题并尝试自动修复。

第三招：备份。 改配置之前，执行 cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak。出问题了，一条命令就能恢复。

第四招：看日志。 配错了，日志会告诉你哪里有问题，可以打开网页找日志，也可以直接打开本地日志文件，日志详细得可怕

---

写在最后

配置文件不是圣旨，它是你的工具箱。

OpenClaw 为什么好用？因为它把控制权交给了你。哪个渠道能接、哪个模型能用、哪些技能要开、哪些日志要记——全部由你决定。

不敢改，永远只是使用者。敢改、会修，才能成为真正的主人。

下次面对配置文件，别慌。记住这句话：敢改+会修，才是真掌握。

---

本文基于 OpenClaw v2026.3.13 版本编写，配置示例仅供参考，请根据实际情况调整。