TimeAmber
剪藏#Agent平台#AI助理#DracoVibeCoding#OpenClaw#剪藏#新手教程#飞书集成

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

2026 年 2 月 22 日 约 1 分钟
分享Twitter / XTelegram微博

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. 1. 读取指定群聊的今日消息

  2. 2. 提取关键信息

  3. 3. 按格式生成日报

  4. 4. 发到指定文档

省下的20分钟，小王可以准时下班了。

1.2.2 场景二：查资料写报告（研究员的福音）

小李需要写一篇行业分析报告，涉及大量资料搜集。以前他要在十几个网站间来回切换，复制粘贴到手软。

现在他告诉OpenClaw：

"搜索2025年AI编程助手的市场规模，整理成表格，包含数据来源。"

Agent自动：

  1. 1. 调用搜索工具查找资料

  2. 2. 访问多个网页提取信息

  3. 3. 整理成结构化表格

  4. 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. 第1章（本章）→ 了解是什么

  2. 2. 第2章 → 准备API Key

  3. 3. 第3章 → 安装OpenClaw

  4. 4. 第5章 → 接入飞书

  5. 5. 第6章 → 配置安全策略

预计时间：2-3小时

1.5.2 路径B：我想深度定制，让它做特定任务

目标：让AI助理完成我的专属任务（如数据分析、报告生成）

阅读顺序：

  1. 1. 先完成路径A（基础必须打牢）

  2. 2. 第10章 → 了解Tools能做什么

  3. 3. 第11章 → 使用现成Skills

  4. 4. 第12章 → 写第一个Skill

  5. 5. 第13章 → 进阶优化

预计时间：1-2天

1.5.3 路径C：我是技术用户，想部署到服务器

目标：在服务器上稳定运行，团队共享使用

阅读顺序：

  1. 1. 先完成路径A（了解基础）

  2. 2. 第7章 → 模型配置优化

  3. 3. 第8章 → 配置文件深入

  4. 4. 第9章 → 安全与沙箱

  5. 5. 第15章 → 多Workspace配置

  6. 6. 第16章 → 部署与运维

预计时间：2-3天

本部分小结

来，我们回顾一下：

  1. 1. OpenClaw是什么：一个AI智能体平台，让你的电脑上运行AI助理

  2. 2. 它能做什么：整理日报、查资料写报告、飞书里@它办事

  3. 3. 它不能做什么：不是ChatGPT替代品、不是纯云端服务、不会擅自行动

  4. 4. 为什么现在火了：大模型能力成熟 + 工程化工具完善 + 真正解决工作问题

  5. 5. 怎么开始：根据你的需求选择路径A、B或C

动手试试

  1. 1. 向一位朋友解释OpenClaw是什么，用本章的"带工具箱的实习生"类比

  2. 2. 思考：你日常工作中有哪些重复性任务，可能适合交给AI助理？

  3. 3. 根据1.5节的路线图，确定你要走哪条路径

第二部分：开工准备（你只需要这三样东西）

🎯 本章目标：学完这章，你能确认自己具备开始的所有条件，并准备好API Key

⏱️ 预计时间：10分钟

本章你将学会什么

  • • 确认你的电脑满足运行条件

  • • 理解API Key是什么，以及怎么获取

  • • 国内三家Coding Plan的详细申请步骤（KIMI/MiniMax/GLM）

  • • 备选方案（OpenRouter/Anthropic）

  • • 提前预览最终效果

2.1 别慌，你只需要这三样东西

很多技术书一上来就列一堆要求，看得人想放弃。咱们换个方式：

你只需要三样东西：

  1. 1. 一台能上网的电脑（Windows/Mac/Linux都行）

  2. 2. 一个API Key（别被这个词吓到，就是一串密码）

  3. 3. 10分钟时间（和一点点耐心）

没了。不需要你是程序员，不需要你懂AI，不需要买服务器。

2.2 第一样东西：一台电脑

2.2.1 系统要求

简单说：只要是近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. 1. 确认你是谁

  2. 2. 计算你用了多少额度

  3. 3. 决定是否响应你的请求

