（可能全网最全/长的）2万字Openclaw保姆教程

（可能全网最全/长的）2万字Openclaw保姆教程 （可能全网最全/长的）2万字Openclaw保姆教程 Modified May 8 Code block Plain Text Copy 3. 设置调用频率限制 Code block Plain Text Copy { "rateLimit": { "perMinute": 30, "perHour": 500 } } 本部分小结 模型配置的核心要点： 1. 长文档先试KIMI —— 长上下文任务更顺手 2. 响应速度优先试MiniMax —— 对话往返更轻快 3. 通用任务优先试GLM —— 作为均衡选项 4. 配置fallbacks —— 避免单点故障 5. 设置预算上限 —— 防止意外账单 动手试试 1. 如果你还没申请Coding Plan，选择一家申请 2. 配置好你的主模型 3. 设置一个月度预算上限 4. 测试不同模型的响应速度和质量 5. （可选）配置一个fallback模型 第七部分：装备技能（让它学会自动生成日报） 🎯 本章目标 ：学完这章，你能搜索、安装、使用现成的Skills ⏱️ 预计时间 ：15分钟 📋 前置要求 ：已完成第10章（了解Tools） 本章你将学会什么 • ClawHub是什么 • 搜索和安装Skills • 验证Skills可用性 • 从安装到调用的完整流程 • 更新与回退处理 11.1 ClawHub是什么 11.1.1 类比理解 • ClawHub = Skill的应用商店 • Skill = App • 安装Skill = 下载App • 使用Skill = 打开App使用功能 11.1.2 ClawHub的特点 • 公共注册中心 ：Skills 公开可见，便于复用 • 支持版本化 ：每次发布都有版本记录 • CLI 友好 ：可直接搜索、安装、更新、发布 • 可审核治理 ：支持举报与管理流程 11.1.3 ClawHub地址 网站：https://clawhub.com 11.2 搜索与安装 11.2.1 命令行搜索 Code block Plain Text Copy 搜索关键词（推荐带引号） openclaw skills list eligible "daily report" openclaw skills list eligible "github review" openclaw skills list eligible "meeting notes" 输出示例 ： Code block Plain Text Copy NAME DESCRIPTION VERSION daily report 自动生成日报 1.2.0 daily summary 总结一天的工作内容 1.0.5 github pr helper GitHub PR审查助手 2.1.0 11.2.2 安装Skill Code block Plain Text Copy 安装指定 Skill 不需要手动 install，Agent 会在需要时自动检索并拉取 daily report 如果你要安装特定版本： Code block Plain Text Copy 不需要手动 install，Agent 会在需要时自动检索并拉取 daily report version 1.2.0 安装过程： 1. 从ClawHub下载Skill包 2. 解压到工作区 skills 目录 3. 记录到 .clawhub/lock.json 4. 在下一次会话中由 OpenClaw 加载 11.2.3 查看已安装清单（ClawHub侧） Code block Plain Text Copy clawhub list 11.3 验证可用性 11.3.1 查看已安装Skills Code block Plain Text Copy 列出所有已安装Skills openclaw skills list 输出示例： NAME VERSION STATUS daily report 1.2.0 installed github pr helper 2.1.0 installed 11.3.2 检查Skills是否可用 Code block Plain Text Copy 检查所有Skills的可用性 openclaw skills list eligible 输出示例： NAME STATUS REASON daily report ✓ eligible All requirements met github pr helper ✗ missing Missing tool: github api eligible 表示： • Skill已正确安装 • 所有依赖的Tools都已启用 • 可以正常使用 11.3.3 查看Skill详情 Code block Plain Text Copy openclaw skills info daily report 输出示例 ： Code block Plain Text Copy Name: daily report Version: 1.2.0 Path: /.openclaw/workspace/skills/daily report Requirements: read file ✓ write file ✓ fetch url ✓ Inputs: date: 日期（可选，默认今天） sources: 数据源（如：email,calendar） 提醒：实际路径以你的 workspace 为准，通常是 <workspace /skills/<name /SKILL.md ，默认 workspace 常见为 /.openclaw/workspace 。 11.4 第一个Skill：从安装到调用 11.4.1 安装示例Skill 我们以 daily report 为例： Code block Plain Text Copy 安装 不需要手动 install，Agent 会在需要时自动检索并拉取 daily report 验证安装 openclaw skills list eligible 11.4.2 调用Skill 方式一：在对话中直接调用 Code block Plain Text Copy 用户：运行daily report生成今天的日报 Agent：调用daily report Skill，生成日报 方式二：使用命令 Code block Plain Text Copy openclaw agent message "调用 daily report 生成今天的日报" 方式三：带参数调用 Code block Plain Text Copy openclaw agent message "调用 daily report，日期=2026 02 18，数据源=email,calendar" 11.4.3 查看执行结果 Skill执行后，会： 1. 1. 显示执行日志 2. 2. 返回执行结果 3. 3. （可选）生成输出文件 Code block Plain Text Copy ✓ daily report executed successfully Output: /home/user/reports/daily 2026 02 18.md Time: 3.2s 11.5 更新与回退处理 11.5.1 更新Skills 3. 设置调用频率限制 本部分小结 模型配置的核心要点： 1. 长文档先试KIMI —— 长上下文任务更顺手 2. 响应速度优先试MiniMax —— 对话往返更轻快 3. 通用任务优先试GLM —— 作为均衡选项 4. 配置fallbacks —— 避免单点故障 5. 设置预算上限 —— 防止意外账单 动手试试 1. 如果你还没申请Coding Plan，选择一家申请 2. 配置好你的主模型 3. 设置一个月度预算上限 4. 测试不同模型的响应速度和质量 5. （可选）配置一个fallback模型 第七部分：装备技能（让它学会自动生成日报） 🎯 本章目标 ：学完这章，你能搜索、安装、使用现成的Skills ⏱️ 预计时间 ：15分钟 📋 前置要求 ：已完成第10章（了解Tools） 本章你将学会什么 • ClawHub是什么 • 搜索和安装Skills • 验证Skills可用性 • 从安装到调用的完整流程 • 更新与回退处理 11.1 ClawHub是什么 11.1.1 类比理解 • ClawHub = Skill的应用商店 • Skill = App • 安装Skill = 下载App • 使用Skill = 打开App使用功能 11.1.2 ClawHub的特点 • 公共注册中心 ：Skills 公开可见，便于复用 • 支持版本化 ：每次发布都有版本记录 • CLI 友好 ：可直接搜索、安装、更新、发布 • 可审核治理 ：支持举报与管理流程 11.1.3 ClawHub地址 网站：https://clawhub.com 11.2 搜索与安装 11.2.1 命令行搜索 输出示例 ： 11.2.2 安装Skill 如果你要安装特定版本： 安装过程： 1. 从ClawHub下载Skill包 2. 解压到工作区 skills 目录 3. 记录到 .clawhub/lock.json 4. 在下一次会话中由 OpenClaw 加载 11.2.3 查看已安装清单（ClawHub侧） 11.3 验证可用性 11.3.1 查看已安装Skills 11.3.2 检查Skills是否可用 eligible 表示： • Skill已正确安装 • 所有依赖的Tools都已启用 • 可以正常使用 11.3.3 查看Skill详情 输出示例 ： 提醒：实际路径以你的 workspace 为准，通常是 <workspace /skills/<name /SKILL.md ，默认 workspace 常见为 /.openclaw/workspace 。 11.4 第一个Skill：从安装到调用 11.4.1 安装示例Skill 我们以 daily report 为例： 11.4.2 调用Skill 方式一：在对话中直接调用 方式二：使用命令 方式三：带参数调用 11.4.3 查看执行结果 Skill执行后，会： 1. 1. 显示执行日志 2. 2. 返回执行结果 3. 3. （可选）生成输出文件 11.5 更新与回退处理 11.5.1 更新Skills 11.5.2 回退或覆盖安装 如果你要“停用”某个 Skill，建议在 OpenClaw 配置里将对应条目 enabled: false ，而不是直接删除文件夹。 11.6 推荐Skills清单 11.6.1 生产力类 Skill 功能 适用场景 daily report 自动生成日报 每天写日报的打工人 meeting notes 会议纪要整理 会议记录员 email digest 邮件摘要 邮件太多的用户 Skill Skill 功能 功能 适用场景 适用场景 daily report daily report 自动生成日报 自动生成日报 每天写日报的打工人 每天写日报的打工人 meeting notes meeting notes 会议纪要整理 会议纪要整理 会议记录员 会议记录员 email digest email digest 邮件摘要 邮件摘要 邮件太多的用户 邮件太多的用户 11.6.2 开发类 Skill 功能 适用场景 github pr helper PR审查 开发者 code review 代码审查 代码审查员 release notes 生成发布说明 产品经理 Skill Skill 功能 功能 适用场景 适用场景 github pr helper github pr helper PR审查 PR审查 开发者 开发者 code review code review 代码审查 代码审查 代码审查员 代码审查员 release notes release notes 生成发布说明 生成发布说明 产品经理 产品经理 11.6.3 内容类 Skill 功能 适用场景 article summarizer 文章摘要 内容创作者 translation helper 翻译助手 需要翻译的用户 markdown formatter Markdown格式化 写文档的用户 Skill Skill 功能 功能 适用场景 适用场景 article summarizer article summarizer 文章摘要 文章摘要 内容创作者 内容创作者 translation helper translation helper 翻译助手 翻译助手 需要翻译的用户 需要翻译的用户 markdown formatter markdown formatter Markdown格式化 Markdown格式化 写文档的用户 写文档的用户 本部分小结 使用Skills的核心要点： 1. ClawHub是应用商店 搜索、安装、更新Skills 2. 先检查eligible 确保Skill可以正常使用 3. 多种调用方式 对话、命令、带参数 4. 更新要可回退 尽量固定版本或保留变更记录 动手试试 1. 搜索感兴趣的Skills 2. 安装一个Skill（推荐daily report） 3. 检查它是否eligible 4. 尝试调用它 5. 运行一次 clawhub list 记录当前安装状态 🎉 结语：你的 AI 助理已经准备就绪 恭喜你！读到这里，你已经成功跨越了 OpenClaw 的新手村。 你现在不仅拥有了一个能在终端里跑的智能体，还把它成功接到了飞书里，并且学会了如何给它上“安全锁”、如何挑选最划算的国产大模型，甚至掌握了给它配置“技能”的方法。 从今天起，它不再是冷冰冰的代码，而是你专属的、7x24小时随时待命的 AI 实习生！ 接下来的路，就看你如何发挥想象力，用它来解放你的双手了。如果未来你需要把它部署到服务器上，或者想自己动手写一个独一无二的 Skill，再去翻阅完整的官方文档也不迟。 祝你和你的 OpenClaw 合作愉快！🚀 🔗 原文链接： https://mp.weixin.qq.com/s/0Xq9XOfT... https://mp.weixin.qq.com/s/0Xq9XOfT... 原创 DracoVibeCoding DracoVibeCoding Draco正在VibeCoding2026年2月20日 21:31 河南 🧑‍💻 小伙伴们也可以通过阿里云百炼Coding Plan 来部署： 首购低至 7.9 元，续费 5 折起，支持Qwen3.5、Qwen3 max、Qwen3 coder、GLM 5、GLM 4.7、Kimi k2.5等模型 👉戳链接直达：https://t.aliyun.com/U/0iiOuy 👉查看详细部署教程：https://t.aliyun.com/U/MNkA9b 最多三步，即可拥有 7x 24小时在线、随时响应的AI助手 小伙伴们也可以通过阿里云百炼Coding Plan 来部署： 首购低至 7.9 元，续费 5 折起，支持Qwen3.5、Qwen3 max、Qwen3 coder、GLM 5、GLM 4.7、Kimi k2.5等模型 👉戳链接直达：https://t.aliyun.com/U/0iiOuy 👉查看详细部署教程：https://t.aliyun.com/U/MNkA9b 最多三步，即可拥有 7x 24小时在线、随时响应的AI助手 OpenClaw V3 新手起飞指南 🚀 ✨ 写在前面 ： 这是一份专门为你 精简提炼 的“保姆级”新手指南。 我们剔除了早期不需要懂的底层配置和部署逻辑，为你找到了一条 最平缓的入门曲线 (Sweet Spot) ： 从零基础 拿到 API 成功安装 接入飞书 安全防泄漏 学会用技能 准备好了吗？系好安全带，我们要发车了！ 第一部分：揭开面纱（OpenClaw 到底是什么） 🎯 本章目标 ：学完这章，你能向朋友清楚解释OpenClaw是什么、能做什么、不能做什么 ⏱️ 预计时间 ：3分钟 本章你将学会什么 • 用一句话向朋友解释OpenClaw是什么 • 三个真实场景，理解它能帮你做什么 • 澄清常见误解，知道它不能做什么 • 为什么2026年它突然火了 • 根据你的需求，选择最适合的阅读路径 1.1 一句话解释：你的AI助理，住在你的电脑里 想象一下：你招了一个实习生，这个实习生特别聪明，能帮你查资料、写文档、整理数据，还能24小时在线。但你不需要给它交社保，也不用担心它跳槽。 OpenClaw就是这个实习生，只不过它住在你的电脑里。 更准确地说： OpenClaw是一个 AI智能体平台 （Agent Platform），让你能在自己的电脑上运行AI助理，并把它接入到你日常使用的工具里——比如飞书、Telegram。 几个核心概念，先混个脸熟（后面章节会详细讲）： • Agent（智能体） ：能自主执行任务的AI程序，就像一个 带工具箱的实习生 。你告诉它"帮我整理今天的会议纪要"，它会自己决定用什么工具、分几步完成。 • Gateway（网关） ：系统的 总调度室 ，负责消息路由和协调。默认地址是 127.0.0.1:18789 ，就是你电脑上开的一个端口。 • Channel（渠道） ：连接各种聊天平台的接口，比如飞书、Telegram。 • Tool（工具） ：Agent能调用的具体功能，比如读写文件、执行命令、搜索网页。 • Skill（技能） ：告诉Agent 什么时候用什么工具 的"说明书"。 别慌，这些词现在看着陌生，用几遍就熟了。 1.2 它能做什么：三个真实场景 光说概念太虚，来看三个真实的使用场景。 1.2.1 场景一：自动整理日报（拯救打工人） 小王每天下班前要发日报，总结今天做了什么。以前他要翻聊天记录、看邮件、回忆一天的工作，至少花20分钟。 现在他@飞书里的OpenClaw机器人： "帮我整理今天的日报，从项目群提取关键进展，从邮件提取待跟进事项。" 机器人自动： 1. 读取指定群聊的今日消息 2. 提取关键信息 3. 按格式生成日报 4. 发到指定文档 省下的20分钟，小王可以准时下班了。 1.2.2 场景二：查资料写报告（研究员的福音） 小李需要写一篇行业分析报告，涉及大量资料搜集。以前他要在十几个网站间来回切换，复制粘贴到手软。 现在他告诉OpenClaw： "搜索2025年AI编程助手的市场规模，整理成表格，包含数据来源。" Agent自动： 1. 调用搜索工具查找资料 2. 访问多个网页提取信息 3. 整理成结构化表格 4. 标注数据来源 小李从"体力活"中解放出来，专注在分析和判断上。 1.2.3 场景三：飞书里@它办事（团队协作神器） 团队群里经常有人问： • "谁能查一下上个月的销售数据？" • "帮忙翻译一下这个英文文档" • "把这份PDF转成Markdown" 现在直接在群里@机器人： "@小助手 把刚才发的PDF转成Markdown格式" 机器人立即处理，把结果发回群里。 不用麻烦同事，不用切换工具，在聊天中就把事办了。 1.3 它不是什么：澄清常见误解 OpenClaw很强大，但它不是万能的。以下几个误解，越早澄清越好。 1.3.1 误解一：它是ChatGPT替代品 不是。 ChatGPT是一个AI对话产品，你打开网页就能聊。OpenClaw是一个 平台 ，让你能搭建自己的AI助理。 你可以这样理解： • ChatGPT = 一个训练有素的客服 • OpenClaw = 一个可以训练自己客服的系统 实际上，OpenClaw可以接入ChatGPT的API，也可以接入Claude、KIMI、MiniMax等其他模型。它是 模型的使用者 ，不是 模型的竞争者 。 1.3.2 误解二：它是云端服务，数据存在别人服务器上 不是。 这是OpenClaw最大的特点之一： 它运行在你的电脑上 。 • 你的聊天记录存在本地 • 你的文件处理在本地完成 • 你的API Key不会经过第三方服务器 对于担心数据隐私的企业和个人，这是巨大的优势。 ⚠️ 注意 ：虽然OpenClaw本身在本地运行，但它调用AI模型时需要联网。你的消息会发送到对应的AI服务商（如OpenAI、KIMI等）。 1.3.3 误解三：它会自己上网乱买东西、乱发邮件 不会。 OpenClaw的设计理念是 最小权限原则 。默认情况下，它什么都不能做。 • 想让它读写文件？你需要明确授权 • 想让它发邮件？你需要配置邮件工具 • 想让它执行命令？你需要开启沙箱并设置权限 而且，高风险操作可以设置 二次确认 ，确保它不会"自作主张"。 1.4 为什么2026年它突然火了 AI Agent的概念不是2026年才有的，为什么现在才火？ 1.4.1 原因一：大模型能力到了"可用"的临界点 2024年的GPT 4和Claude 3已经很强，但还不够稳定。2025 2026年的模型（Claude Opus 4.6/Sonnet 4.6、GPT 5.3 Codex、KIMI K2.5等）在 理解复杂指令 和 稳定输出格式 上有了质的飞跃。 简单说：以前的AI助理经常"听不懂人话"，现在的能听懂了。 1.4.2 原因二：工程化工具成熟了 光有聪明的大脑不够，还需要： • 稳定的消息收发机制 • 可靠的工具调用框架 • 安全的权限管理系统 • 友好的配置界面 OpenClaw把这些工程难题都解决了，让普通用户也能搭起自己的AI助理。 1.4.3 原因三：从"玩具"到"工具"的转变 早期的AI Agent更多是极客的玩具，现在它们真的能 解决实际工作问题 。 • 整理日报节省20分钟 • 查资料写报告节省2小时 • 自动化数据处理节省半天 当省下的时间超过学习成本时，普及就水到渠成了。 1.5 阅读路线图：三种读者的最短路径 这本书有17章，但你不需要全部读完。根据你的需求，选择最适合的路径： 1.5.1 路径A：我只想快速用起来（推荐所有人先走这条） 目标 ：在飞书里@AI机器人，让它帮你办事 阅读顺序 ： 1. 第1章（本章）→ 了解是什么 2. 第2章 → 准备API Key 3. 第3章 → 安装OpenClaw 4. 第5章 → 接入飞书 5. 第6章 → 配置安全策略 预计时间 ：2 3小时 1.5.2 路径B：我想深度定制，让它做特定任务 目标 ：让AI助理完成我的专属任务（如数据分析、报告生成） 阅读顺序 ： 1. 先完成路径A（基础必须打牢） 2. 第10章 → 了解Tools能做什么 3. 第11章 → 使用现成Skills 4. 第12章 → 写第一个Skill 5. 第13章 → 进阶优化 预计时间 ：1 2天 1.5.3 路径C：我是技术用户，想部署到服务器 目标 ：在服务器上稳定运行，团队共享使用 阅读顺序 ： 1. 先完成路径A（了解基础） 2. 第7章 → 模型配置优化 3. 第8章 → 配置文件深入 4. 第9章 → 安全与沙箱 5. 第15章 → 多Workspace配置 6. 第16章 → 部署与运维 预计时间 ：2 3天 本部分小结 来，我们回顾一下： 1. OpenClaw是什么 ：一个AI智能体平台，让你的电脑上运行AI助理 2. 它能做什么 ：整理日报、查资料写报告、飞书里@它办事 3. 它不能做什么 ：不是ChatGPT替代品、不是纯云端服务、不会擅自行动 4. 为什么现在火了 ：大模型能力成熟 + 工程化工具完善 + 真正解决工作问题 5. 怎么开始 ：根据你的需求选择路径A、B或C 动手试试 1. 向一位朋友解释OpenClaw是什么，用本章的"带工具箱的实习生"类比 2. 思考：你日常工作中有哪些重复性任务，可能适合交给AI助理？ 3. 根据1.5节的路线图，确定你要走哪条路径 第二部分：开工准备（你只需要这三样东西） 🎯 本章目标 ：学完这章，你能确认自己具备开始的所有条件，并准备好API Key ⏱️ 预计时间 ：10分钟 本章你将学会什么 • 确认你的电脑满足运行条件 • 理解API Key是什么，以及怎么获取 • 国内三家Coding Plan的详细申请步骤（KIMI/MiniMax/GLM） • 备选方案（OpenRouter/Anthropic） • 提前预览最终效果 2.1 别慌，你只需要这三样东西 很多技术书一上来就列一堆要求，看得人想放弃。咱们换个方式： 你只需要三样东西： 1. 一台能上网的电脑（Windows/Mac/Linux都行） 2. 一个API Key（别被这个词吓到，就是一串密码） 3. 10分钟时间（和一点点耐心） 没了。不需要你是程序员，不需要你懂AI，不需要买服务器。 2.2 第一样东西：一台电脑 2.2.1 系统要求 系统 要求 备注 macOS 10.15+ Intel和Apple Silicon都支持 Windows 10/11 推荐用WSL2（后面会讲） Linux 主流发行版 Ubuntu/Debian/CentOS/Fedora都行 系统 系统 要求 要求 备注 备注 macOS macOS 10.15+ 10.15+ Intel和Apple Silicon都支持 Intel和Apple Silicon都支持 Windows Windows 10/11 10/11 推荐用WSL2（后面会讲） 推荐用WSL2（后面会讲） Linux Linux 主流发行版 主流发行版 Ubuntu/Debian/CentOS/Fedora都行 Ubuntu/Debian/CentOS/Fedora都行 简单说：只要是近5年的电脑，基本都能跑。 2.2.2 网络要求 你需要能访问： • npm registry（安装OpenClaw） • 你选择的AI服务商（如KIMI、MiniMax等） 国内用户注意：OpenClaw本身不需要翻墙，但部分AI服务商可能需要。 2.3 第二样东西：一个API Key 2.3.1 API Key是什么？ API Key（应用编程接口密钥） ，听起来很高大上，其实就是 一串密码 。 类比一下： • 饭店的VIP卡 → 证明你有资格享受服务 • 小区的门禁卡 → 证明你有权限进入 • API Key → 证明你有权限调用AI服务 每次OpenClaw让AI帮你干活，都要出示这个Key。AI服务商根据Key来： 1. 确认你是谁 2. 计算你用了多少额度 3. 决定是否响应你的请求 2.3.2 国内三家Coding Plan（推荐） 对于国内用户，我推荐优先选择以下三家。它们都有专门针对开发者的 Coding Plan，且本章统一使用国内站口径（不使用国际站路径）。 2.3.2.1 方案A：KIMI Coding Plan（推荐） 5pMQBY 申请步骤 ： 1. 访问 https://www.kimi.com/code 2. 登录/注册KIMI账号 3. 点击"订阅Coding Plan" 4. 完成支付（支持支付宝/微信） 5. 进入控制台，点击"创建API Key" 6. 复制生成的Key（以 sk 开头） 💡 提示 ：Key创建后只显示一次，务必保存好。如果丢了，只能重新创建。 2.3.2.2 方案B：MiniMax Coding Plan（推荐） Cu5XmF 申请步骤 ： 1. 访问 https://platform.minimaxi.com/subscribe/coding plan 2. 注册/登录账号 3. 完成实名认证（需要身份证） 4. 订阅Coding Plan 5. 进入"API管理"页面 6. 创建API Key并复制 2.3.2.3 方案C：GLM Coding Plan（推荐） GLM Coding Plan 申请步骤 ： 1. 访问 https://bigmodel.cn/glm coding 2. 注册/登录智谱AI账号 3. 进入控制台 4. 点击"API Keys"菜单 5. 创建新的API Key 6. 复制保存 2.3.3 三家对比表 特性 KIMI MiniMax GLM 月费（2026 02 18核验） 49/99/199/699元 29/49/119元 49/149/469元 特性 特性 KIMI KIMI MiniMax MiniMax GLM GLM 月费（2026 02 18核验） 月费（2026 02 18核验） 49/99/199/699元 49/99/199/699元 29/49/119元 29/49/119元 49/149/469元 49/149/469元 💡 说明：以上价格均按御三家国内站结算页口径记录；后续如有活动变动，请以实时页面为准。 2.3.4 备选方案 如果上述三家都不适合你，还有以下选择： 2.3.4.1 OpenRouter 特点 ：一个API对接多家模型（Claude、GPT、Llama等） 网址 ：https://openrouter.ai 适合 ：想用一个Key调用多种模型的用户 注意 ：国内访问可能需要代理 2.3.4.2 Anthropic（Claude官方） 特点 ：Claude模型官方API，质量顶尖 网址 ：https://console.anthropic.com 适合 ：追求最高质量回复的用户 注意 ：国内访问需要代理，价格较高 2.4 第三样东西：10分钟时间 这10分钟你要做什么？ 时间 动作 2分钟 检查电脑系统版本 5分钟 申请API Key（如果还没申请） 3分钟 把Key保存在安全的地方 时间 时间 动作 动作 2分钟 2分钟 检查电脑系统版本 检查电脑系统版本 5分钟 5分钟 申请API Key（如果还没申请） 申请API Key（如果还没申请） 3分钟 3分钟 把Key保存在安全的地方 把Key保存在安全的地方 保存Key的建议 ： 1. 不要 直接保存在微信/QQ聊天记录里 2. 不要 截图保存在相册里 3. 推荐 保存在： ◦ 密码管理器（1Password、Bitwarden等） ◦ 本地文本文件（放在安全的位置） ◦ 备忘录（如果支持加密） ◦ 密码管理器（1Password、Bitwarden等） ◦ 本地文本文件（放在安全的位置） ◦ 备忘录（如果支持加密） ⚠️ 重要 ：API Key就像银行卡密码，泄露了别人就能花你的钱。妥善保管！ 2.5 提前看看你会得到什么 完成本书学习后，你将拥有： 一个能在飞书里@的AI机器人 ： • 私聊问它问题 • 群里@它办事 • 让它帮你整理文档、查资料 一个可定制的AI助理 ： • 根据你的需求写Skills • 连接你的常用工具 • 自动化重复工作 完全掌控的数据隐私 ： • 所有数据存在本地 • 不经过第三方服务器 • 企业级安全保障 本部分小结 来，检查一下你的准备清单： • 一台能上网的电脑（Windows/Mac/Linux） • 一个API Key（KIMI/MiniMax/GLM任选其一） • 10分钟时间 如果都准备好了 动手试试 1. 确认你的电脑系统版本符合要求 2. 选择一家Coding Plan，完成API Key申请 3. 把Key保存在安全的地方（推荐密码管理器） 4. 测试网络：访问你选择的AI服务商控制台，确认能正常打开 第三部分：极速安装（5分钟把神兽接回家） 🎯 本章目标 ：学完这章，你能完成OpenClaw安装并发出第一条消息 ⏱️ 预计时间 ：5分钟 📋 前置要求 ：已完成第2章（准备工作） 本章你将学会什么 • 检查并安装Node.js环境 • 用一行命令安装OpenClaw • 运行向导完成初始化配置 • 理解QuickStart和Manual的区别 • 配置国内三家Coding Plan • 验证安装成功并发出第一条消息 3.1 环境检查：Node.js是什么？ 3.1.1 Node.js简介 Node.js 是一个让JavaScript能在电脑本地运行的环境。简单说： Node.js就像JavaScript的"翻译官"，让它能在浏览器之外的地方工作。 你不需要深入理解它，只需要确认电脑上已经安装了。 3.1.2 检查Node.js版本 打开你的终端（Terminal），输入： 期望看到的结果 ： 判断标准 ： • ✅ 版本 = v22：可以继续 • ❌ 版本 < v22：需要升级 • ❌ 提示"command not found"：需要安装 3.1.3 如果Node.js不符合要求 macOS安装/升级 Windows安装/升级 推荐方式：使用winget 或者手动下载 ： 1. 访问 https://nodejs.org 2. 下载LTS版本（长期支持版） 3. 按向导安装 💡 Windows用户注意 ：官方推荐在WSL2中运行OpenClaw，能避免很多奇怪问题。WSL2安装指南：https://docs.microsoft.com/zh cn/windows/wsl/install Linux安装/升级 Ubuntu/Debian ： CentOS/RHEL/Fedora ： 3.1.4 验证安装 安装完成后，再次检查： 两个命令都应该返回版本号。 ⚠️ 常见问题 ：如果安装后还是提示"command not found"，尝试 重启终端 或 重新登录系统 。 3.2 安装命令：就一行，复制粘贴 确认Node.js = v22后，执行安装命令： 这行命令在做什么？ • npm ：Node.js的包管理器 • install ：安装 • g ：全局安装（在任何目录都能用 openclaw 命令） • openclaw@latest ：安装 npm 上当前发布版（本书核验冻结点为 v2026.2.17 ） 等待时间 ：取决于你的网络，通常30秒到2分钟。 3.2.1 验证安装成功 期望看到类似输出：z ❌ 如果提示"command not found" 可能原因：npm全局路径未加入系统PATH 解决方法： 1. 重启终端 2. 如果还不行，检查npm全局路径： npm prefix g 3. 把返回的路径加入PATH环境变量 3.3 运行向导：openclaw onboard 安装完成后，运行初始化向导： 参数说明 ： • onboard ：运行初始化向导 • install daemon ：同时安装后台服务（推荐） 3.3.1 向导第一步：风险确认 + 已有配置处理 启动向导后，通常会先看到： 这里选 Yes 继续。 如果你之前装过 OpenClaw，还会看到： 怎么选： • 首次安装：通常不会出现这一段，直接进入下一步。 • 复装/换模型：选 Update values （推荐，保留其余稳定配置）。 • 完全重来：选 Reset （谨慎）。 3.3.2 向导第二步：选择模式（Onboarding mode） 向导会问你： 怎么选？ 选项 适合谁 结果 QuickStart 新手，想快速跑起来 自动配置推荐设置 Manual 想完全掌控配置 逐个配置每个选项 选项 选项 适合谁 适合谁 结果 结果 QuickStart QuickStart 新手，想快速跑起来 新手，想快速跑起来 自动配置推荐设置 自动配置推荐设置 Manual Manual 想完全掌控配置 想完全掌控配置 逐个配置每个选项 逐个配置每个选项 我的建议 ：第一次选 QuickStart ，后面可以随时改配置。 3.3.3 向导第三步：先选模型厂商（Provider） 向导会提示你选择模型提供商： 先选你在第2章申请的厂商 （KIMI / MiniMax / GLM）。 3.3.4 向导第四步：再选鉴权方式（Auth method，容易漏） 在你选完厂商后，通常不会立刻要 Key