OpenClaw 配置文件深度解析｜搞懂 7 个核心文件，让 AI 从“傻白甜”变“智能助手”

本系列第十二篇：从“能用”到“真好用”——把 workspace 里的每一份文件都变成 AI 的行动指南欢迎回到 OpenClaw 系列教程。经过前面十一篇，你已经完成了 OpenClaw 的安装、模型配置和基础部署，它已经能跑起来了。看着终端里那个能跟你聊天、帮你查资料的 AI 机器人，心里肯定挺有成就感。但过不了几天，你就会发现一个现象：它怎么还是像在跟陌生人聊天？每次都得重新交代一遍背景、偏好和上下文；它说话没固定风格，今天干练明天啰嗦；甚至有时候会做出一些让你匪夷所思的操作——比如你说“帮我整理一下代码”，它直接把.env配置文件删了。问题出在哪？别急着怪大模型变笨，也别急着骂 Skills 没用。真正的问题在于：你从来没有认真配置过几个藏在系统底层的配置文件。今天这篇，带你搞懂 OpenClaw 的 7 个核心配置文件。读完这篇文章，你的 OpenClaw 将从“能启动”升级到“真好用”——它知道自己是谁、该怎么说话、你讨厌什么、做事有什么规矩。一、两张“办公桌”：分清两个核心目录在开始配置之前，必须先搞清楚 OpenClaw 的两个核心目录分别管什么。把这两张“办公桌”的职责分清，后面的配置才不会乱。1.1 openclaw.json——HR 系统位于~/.openclaw/openclaw.json，这是 OpenClaw 的技术配置中枢。它负责：模型选择（用哪个大模型、API Key 是什么）渠道接入（微信/飞书/Telegram 的 Token 怎么配）网关参数（监听哪个端口、是否开启沙箱）会话管理（记忆存储位置、心跳频率）你可以把它想象成HR 系统——它决定 Agent 的“入职手续”：分配到哪个工作区、接通哪些渠道、对接哪个大模型、享有哪一级权限。它管的是调度和资源分配。1.2 workspace 目录——Agent 的办公桌位于~/.openclaw/workspace/，这是一个Agent 的工作内容区。OpenClaw 使用单一智能体工作区目录作为智能体工具和上下文的唯一工作目录。这个目录里存放着让 AI“有灵魂”的核心文件——告诉 AI 它是什么性格、怎么干活、为谁服务。你可以把它想象成 Agent 的办公桌——桌上的每一份文件，都在告诉 Agent“你是谁、帮谁干活、怎么干活”。💡一句话区分：openclaw.json是 HR 系统，负责把这张桌分配给对的人、接上对的线路；workspace 里的文件是桌上的内容，负责教 AI“怎么工作”。两者别混。1.3 找到这些文件命令行方式：bash# 查看主配置文件 cat ~/.openclaw/openclaw.json # 查看 workspace 目录下的所有文件 ls ~/.openclaw/workspace/ # 进入 workspace 目录 cd ~/.openclaw/workspace/WebUI 方式：访问http://localhost:18789/overview，点击左侧“代理”→当前 Agent→文件，选择对应的 md 文件进行修改。如果工作区尚未初始化，运行openclaw setup即可创建配置文件并初始化工作区文件。二、openclaw.json 逐层拆解我们先把openclaw.json打开看看。OpenClaw 的配置采用 JSON5 格式，比普通 JSON 友好得多——你可以写注释（//），可以在最后一项后面加逗号，甚至可以用单引号。这为我们这种“试错型”选手提供了极大的便利。别被几十行甚至上百行的配置吓住。OpenClaw 的配置结构非常清晰，就像一套三居室的房子，每个房间管不同的事。json{ // 1. Agent 配置区——管机器人怎么思考（这是灵魂） "agents": { ... }, // 2. 模型配置区——管用哪个脑子 "models": { ... }, // 3. 渠道配置区——管在哪聊天 "channels": { ... }, // ⚙️ 4. 系统与工具区——管端口、会话、浏览器等 "gateway": { ... }, "session": { ... }, "