03-快速开始指南
03-快速开始指南
03 快速开始指南 03 快速开始指南 Modified June 10 ⠀ 第五步:重启并测试 ⠀ Code block Plain Text 重启 Gateway openclaw gateway port 18789 verbose openclaw channels status 确认 Slack 状态为 connected ⠀ 在 Slack 频道中 @提及 Bot: ⠀ Code block Plain Text @OpenClaw Assistant 帮我总结一下这周的项目进展 ⠀ 进阶:配置多频道路由 ⠀ ⏭️ 小白可跳过 — 默认配置已经够用了 ⠀ 不同频道可以路由到不同的 Agent,在 openclaw.json 的顶层 bindings 中配置(bindings 是顶层配置,不嵌套在 agent 内部): ⠀ Code block Plain Text { agents: { list: [ { id: "coding", workspace: " /.openclaw/workspace coding" }, ], }, bindings: [ { agent: "coding", channel: "slack", channelId: "C0123456789" }, ], } ⠀ 这样 dev 频道的消息会路由到专门的编程 Agent。 ⠀ 场景 3:客服机器人(接入 WhatsApp) ⠀ 适合小型企业,用 WhatsApp 做自动客服。 ⠀ 第一步:准备专用手机号 ⠀ WhatsApp 集成基于 Baileys(WhatsApp Web 协议),建议: • 使用专门的手机号,不要用个人主号 • 确保手机号已注册 WhatsApp • 手机保持开机联网 ⠀ 第二步:配置 WhatsApp ⠀ Code block Plain Text 添加 WhatsApp 平台 openclaw channels add whatsapp ⠀ 终端会显示一个二维码,用手机 WhatsApp 扫码配对。扫码后显示 Connected! 即配对成功。 ⠀ 第三步:定制客服人格 ⠀ 编辑 /.openclaw/workspace/SOUL.md: ⠀ Code block Plain Text 客服 AI 助手 你是 [公司名称] 的客服助手。 职责 回答客户关于产品和服务的问题 处理常见的售后问题 收集客户反馈 无法解决的问题转接人工客服 产品信息 [在这里填写你的产品/服务信息] [价格、规格、使用方法等] 规则 始终保持礼貌和专业 不要编造产品信息,不确定就说"我帮您确认一下" 涉及退款、投诉等敏感问题,提示客户联系人工客服 回复控制在 3 5 句话以内,简洁明了 工作时间:9:00 18:00,非工作时间自动回复 ⠀ 第四步:配置配对审批 ⠀ 客服场景下,你可能希望自动接受所有客户消息: ⠀ Code block Plain Text 注意:生产环境建议保持手动审批 openclaw config set channels.pairing.autoApprove true ⠀ 或者保持手动审批,定期检查: ⠀ Code block Plain Text 查看待配对的客户 openclaw pairing list 批量批准 openclaw pairing approve all ⠀ 第五步:重启并测试 ⠀ Code block Plain Text 重启 Gateway openclaw gateway port 18789 verbose 用另一个 WhatsApp 号码发送测试消息 "你好,我想了解一下你们的产品" ⠀ 进阶:设置自动回复模板 ⠀ ⏭️ 小白可跳过 — 默认配置已经够用了 ⠀ 在 /.openclaw/workspace/MEMORY.md 中预设常见问答: ⠀ Code block Plain Text 常见问答 营业时间 周一至周五 9:00 18:00,周末休息。 退换货政策 7 天无理由退换,15 天质量问题包换。 联系方式 人工客服电话:400 xxx xxxx 邮箱:support@example.com ⠀ AI 会自动参考这些信息回答客户问题。 调试和日志查看 ⠀ ⏭️ 小白可跳过 — 出问题时再来看 ⠀ 遇到问题时,日志是你最好的朋友。 ⠀ 查看 Gateway 日志(前台运行) ⠀ 最直观的调试方式是前台运行 Gateway 并开启 verbose 模式,所有日志直接输出到终端: ⠀ Code block Plain Text openclaw gateway port 18789 verbose ⠀ 前台运行时,你能看到每条消息的完整处理流程: ⠀ Code block Plain Text [2026 02 25 10:30:15] INFO Gateway started on 127.0.0.1:18789 [2026 02 25 10:30:20] INFO Telegram connected (bot: @my ai bot) [2026 02 25 10:31:05] INFO Message received from telegram:user123 [2026 02 25 10:31:05] INFO Agent loop started (agent: main, session: abc123) [2026 02 25 10:31:06] INFO Model request: openai/gpt 5.2 (tokens: 1250) [2026 02 25 10:31:08] INFO Model response: 350 tokens, 2.1s [2026 02 25 10:31:08] INFO Reply sent to telegram:user123 ⠀ 常见日志关键词 ⠀ 关键词 含义 排查方向 ERROR 错误 需要立即处理 WARN 警告 可能有问题,关注一下 AUTH FAILED 认证失败 检查 API Key 或 Token RATE LIMITED 被限流 API 调用太频繁,等一会儿 TIMEOUT 超时 网络问题或模型响应慢 DISCONNECTED 断开连接 平台连接中断,尝试重连 COMPACTION 会话压缩 对话太长,正在压缩上下文 ⠀ 健康检查 ⠀ 第五步:重启并测试 ⠀ ⠀ 在 Slack 频道中 @提及 Bot: ⠀ ⠀ 进阶:配置多频道路由 ⠀ ⏭️ 小白可跳过 — 默认配置已经够用了 ⏭️ 小白可跳过 — 默认配置已经够用了 ⠀ 不同频道可以路由到不同的 Agent,在 openclaw.json 的顶层 bindings 中配置(bindings 是顶层配置,不嵌套在 agent 内部): ⠀ ⠀ 这样 dev 频道的消息会路由到专门的编程 Agent。 ⠀ 场景 3:客服机器人(接入 WhatsApp) ⠀ 适合小型企业,用 WhatsApp 做自动客服。 ⠀ 第一步:准备专用手机号 ⠀ WhatsApp 集成基于 Baileys(WhatsApp Web 协议),建议: • 使用专门的手机号,不要用个人主号 • 确保手机号已注册 WhatsApp • 手机保持开机联网 ⠀ 第二步:配置 WhatsApp ⠀ ⠀ 终端会显示一个二维码,用手机 WhatsApp 扫码配对。扫码后显示 Connected! 即配对成功。 ⠀ 第三步:定制客服人格 ⠀ 编辑 /.openclaw/workspace/SOUL.md: ⠀ ⠀ 第四步:配置配对审批 ⠀ 客服场景下,你可能希望自动接受所有客户消息: ⠀ ⠀ 或者保持手动审批,定期检查: ⠀ ⠀ 第五步:重启并测试 ⠀ ⠀ 进阶:设置自动回复模板 ⠀ ⏭️ 小白可跳过 — 默认配置已经够用了 ⏭️ 小白可跳过 — 默认配置已经够用了 ⠀ 在 /.openclaw/workspace/MEMORY.md 中预设常见问答: ⠀ ⠀ AI 会自动参考这些信息回答客户问题。 调试和日志查看 ⠀ ⏭️ 小白可跳过 — 出问题时再来看 ⏭️ 小白可跳过 — 出问题时再来看 ⠀ 遇到问题时,日志是你最好的朋友。 ⠀ 查看 Gateway 日志(前台运行) ⠀ 最直观的调试方式是前台运行 Gateway 并开启 verbose 模式,所有日志直接输出到终端: ⠀ ⠀ 前台运行时,你能看到每条消息的完整处理流程: ⠀ ⠀ 常见日志关键词 ⠀ 关键词 含义 排查方向 ERROR 错误 需要立即处理 WARN 警告 可能有问题,关注一下 AUTH FAILED 认证失败 检查 API Key 或 Token RATE LIMITED 被限流 API 调用太频繁,等一会儿 TIMEOUT 超时 网络问题或模型响应慢 DISCONNECTED 断开连接 平台连接中断,尝试重连 COMPACTION 会话压缩 对话太长,正在压缩上下文 关键词 关键词 含义 含义 排查方向 排查方向 ERROR ERROR 错误 错误 需要立即处理 需要立即处理 WARN WARN 警告 警告 可能有问题,关注一下 可能有问题,关注一下 AUTH FAILED AUTH FAILED 认证失败 认证失败 检查 API Key 或 Token 检查 API Key 或 Token RATE LIMITED RATE LIMITED 被限流 被限流 API 调用太频繁,等一会儿 API 调用太频繁,等一会儿 TIMEOUT TIMEOUT 超时 超时 网络问题或模型响应慢 网络问题或模型响应慢 DISCONNECTED DISCONNECTED 断开连接 断开连接 平台连接中断,尝试重连 平台连接中断,尝试重连 COMPACTION COMPACTION 会话压缩 会话压缩 对话太长,正在压缩上下文 对话太长,正在压缩上下文 ⠀ 健康检查 ⠀ ⠀ 输出示例: ⠀ ⠀ 常见问题快速排查 ⠀ Gateway 启动失败 ⠀ ⠀ API 调用报错 ⠀ ⠀ openclaw doctor 会运行完整的诊断检查,包括 API 连接测试,方便定位问题。 ⠀ 消息平台断开 ⠀ 下一步学习建议 ⠀ 恭喜你,OpenClaw 已经跑起来了!根据你的需求,选择下一步方向: ⠀ 我想要... 去哪里 接入更多 AI 模型 1. AI 模型配置 — 多提供商、故障转移、预算控制 连接更多消息平台 1. 消息平台集成 — 30+ 平台、消息路由 解锁 AI 超能力 1. 技能系统 — 技能生态、自定义技能 AI 记住我的偏好 1. 记忆系统 — 长期记忆、每日日志 运行多个 AI 助手 1. 多 Agent 路由 — 多 Agent、消息路由 容器化部署 1. Docker 部署 — Docker Compose 一键部署 加固安全 1. 安全配置 — Token、TLS、沙箱隔离 遇到问题 1. 常见问题 FAQ — 别人踩过的坑 我想要... 我想要... 去哪里 去哪里 接入更多 AI 模型 接入更多 AI 模型 1. AI 模型配置 — 多提供商、故障转移、预算控制 1. AI 模型配置 — 多提供商、故障转移、预算控制 连接更多消息平台 连接更多消息平台 1. 消息平台集成 — 30+ 平台、消息路由 1. 消息平台集成 — 30+ 平台、消息路由 解锁 AI 超能力 解锁 AI 超能力 1. 技能系统 — 技能生态、自定义技能 1. 技能系统 — 技能生态、自定义技能 AI 记住我的偏好 AI 记住我的偏好 1. 记忆系统 — 长期记忆、每日日志 1. 记忆系统 — 长期记忆、每日日志 运行多个 AI 助手 运行多个 AI 助手 1. 多 Agent 路由 — 多 Agent、消息路由 1. 多 Agent 路由 — 多 Agent、消息路由 容器化部署 容器化部署 1. Docker 部署 — Docker Compose 一键部署 1. Docker 部署 — Docker Compose 一键部署 加固安全 加固安全 1. 安全配置 — Token、TLS、沙箱隔离 1. 安全配置 — Token、TLS、沙箱隔离 遇到问题 遇到问题 1. 常见问题 FAQ — 别人踩过的坑 1. 常见问题 FAQ — 别人踩过的坑 课程信息 ⠀ • 作者:老金 • GitHub:https://github.com/KimYx0207 • 公众号:老金带你玩AI • X(Twitter):老金带你玩AI • 个人博客:https://aiking.dev • 难度等级:🟢 入门 • 阅读时间:10 分钟 • 前置知识:已完成安装(02 安装部署指南) ⠀ 本篇你将学会: 运行引导向导、启动 Gateway、发送第一条消息、基本的日常操作命令 ⠀ 这是最重要的一篇! 跟着做完前 3 步,你就有一个能聊天的 AI 助手了 ⠀ 本篇你会做出什么 ⠀ 跟完这一篇,你会得到一个能在浏览器里对话的本地 OpenClaw 助手: ⠀ • Gateway 正常运行。 • Control UI 可以打开。 • 能发送第一条消息并收到回复。 • 知道怎么检查 Gateway 状态。 • 失败时知道先看哪几个排查点。 ⠀ 先完成下面的 3 步即可。后面的 Control UI 功能介绍可以等跑通后再看。 ⠀ 5 分钟跑起第一个对话 ⠀ 安装完 OpenClaw 后,只需要 3 步就能开始聊天。别急,我们一步步来,每步都讲清楚。 第一步:运行引导向导 ⠀ ⠀ 这条命令做了两件事: • onboard — 启动交互式引导向导 • install daemon — 把 Gateway 注册为系统服务(开机自启) ⠀ v2026.5.27 提示:如果你只输入 openclaw,且本机还没有 authored config,新版会进入 classic onboarding。教学里仍建议写完整命令,避免读者分不清“只启动 CLI”和“安装后台服务”的区别。快速开始后的排障优先看 Control UI Activity、transcript、Gateway 日志和 openclaw doctor,不要只凭聊天窗口是否回复来判断是否安装成功。 v2026.5.27 提示:如果你只输入 openclaw,且本机还没有 authored config,新版会进入 classic onboarding。教学里仍建议写完整命令,避免读者分不清“只启动 CLI”和“安装后台服务”的区别。快速开始后的排障优先看 Control UI Activity、transcript、Gateway 日志和 openclaw doctor,不要只凭聊天窗口是否回复来判断是否安装成功。 ⠀ 💡 术语解释: • Gateway(网关):OpenClaw 的核心后台服务,负责接收你的消息、调用 AI 模型、返回回复。你可以把它理解为"AI 助手的大脑",它在后台持续运行。 • daemon(守护进程):一种在后台默默运行的程序,不需要你手动启动,开机就自动跑起来。 💡 术语解释: • Gateway(网关):OpenClaw 的核心后台服务,负责接收你的消息、调用 AI 模型、返回回复。你可以把它理解为"AI 助手的大脑",它在后台持续运行。 • daemon(守护进程):一种在后台默默运行的程序,不需要你手动启动,开机就自动跑起来。 ⠀ 向导会依次引导你完成以下配置: ⠀ 1. 选择 AI 模型提供商 ⠀ ⠀ 新手建议选 DeepSeek(引导向导默认)或 OpenAI,生态最成熟。预算有限选 Ollama(免费本地模型)。 ⠀ 2. 输入 API Key ⠀ 💡 术语解释:API Key(API 密钥) 是 AI 模型提供商给你的一串"通行证"字符串。有了它,OpenClaw 才能代替你调用 AI 模型。每个提供商的 Key 格式不同,注意保密,不要分享给别人。 💡 术语解释:API Key(API 密钥) 是 AI 模型提供商给你的一串"通行证"字符串。有了它,OpenClaw 才能代替你调用 AI 模型。每个提供商的 Key 格式不同,注意保密,不要分享给别人。 ⠀ ⠀ API Key 会加密存储在 /.openclaw/openclaw.json 中。如果你还没有 Key: • DeepSeek: platform.deepseek.com platform.deepseek.com • OpenAI: platform.openai.com platform.openai.com • Anthropic: console.anthropic.com console.anthropic.com • Google: aistudio.google.com aistudio.google.com ⠀ 3. 配置 Gateway 设置 ⠀ ⠀ 直接回车用默认值就行。Gateway Token 会自动生成一个随机字符串,用于保护你的 API 接口。 ⠀ 💡 术语解释: • Gateway Token:相当于你家大门的钥匙,只有拿着这个 Token 的请求才能访问你的 Gateway,防止别人未经授权使用你的 AI 服务。 • TLS:一种网络加密协议,开启后你和 Gateway 之间的通信会被加密,防止被窃听。类似于浏览器地址栏的 🔒 小锁。 💡 术语解释: • Gateway Token:相当于你家大门的钥匙,只有拿着这个 Token 的请求才能访问你的 Gateway,防止别人未经授权使用你的 AI 服务。 • TLS:一种网络加密协议,开启后你和 Gateway 之间的通信会被加密,防止被窃听。类似于浏览器地址栏的 🔒 小锁。 ⠀ 4. 可选:连接消息平台 ⠀ ⠀ 第一次用建议先跳过,等熟悉了再接入。后面可以随时用 openclaw channels add 添加。 ⠀ 向导完成后,你会看到: ⠀ ⠀ ✅ 检查点: 如果你看到了 🦞 OpenClaw is ready! 的输出,说明一切正常。如果没有,去看 11 常见问题FAQ 的 Q1 Q5。 ✅ 检查点: 如果你看到了 🦞 OpenClaw is ready! 的输出,说明一切正常。如果没有,去看 11 常见问题FAQ 的 Q1 Q5。 ⠀ 第二步:检查 Gateway 状态 ⠀ ⠀ 正常输出: ⠀ ⠀ 看到 running 就说明网关已经启动了。如果显示 stopped,手动启动: ⠀ ⠀ ✅ 检查点: 运行 openclaw gateway status 后,看到 Gateway Status: running 就对了。如果是 stopped 或 error,参考下面的状态表格处理。 ✅ 检查点: 运行 openclaw gateway status 后,看到 Gateway Status: running 就对了。如果是 stopped 或 error,参考下面的状态表格处理。 ⠀ 常见状态说明: ⠀ 状态 含义 处理方式 running 正常运行 无需操作 stopped 已停止 openclaw gateway port 18789 error 启动失败 查看日志 openclaw gateway port 18789 verbose starting 正在启动 等待几秒后重新检查 状态 状态 含义 含义 处理方式 处理方式 running running 正常运行 正常运行 无需操作 无需操作 stopped stopped 已停止 已停止 openclaw gateway port 18789 openclaw gateway port 18789 error error 启动失败 启动失败 查看日志 openclaw gateway port 18789 verbose 查看日志 openclaw gateway port 18789 verbose starting starting 正在启动 正在启动 等待几秒后重新检查 等待几秒后重新检查 ⠀ 第三步:打开 Control UI ⠀ 💡 术语解释:Control UI 是 OpenClaw 自带的网页管理界面,在浏览器里打开就能用,不需要额外安装任何东西。你可以在这里和 AI 聊天、管理设置、查看状态。 💡 术语解释:Control UI 是 OpenClaw 自带的网页管理界面,在浏览器里打开就能用,不需要额外安装任何东西。你可以在这里和 AI 聊天、管理设置、查看状态。 ⠀ Gateway 启动后,在浏览器中打开 http://127.0.0.1:18789/,这就是你的 AI 助手 Control UI。 ⠀ 如果浏览器没有自动打开,手动在浏览器地址栏输入 http://127.0.0.1:18789/ 即可。 ⠀ 直接在输入框里打字,开始和 AI 对话。 ⠀ ✅ 检查点: 浏览器打开后能看到一个聊天界面,输入框可以打字,说明前 3 步全部完成!你已经有一个能聊天的 AI 助手了。🎉 ✅ 检查点: 浏览器打开后能看到一个聊天界面,输入框可以打字,说明前 3 步全部完成!你已经有一个能聊天的 AI 助手了。🎉 跑通后再看:Control UI 功能介绍 ⠀ 💡 术语解释: • Agent(智能体):你的 AI 助手实例。一个 Agent 就是一个独立的 AI 角色,有自己的人格设定、记忆和工作空间。你可以创建多个 Agent 来处理不同任务。 • 技能(Skill):Agent 的"超能力"插件。比如查天气、搜网页、操作文件等,每个技能让 AI 多会一样本事。 💡 术语解释: • Agent(智能体):你的 AI 助手实例。一个 Agent 就是一个独立的 AI 角色,有自己的人格设定、记忆和工作空间。你可以创建多个 Agent 来处理不同任务。 • 技能(Skill):Agent 的"超能力"插件。比如查天气、搜网页、操作文件等,每个技能让 AI 多会一样本事。 ⠀ 打开 http://127.0.0.1:18789/ 后,你会看到一个简洁的 Web 界面。下面逐一介绍每个功能区域。 ⠀ 聊天界面(主页面) ⠀ 这是你和 AI 对话的地方,占据了面板的主要区域。 ⠀ 功能特性: • 实时流式输出 — AI 的回复逐字显示,不用等全部生成完 • Markdown 渲染 — 代码块、表格、列表都会正确渲染 • 多轮对话 — 上下文自动保持,AI 记得你之前说了什么 • 文件上传 — 拖拽文件到输入框,AI 可以分析文件内容 • 语音输入 — 点击麦克风图标,语音转文字发送 ⠀ 快捷键: ⠀ 快捷键 功能 Enter 发送消息 Shift + Enter 换行(不发送) Ctrl + L 清空当前对话 Ctrl + K 打开命令面板 Ctrl + / 显示快捷键列表 快捷键 快捷键 功能 功能 Enter Enter 发送消息 发送消息 Shift + Enter Shift + Enter 换行(不发送) 换行(不发送) Ctrl + L Ctrl + L 清空当前对话 清空当前对话 Ctrl + K Ctrl + K 打开命令面板 打开命令面板 Ctrl + / Ctrl + / 显示快捷键列表 显示快捷键列表 ⠀ 设置面板 ⠀ 点击左下角的齿轮图标进入设置,包含以下配置项: ⠀ 模型设置 — 切换模型提供商、调整温度/Token 参数、配置故障转移 ⠀ 平台连接 — 查看已连接平台状态、添加/移除连接、配置消息路由 ⠀ 技能管理 — 查看已安装技能、启用/禁用、安装新技能 ⠀ 安全设置 — Gateway Token 管理、配对审批、沙箱隔离配置 ⠀ 💡 术语解释:沙箱(Sandbox) 是一种安全隔离机制,让 AI 在一个受限的环境中执行操作,防止它误操作你的系统文件。类似于给 AI 划了一个"安全活动区"。 💡 术语解释:沙箱(Sandbox) 是一种安全隔离机制,让 AI 在一个受限的环境中执行操作,防止它误操作你的系统文件。类似于给 AI 划了一个"安全活动区"。 ⠀ 会话管理 ⠀ 点击左侧边栏的会话列表图标,可以查看所有对话历史、全文搜索、导出为 Markdown/JSON、删除旧对话、给对话打标签分类。 ⠀ v2026.5.22 后,Control UI 的 chat session picker 更适合处理长历史:优先用搜索定位旧会话;结果很多时用 Load More 分页继续加载,不要靠浏览器滚动硬翻。排查“找不到会话”时,先确认当前 Agent、工作区和搜索关键词,再判断是否真丢失。 ⠀ 系统状态 ⠀ 点击左下角的状态指示灯,查看 Gateway 运行状态(CPU、内存、运行时间)、已连接平台状态、模型使用统计(API 调用次数、Token 消耗、费用估算)、Agent 列表。 第一个对话的完整流程 ⠀ 从配置到发送第一条消息,完整走一遍。 ⠀ 1. 确认 Gateway 正在运行 ⠀ ⠀ 2. 打开 Control UI ⠀ 在浏览器中打开 http://127.0.0.1:18789/。 ⠀ 3. 检查模型配置 ⠀ 在 Control UI 的设置中,确认: • AI 提供商已选择(比如 OpenAI) • API Key 已填写 • 模型已选择(比如 gpt 5.2) ⠀ 也可以用命令行检查: ⠀ ⠀ 4. 发送第一条消息 ⠀ 在 Control UI 的输入框中输入: ⠀ ⠀ AI 会流式回复,类似这样: ⠀ ⠀ ✅ 检查点: 如果 AI 回复了你的消息,恭喜!你的 OpenClaw 已经完全跑通了。如果没有回复或报错,检查 API Key 是否正确:运行 openclaw doctor 进行诊断。 ✅ 检查点: 如果 AI 回复了你的消息,恭喜!你的 OpenClaw 已经完全跑通了。如果没有回复或报错,检查 API Key 是否正确:运行 openclaw doctor 进行诊断。 ⠀ 5. 试试工具调用 ⠀ AI 不只是聊天,它还能执行操作。试试这些: ⠀ ⠀ 如果安装了 weather 技能,AI 会调用天气 API 返回实时天气。 ⠀ ⠀ AI 会使用文件工具在 /.openclaw/workspace/ 下创建文件。 ⠀ 6. 通过命令行发送消息 ⠀ 除了 Control UI,你也可以用命令行和 AI 对话: ⠀ ⠀ 在聊天界面中,你可以使用斜杠命令控制会话: ⠀ ⠀ 7. 发送测试消息到消息平台 ⠀ 如果你已经配置了消息平台(比如 WhatsApp),可以用命令行发送测试消息: ⠀ CLI 命令速查 ⠀ OpenClaw 的命令行工具功能强大,以下是常用命令的完整参考。 ⠀ 基础命令 ⠀ ⠀ Gateway 管理 ⠀ ⠀ 配置管理 ⠀ ⠀ Agent 命令 ⠀ ⠀ 聊天命令(会话内斜杠命令) ⠀ ⠀ 消息平台管理 ⠀ ⠀ Agent 管理 ⠀ ⠀ 技能管理 ⠀ ⠀ 记忆管理 ⠀ ⠀ 模型管理 ⠀ ⠀ 会话与系统维护 ⠀ 配置文件详解 ⠀ ⏭️ 小白可跳过 — 默认配置已经够用了 ⏭️ 小白可跳过 — 默认配置已经够用了 ⠀ OpenClaw 的所有配置都存储在一个 JSON5 文件中: /.openclaw/openclaw.json。 ⠀ 💡 术语解释:JSON5 是 JSON 的增强版,支持注释和尾逗号,写起来更方便。你可以把它当成普通的配置文件来编辑,用任何文本编辑器打开就行。 💡 术语解释:JSON5 是 JSON 的增强版,支持注释和尾逗号,写起来更方便。你可以把它当成普通的配置文件来编辑,用任何文本编辑器打开就行。 ⠀ 配置文件完整结构 ⠀ ⠀ 各配置块说明 ⠀ 配置块 用途 关键字段 gateway 网关服务设置 bind, port, auth.token channels 消息平台配置 各平台的连接信息(如 telegram.botToken) agents.defaults Agent 默认配置 model, compaction, sandbox agents.list Agent 列表 id, workspace plugins 插件配置 slots 中的各插件槽位 配置块 配置块 用途 用途 关键字段 关键字段 gateway gateway 网关服务设置 网关服务设置 bind, port, auth.token bind, port, auth.token channels channels 消息平台配置 消息平台配置 各平台的连接信息(如 telegram.botToken) 各平台的连接信息(如 telegram.botToken)