OpenClaw 入门教程（1）：CLI 与 UI 配置详解
OpenClaw 入门教程（1）：CLI 与 UI 配置详解 OpenClaw 核心概念详解（一）：CLI 与 UI 配置 创建日期：2026-04-21作者：小龙 🐉版本：v1.0适用版本：OpenClaw 2026.4.14+
📖 概述 OpenClaw 4.14 版本提供了两种配置方式：CLI（命令行） 和 UI（图形界面），相比 3.13 版本的手动编辑 JSON 文件，更加安全、便捷。
️ 1. CLI（命令行界面） 什么是 CLI？ CLI = Command Line Interface，通过终端命令进行配置。
基本命令 1.1 查看配置
查看特定配置项
openclaw config get channels.qqbot
查看所有配置
openclaw config get --all
输出示例： { "channels": { "qqbot": { "enabled": true, "target": "qqbot:c2c:2374A81FBC14BD45333517A5FED72829" }, "feishu": { "enabled": true, "groupPolicy": "allowlist" } } }
1.2 修改配置
启用 QQ 通道
openclaw config set channels.qqbot.enabled true --json
禁用飞书通道
openclaw config set channels.feishu.enabled false --json
设置飞书群策略
openclaw config set channels.feishu.groupPolicy "allowlist" --json
优势： ✅ 自动验证 JSON 格式（不会写错） ✅ 有错误提示 ✅ 无需手动编辑文件
1.3 验证配置
检查配置是否正确
openclaw doctor
查看配置警告
openclaw status
输出示例： Config warnings:
- plugins.entries.feishu: plugin not found: feishu (stale config entry ignored)
实际应用案例 案例 1：修复飞书插件
禁用旧版飞书插件
openclaw config set plugins.entries.feishu.enabled false --json
重启 Gateway
openclaw gateway restart
案例 2：批量禁用通道
禁用企业微信
openclaw config set channels.wecom.enabled false --json
禁用钉钉
openclaw config set channels.dingtalk.enabled false --json
️ 2. UI（图形用户界面） 什么是 UI？ UI = User Interface，通过浏览器网页进行配置。
操作步骤 2.1 打开控制界面
方式 1：命令行打开
openclaw dashboard
方式 2：浏览器直接访问
http://<服务器 IP>:13878/<会话 ID>/
示例： http://172.19.36.194:13878/988b222f/
2.2 进入配置页面 浏览器界面： ┌─────────────────────────────────────┐ │ OpenClaw Dashboard │ ├─────────────────────────────────────┤ │ 📊 概览 🔧 配置 💬 会话 ⚙️ 设置 │ └─────────────────────────────────────┘ ↑ 点击这里
2.3 图形化编辑配置 通道配置界面： 通道配置 ───────────────────────────────────── □ QQ Bot [已启用] [编辑] └─ Target: qqbot:c2c:2374...
□ 飞书 [已启用] [编辑] └─ Group Policy: allowlist
□ 企业微信 [已禁用] [编辑]
□ 钉钉 [已禁用] [编辑] ───────────────────────────────────── [+ 添加通道] [保存配置] [验证配置]
2.4 编辑通道配置 点击"编辑"后弹出表单： 编辑 QQ Bot 配置 ───────────────────────────────────── 启用通道：☑ 已启用
Target: [qqbot:c2c:2374A81FBC14BD45333517A5FED72829]
群组策略：○ 允许所有人 ● 白名单模式 ○ 仅私聊
[保存] [取消] ─────────────────────────────────────
2.5 保存并验证 ✅ 配置已保存 ℹ️ 部分配置需要重启 Gateway 才能生效
[立即重启] [稍后重启]
📊 3. CLI vs UI 对比
维度
CLI（命令行）
UI（图形界面）
适用场景
快速修改、批量操作
初次配置、可视化浏览
操作速度
⚡ 快（一行命令）
🐢 慢（需要打开浏览器）
易用性
⭐⭐ 需要记命令
⭐⭐⭐⭐ 图形化友好
错误提示
✅ 有文字提示
✅ 有红色高亮
远程操作
✅ SSH 可用
❌ 需要浏览器
批量修改
✅ 脚本自动化
❌ 手动点击
🎯 4. 推荐使用方式 使用 CLI 的场景
1. 快速启用/禁用
openclaw config set channels.qqbot.enabled true --json
2. 批量配置（写脚本）
openclaw config set channels.feishu.enabled false --json openclaw config set channels.wecom.enabled false --json
3. 远程服务器操作（SSH）
openclaw config get channels.qqbot
使用 UI 的场景
- 第一次配置通道（不知道有哪些选项）
- 查看完整配置结构
- 可视化查看所有通道状态
- 不熟悉命令行的时候
💡 5. 实际操作演示 场景：禁用飞书通道 方式 1：CLI（推荐） openclaw config set channels.feishu.enabled false --json openclaw gateway restart
优点： ⚡ 快速（2 条命令） ✅ 格式自动验证 📝 可写入脚本
方式 2：UI 浏览器打开：http://172.19.36.194:13878 点击"配置"标签 找到"飞书"通道 点击"编辑" 取消勾选"启用通道" 点击"保存" 点击"重启 Gateway" 优点： 👁️ 可视化操作 📊 看到完整配置 ⚠️ 有错误提示
📝 6. 与 3.13 版本的对比 3.13 版本（手动编辑）
打开配置文件
vim ~/.openclaw/openclaw.json
手动修改（容易出错）
{ "channels": { "qqbot": { "enabled": true, "appId": "xxx" ← 手误写成 "appID" 就错了 } } }
重启 Gateway
openclaw gateway restart
问题： ❌ 容易手误改错格式 ❌ 不知道有哪些配置项 ❌ 每次修改都要重启 ❌ 没有错误提示
4.14 版本（CLI+UI）
CLI 方式
openclaw config set channels.qqbot.enabled true --json
UI 方式
浏览器 → 配置 → 编辑 → 保存
优势： ✅ 自动验证配置格式 ✅ 配置项有提示说明 ✅ 部分配置热更新（无需重启） ✅ 配置历史可回溯
🔧 7. 常用命令速查 配置管理
查看配置
openclaw config get <配置路径>
修改配置
openclaw config set <配置路径> <值> --json
验证配置
openclaw doctor
Gateway 管理
重启 Gateway
openclaw gateway restart
查看状态
openclaw gateway status
查看日志
openclaw logs --follow
通道管理
启用通道
openclaw config set channels.qqbot.enabled true --json
禁用通道
openclaw config set channels.qqbot.enabled false --json
查看通道状态
openclaw status
⚠️ 8. 注意事项 配置修改后
配置类型
是否需要重启
通道启用/禁用
✅ 需要
通道参数修改
✅ 需要
插件启用/禁用
✅ 需要
日志级别
❌ 不需要
会话配置
❌ 不需要
配置备份
手动备份配置文件
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
系统自动备份
~/.openclaw/openclaw.json.bak（每次修改自动创建）
配置恢复
从备份恢复
cp ~/.openclaw/openclaw.json.bak ~/.openclaw/openclaw.json
重启生效
openclaw gateway restart
📚 9. 相关文档 OpenClaw 版本对比报告 OpenClaw Dashboard 详解（下一篇） OpenClaw 定时任务系统（下一篇）
文档维护：小龙 🐉最后更新：2026-04-21下次更新：2026-05-21
© 2026 AiToMoney 团队
文档维护：小龙 🐉最后更新：2026-04-21下次更新：2026-05-21
© 2026 AiToMoney 团队 | 小龙 🐉 创建
📱 AiToMoney 虾主联盟 入群二维码 QQ 群（群号：242249487）飞书群（仅限企业内部成员加入）微信群（二维码 7 天内有效） image.png
入群暗号：「我是一只虾，正在水里瞎折腾。」 Slogan：一个人可以走得很快，一群虾可以折腾得更远 🦞