2.3.2 国内三家Coding Plan（推荐）

对于国内用户，我推荐优先选择以下三家。它们都有专门针对开发者的 Coding Plan，且本章统一使用国内站口径（不使用国际站路径）。

2.3.2.1 方案A：KIMI Coding Plan（推荐）

5pMQBY

5pMQBY

申请步骤：

  1. 1. 访问 https://www.kimi.com/code

  2. 2. 登录/注册KIMI账号

  3. 3. 点击"订阅Coding Plan"

  4. 4. 完成支付（支持支付宝/微信）

  5. 5. 进入控制台，点击"创建API Key"

  6. 6. 复制生成的Key（以 sk- 开头）

💡 提示：Key创建后只显示一次，务必保存好。如果丢了，只能重新创建。

2.3.2.2 方案B：MiniMax Coding Plan（推荐）

Cu5XmF

Cu5XmF

申请步骤：

  1. 2. 注册/登录账号

  2. 3. 完成实名认证（需要身份证）

  3. 4. 订阅Coding Plan

  4. 5. 进入"API管理"页面

  5. 6. 创建API Key并复制

2.3.2.3 方案C：GLM Coding Plan（推荐）

WUTpwh

WUTpwh

申请步骤：

  1. 1. 访问 https://bigmodel.cn/glm-coding

  2. 2. 注册/登录智谱AI账号

  3. 3. 进入控制台

  4. 4. 点击"API Keys"菜单

  5. 5. 创建新的API Key

  6. 6. 复制保存

2.3.3 三家对比表

💡 说明：以上价格均按御三家国内站结算页口径记录；后续如有活动变动，请以实时页面为准。

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分钟你要做什么？

保存Key的建议：

  1. 1. 不要 直接保存在微信/QQ聊天记录里

  2. 2. 不要 截图保存在相册里

  3. 3. 推荐 保存在：

  • • 密码管理器（1Password、Bitwarden等）

  • • 本地文本文件（放在安全的位置）

  • • 备忘录（如果支持加密）

⚠️ 重要：API Key就像银行卡密码，泄露了别人就能花你的钱。妥善保管！

2.5 提前看看你会得到什么

完成本书学习后，你将拥有：

一个能在飞书里@的AI机器人：

  • • 私聊问它问题

  • • 群里@它办事

  • • 让它帮你整理文档、查资料

一个可定制的AI助理：

  • • 根据你的需求写Skills

  • • 连接你的常用工具

  • • 自动化重复工作

完全掌控的数据隐私：

  • • 所有数据存在本地

  • • 不经过第三方服务器

  • • 企业级安全保障

本部分小结

来，检查一下你的准备清单：

  • • 一台能上网的电脑（Windows/Mac/Linux）

  • • 一个API Key（KIMI/MiniMax/GLM任选其一）

  • • 10分钟时间

如果都准备好了

动手试试

  1. 1. 确认你的电脑系统版本符合要求

  2. 2. 选择一家Coding Plan，完成API Key申请

  3. 3. 把Key保存在安全的地方（推荐密码管理器）

  4. 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），输入：

PLAIN
node --version

期望看到的结果：

PLAIN
v22.x.x

判断标准：

  • • ✅ 版本 >= v22：可以继续

  • • ❌ 版本 < v22：需要升级

  • • ❌ 提示"command not found"：需要安装

原文地址: https://mp.weixin.qq.com/s?__biz=MzI2NzM4MTQwMg==&mid=2247493608&idx=1&sn=d168b389f053c434b2f05271f6f2a94d&chksm=ebdc81cebcaee67cd60d8ab35df4727cd3bd07f0d88c828f43215fab6703684768e01f223753&mpshare=1&scene=1&srcid=02223h0eEyQ2hqJLtYqCzgmm&sharer_shareinfo=2b0c9bc72e3a459722f974a2569faf9f&sharer_shareinfo_first=2b0c9bc72e3a459722f974a2569faf9f#rd

相关文章