夜雨聆风小白入门｜OpenClaw 14 天打卡 Day2 认识网关及配置文件，手把手教学
从"会安装"到"会使用"的关键一步，彻底搞懂网关和配置文件！
哈喽各位小伙伴昨天我们成功把 OpenClaw 装到了电脑上，启动了网关，完成了第一次打卡。
其实作为小白用户来讲，我在纠结到底要不要重点来学习今天的内容，因为毕竟国内已经有很多的套壳龙虾，已经把相关的配置文件写死或者配置好了，不用我们来自己配置。
从双牛老K玩了一个月的经验来看，如果以后要真正的使用和学习 OpenClaw，这一课绝对是迈不过去的坎！因为我们在更新或者在备份的时候一定使用到的就是配置文件。就算不会也要知道他是做什么的，每个模块的作用！
很早之前看过一段话，说随着移动互联网的发展，现在我们每天学习和接触到的很多都是碎片化知识，如果能把所学的知识体系化，那就非常厉害了。
这也是我出这个 14 天打卡训练营的初衷所在，既然这个 Agent 是未来大势所趋，我们肯定要接触要使用，就要体系化学习。
所以今天认识网关 (gateway) 和配置文件 (openclaw.json) 也必不可少了，也在这个体系内不可或缺的模块！
新手痛点
但很多新手小伙伴可能会问：
「网关到底是什么？为什么必须启动它才能用 OpenClaw？」
「配置文件在哪里？里面的代码都是干嘛的？改坏了怎么办？」
「我想给 OpenClaw 换个 AI 模型、加个飞书插件，要怎么操作？」
别着急！今天，我们就来解决这些核心问题——彻底搞懂 OpenClaw 的网关和配置文件，这是你从"会安装"到"会使用"再到"会定制"的关键一步。
我会用大白话 + 手把手操作，从基础概念讲到实战修改，每个配置模块都给你详细拆解，让你看完就能上手改配置！
先搞懂！两个核心概念（新手必看，5 分钟入门）
一、网关（Gateway）：OpenClaw 的"总控中心"
大白话解释： 网关就是 OpenClaw 的大脑后台 + 通信枢纽，你可以把它想象成家里的路由器——所有设备（AI 模型、插件、远程控制、本地技能）都要通过它连接、通信和协调工作。
网关的 3 个核心作用：
1. 管理连接：负责和 AI 大模型、飞书/微信等消息渠道、本地技能插件建立连接 2. 处理请求：接收你的指令，分发给对应的 AI/插件处理，再把结果返回给你 3. 安全控制：验证身份、管理权限，防止别人随便用你的 OpenClaw
⚠️ 关键知识点： 只有网关正常运行（running 状态），你才能用 OpenClaw 的所有功能；网关停了，一切操作都用不了，这就是为什么 Day1 我们要先启动网关。
二、配置文件（openclaw.json）：OpenClaw 的"说明书 + 控制面板"
大白话解释： 配置文件就是一个纯文本的设置清单，里面记录了 OpenClaw 的所有运行规则——用哪个 AI 模型、开哪个端口、装哪些插件、允许谁访问等等。
配置文件的 3 个核心特点：
1. 位置固定：默认在 ~/.openclaw/openclaw.json（macOS）或C:\Users\用户名\.openclaw\openclaw.json（Windows）2. 格式简单：用 JSON 格式编写，新手也能看懂，不用学复杂编程 3. 修改生效：改完配置文件，重启网关就能应用新设置，完全可逆，改坏了还能恢复默认
✅ 新手定心丸： 配置文件是"纯文本文件"，不会自动改你电脑的系统设置，就算改坏了，大不了删掉重新生成一个，绝对不会搞坏你的电脑！
实战操作 1｜网关基础操作 + 状态查询（3 分钟搞定）
昨天我们学了启动网关的命令，今天再补充几个常用操作，让你能轻松管理网关状态。
1. 查看网关状态（最常用，每天开机先查这个）
macOS 和 Windows 通用命令，复制粘贴回车：
openclaw gateway status 正常输出说明：
• status=running：网关正常运行（✅），此时可以正常使用 OpenClaw 的所有功能• status=stopped：网关未启动（❌），执行openclaw gateway start命令即可启动• port 18789 status: unused：端口未被占用（⚠️），需检查网关是否真的启动，或确认 18789 端口是否被其他程序占用
2. 常用网关命令（收藏备用）
启动网关：
openclaw gateway start 停止网关：
openclaw gateway stop 重启网关（改配置后必执行）：
openclaw gateway restart 查看网关日志（排查问题用）：
openclaw gateway logs ⚠️ 避坑提示： 修改配置文件后，必须重启网关才能生效！这是新手最容易忘的一步，改完配置后一定要执行
openclaw gateway restart。
💡 双牛老 K 经验： 用了这几天，在安装一些 SKILL 的时候，它会修改配置，因为版本问题一些字段不兼容，就用
openclaw doctor和openclaw doctor --fix修复一下。
实战操作 2｜找到并打开配置文件（分系统手把手）
要修改配置，第一步就是找到并打开配置文件。别担心，一点都不难，跟着做就行！
一、macOS 系统
步骤 1：打开终端，用命令直接打开配置文件
用系统默认文本编辑器打开（推荐新手）：
open ~/.openclaw/openclaw.json 或用 VS Code 打开（如果装了 VS Code）：
code ~/.openclaw/openclaw.json 二、Windows 系统
步骤 1：以管理员身份打开 PowerShell，用命令打开配置文件
用记事本打开（系统自带，推荐新手）：
notepad $env:USERPROFILE\.openclaw\openclaw.json 或用 VS Code 打开：
code $env:USERPROFILE\.openclaw\openclaw.json ⚠️ 新手避坑： 如果提示"文件不存在"，别慌！这是因为你还没生成过配置文件，执行下面的命令就能创建一个默认配置：
echo'{"gateway":{"mode":"local"},"plugins":{"entries":{}}}' > ~/.openclaw/openclaw.json 执行完再打开，就能看到配置文件了。
核心重点｜配置文件全模块拆解
OpenClaw 的配置文件（openclaw.json）由多个核心模块组成，每个模块负责不同的功能。
我给你整理了新手最常用的 8 个模块，从基础到进阶，每个模块都包含「代码示例 + 详细解释 + 修改建议」。
模块 0｜最小配置（新手入门必备，改坏了就用这个恢复）
这是 OpenClaw 能正常运行的最小配置，包含最核心的网关设置，新手修改配置前，建议先备份这个版本：
{"gateway":{"mode":"local","port":18789},"plugins":{"entries":{}}}说明：
• mode: "local"本地运行模式，个人使用必设，不可省略• port: 18789默认端口，不用改除非与其他程序冲突• entries: {}插件列表，初始为空，后续添加插件再修改
⚠️ 修改建议： 这是 Day1 我们写入的基础配置，新手先别改这里的内容，等熟悉后再调整。
模块 1｜gateway（网关核心配置）—— 控制 OpenClaw 怎么"跑"
这是最基础、最重要的模块，决定了网关的运行方式，新手必看：
"gateway":{"mode":"local","port":18789,"bind":"127.0.0.1","logLevel":"info","autoRestart":true,"controlUi":{"enabled":true}}关键字段详解：
mode | local | local |
port | 18789 | |
bind | 127.0.0.1 | |
logLevel | info | |
autoRestart | true | |
controlUi.enabled | true |
✅ 实战修改： 如果想让 OpenClaw 在后台更稳定运行，把
autoRestart设为true，然后重启网关。
模块 2｜models（AI 模型配置）—— 给 OpenClaw 换"大脑"
这个模块负责管理 OpenClaw 用的 AI 模型，比如 DeepSeek、豆包、Qwen 等，是新手最常修改的模块之一：
"models":{"providers":{"ollama":{"baseUrl":"http://localhost:11434"},"deepseek":{"apiKey":"你的 DeepSeek 密钥"}},"primary":"ollama/qwen:1.8b","fallback":"deepseek/deepseek-chat"}关键字段详解：
providers | |
baseUrl | |
apiKey | |
primary | |
fallback |
模块 3｜agents（智能体配置）—— 定义 AI 的"工作方式"
agents 模块控制 AI 的行为习惯，比如工作目录、思考深度、工具使用权限等：
"agents":{"defaults":{"workspace":"~/.openclaw/workspace","model":{"primary":"ollama/qwen:1.8b","maxTokens":4096},"tools":{"enabled":true,"allowed":["terminal","browser","files"]},"memory":{"maxMessages":100}}}关键字段详解：
workspace | |
maxTokens | |
tools.enabled | |
memory.maxMessages |
⚠️ 新手避坑： 开启
terminal工具时要注意安全，建议先在测试环境试用。
模块 4｜plugins（插件配置）—— 给 OpenClaw 加"新技能"
plugins 模块管理 OpenClaw 的插件，比如飞书、微信、美图 AI 等：
"plugins":{"entries":{"@larksuite/openclaw-lark":{"enabled":true,"config":{"appId":"你的飞书 AppID","appSecret":"你的飞书 AppSecret","eventToken":"你的飞书事件令牌"}}}}模块 5｜channels（消息渠道配置）—— 让 OpenClaw"听你指挥"
channels 模块管理 OpenClaw 的消息入口，比如飞书、微信、Telegram 等：
"channels":{"lark":{"enabled":true,"allowFrom":["你的飞书用户 ID"],"bindToAgent":"main"}}⚠️ 避坑提示：
allowFrom字段一定要填自己的飞书用户 ID，否则任何人都能通过飞书访问你的 OpenClaw，存在安全风险！
模块 6｜auth（认证配置）—— 给 OpenClaw 加"安全锁"
auth 模块管理 OpenClaw 的访问权限，防止未授权访问：
"auth":{"mode":"token","token":"your-secure-token-here","allowLocal":true}模块 7｜meta（元数据）—— 配置文件的"身份证"
这个模块记录配置文件的版本和修改时间，新手不用手动改，OpenClaw 会自动维护：
"meta":{"lastTouchedVersion":"2026.3.28","lastTouchedAt":"2026-04-01T10:00:00Z"}模块 8｜常见错误处理模块（新手急救包）
专门解决新手最常遇到的问题，比如飞书事件断档错误：
"channels":{"lark":{"config":{"event":{"seqCheck":true,"maxGap":10,"autoRefresh":true}}}}✅ 实战效果： 添加这个配置后，飞书事件断档时会自动刷新连接，大幅减少
event gap detected错误的出现。
双牛老 K 的终极大招
在给 OpenClaw 配置完大模型后，我们就可以用自然语言给 OpenClaw 聊天说话。
其实这里你对接的哪个大模型，就是用哪个大模型和他对话，很多事情就直接给他说，让他来操作。
就拿不会用命令备份配置文件来说，你就直接说"把你的配置文件备份一下，并且标注一下日期放到桌面"，他就执行了，你的桌面就有了一个他备份的配置文件。
⚠️ 重要提醒： 在修改配置文件的时候一定要备份一下（防止改坏，必做！）
好啦，今天网关和配置文件教程就到这里！是不是比你想的更简单？配置文件其实就是个设置清单，照着改就行，最好做个备份，改坏了还能恢复，完全不用担心！如果你在修改配置时遇到了任何问题，直接在评论区留言，我会一一回复！别忘了点赞 + 在看 + 关注，后续 12 天的打卡教程不会迷路，我们明天 Day3 不见不散！
