小白入门|OpenClaw 14 天打卡 Day2 认识网关及配置文件,手把手教学

小白入门｜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&#x27;{"gateway":{"mode":"local"},"plugins":{"entries":{}}}&#x27; > ~/.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	`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`	AI 模型提供商列表
`baseUrl`	本地模型（如 Ollama）的默认地址
`apiKey`	在线模型的密钥
`primary`	主模型，日常使用的默认 AI 模型
`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`	AI 的工作目录
`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 不见不散！