openclaw新手入门手册

“2026年，你的AI还在当聊天机器人？醒醒吧，该让它干活了！”

---

各位老铁，我是峰哥，一位IT领域18年，人工智能领域8年的实践者，提供云上算力资源租赁服务及大模型、AI应用服务，如有需求或资源对接。疯聊AI主理人。

最近被OpenClaw刷屏了吧？GitHub上21.5万星标，比某些明星的粉丝还多！🔥

但说实话，90%的人只停留在”听说过”，真正动手装上的不到10%，用顺手的更是凤毛麟角。为啥？官方文档写得跟天书似的，看得人直打瞌睡。

今天峰哥就用人话，从0到1，手把手教你把这只”AI小龙虾”驯服，让它老老实实给你打工！

💡 金句先行：OpenClaw不是工具，是你2026年职场生存的”数字外挂”！

---

1.1 一句话解释：给你的AI装上”手”和”脚” 🦾

想象一下：你雇了个清华毕业的助理，智商180，但只会动嘴皮子——这就是ChatGPT、Claude们的现状。

OpenClaw干的事儿很简单：给这位高材生装上手脚，让它能帮你：

• 📁 整理文件（不是建议你怎么整理，是直接动手干！）
• 🌐 自动上网查资料、填表单、抢机票
• 📅 设置提醒、管理日程
• 💬 代你回飞书、微信消息
• 🖼️ 分析图片、处理文档

峰哥观点：以前AI是” consultant（顾问）”，OpenClaw让它变成了” executor（执行者）”。这差距，就像你问朋友”我该不该买房” vs 朋友直接帮你把首付付了！

1.2 它能干啥？（打工人狂喜清单）

说白了，以前你是指挥官+士兵，现在你只需要当指挥官。

1.3 它不能干啥？（别做白日梦了）

峰哥得泼点冷水，省得你到时候骂我：

❌ 物理世界的事儿别找它

• 不能帮你插网线、按电梯、取快递
• 没有摄像头，看不见你家猫主子打翻了水杯

❌ 风控高墙绕不过去

• 银行U盾、人脸识别、短信验证码——这些它搞不定（也最好别让它搞，安全第一！）
• 支付密码？想都别想！

❌ 它不是万能大脑

• 复杂战略决策、法律判断、投资分析——它只能整理信息，不能替你做决定
• 用垃圾模型，它就是垃圾输出；用好模型，你的钱包会哭

❌ 100%可靠？不存在的

• 多步骤任务可能卡死、死循环
• 重要操作建议你自己把关，别当甩手掌柜

💡 峰哥金句：OpenClaw是”数字世界的打工仔”，不是”现实世界的外卖小哥”，更不是”金融界的操盘手”。

1.4 为啥2026年突然火了？（天时地利人和）

2026年2月，OpenClaw的GitHub星标从0飙到21.5万+，Fork 4万+，这速度比某些网红涨粉还快！

为啥？四大原因：

1. 技术突破：终于解决了AI”光说不练”的世纪难题
2. 市场刚需：打工人苦重复性工作久矣！
3. 开源病毒式传播：MIT协议，免费！社区贡献了3000+技能插件
4. 谷歌封号事件催化：2026年2月24日，谷歌大规模封禁使用OpenClaw的账号，理由是”违反服务条款”——争议反而证明了它的强大，能真正操作用户的数字资产！

🔥 热点速递：2026年2月15日，OpenClaw创始人Peter openclaw skills 教程 Steinberger正式加入OpenAI，负责”下一代个人代理”开发！Sam Altman发推确认，OpenClaw将移交基金会保持开源独立。这叫啥？技术圈的最佳归宿——被巨头招安，但不忘初心！

1.5 OpenClaw vs Manus：选哪个？（灵魂对比）

2025年Manus先火，2026年OpenClaw接棒。它俩啥关系？

峰哥建议：

• 非技术用户、怕麻烦、愿意花钱 → 选Manus（五星级酒店式服务）
• 开发者、极客、重视隐私、爱折腾 → 选OpenClaw（DIY厨房，食材自己选，菜谱自己写）

💡 金句：Manus是”保姆”，OpenClaw是”合伙人”。你想当甩手掌柜，还是当老板？

1.6 技术原理（不想看可以跳过，但看了能装X）

OpenClaw的本质是本地优先的AI Agent执行引擎，核心就四件事：

三层架构：

1. LLM大脑层：GPT-4、Claude等，负责思考决策
2. 网关层（Gateway）：基于Node.js的”神经中枢”，监听端口18789，调度一切
3. 执行层：Skills（技能）就是AI的”手脚”

核心循环：思考 → 行动 → 反馈 → 记忆，反复循环直到任务完成。

记忆系统：四级记忆（系统人格、工具注册表、长期偏好、实时会话），越用越懂你。

引用AI Agent领域权威、OpenAI研究员Lilian Weng的观点：”The future of AI is not about better chatbots, but about agents that can actually execute tasks in the real world.”（AI的未来不是更好的聊天机器人，而是能在现实世界执行任务的智能体。）OpenClaw正是这一趋势的首个大规模落地实践。

---

“工欲善其事，必先利其器。器不利，别怪峰哥没提醒！”

2.1 系统要求（对号入座）

2.2 核心依赖（缺一不可）

⚠️ Windows用户注意：官方强烈建议用WSL2！不想折腾WSL2也能在PowerShell装，但部分组件可能不兼容，不影响常规操作。

2.3 网络与端口

• 主网关端口：18789（必须开放，WebSocket通信）
• 云端模型：需稳定访问海外API（国内用户记得配置代理）
• 本地模型：可完全离线，仅首次安装需联网

2.4 快速部署建议（懒人包）

新手直接抄作业：

本地模型（可选，前期建议先用大厂API）： 搭配Ollama部署，推荐 （8GB显存）或 （20GB显存）。

💡 峰哥经验：新手别一上来就折腾本地模型，先用MiniMax、Kimi等国产API，便宜又省心！等玩熟了再考虑本地部署。

---

3.1 环境检查：Node.js是啥？能吃吗？

Node.js就是JavaScript的”翻译官”，让它能在浏览器之外的地方工作。简单说：你不需要懂它，只需要确认装了没。

检查版本：

期望输出：

判断标准：

• ✅ 版本 >= v22：继续往下搞
• ❌ 版本 < v22：得升级了兄弟
• ❌ “command not found”：还没装呢，赶紧的！

不符合要求？按系统来：

macOS：

Windows：

Linux（Ubuntu/Debian）：

验证安装：

两个都应该返回版本号，搞定！

3.2 安装命令：就一行，复制粘贴！

进到userdata目录（共享目录，不同云容器实例可共享），创建openclaw目录：

确认Node.js >= v22后，执行：

这行命令在干嘛？

• ：Node.js的包管理器
• ：安装
• ：全局安装（在任何目录都能用命令）
• ：安装最新版

验证安装：

期望看到：

如果提示git没装成功，大概率是网络问题，可以先不管，不影响后续操作。

3.3 运行向导：（关键步骤！）

安装完运行初始化向导，后续想改配置也能重新运行：

参数说明：

• ：运行初始化向导
• ：同时安装后台服务（推荐，省心！）

第一步：风险提示启动后先问：

选 Yes 继续。（怕啥，有峰哥罩着你！）

第二步：选择配置模式

峰哥建议：第一次选 QuickStart，后面随时能改配置。别一上来就Manual，容易懵。

第三步：选模型提供商（Provider）选官方推荐的 MiniMax2.5，提前到 https://www.minimaxi.com/ 充值并获取API Key。

💡 省钱小贴士：MiniMax性价比不错，适合新手练手。后面用量大了可以考虑其他方案。

第四步：鉴权方式（容易漏！）选完厂商后，会进入鉴权方式选择：

第五步：输入API Key并选模型选MiniMax，输入API Key：

选 Keep current。

第六步：配置Channel（先Skip！）聊天工具先不选，直接 Skip for now，后面随时能回来配置。咱们先把基础打牢！

第七步：配置Skills（建议开）向导会提示配置Skill：

峰哥建议：可以先选 No。很多国外Skill需要科学上网，配了也用不了。后面咱们手动装实用的。

第八步：配置Hooks（建议最小开启）安装Skills后进入Hooks配置：

按空格选中需要的hook，回车确认。默认就三四个，全选上得了。

Hooks是啥？ 简单说就是系统的”改装接口”，让你在关键环节插入自定义逻辑，不用改核心代码。

第九步：选择Hatch方式（关键！）收尾阶段选启动入口：

选项说明：

• TUI：通过终端访问（默认）
• Web UI：访问  网页。云容器实例（CCI）支持外网IP映射，可以通过外网访问。咱们就选这个！

修改配置文件 ：

也可以把服务器地址SSH映射到本地：

本地通过  访问，token在配置文件里找。

第十步：记录Dashboard链接与Gateway状态完成Hatch选择后，向导会输出控制台信息。如果选了Web UI，一般会直接给出带token的Dashboard链接并尝试自动打开浏览器。

如果选了 Do this later，后续可用：

再次获取入口。

3.4 开始对话——见证奇迹的时刻！ 🎉

测试查询能力：

按回车发送。

期望回复：直接给出结构化结果（天气+穿衣建议），而不是继续自我介绍。

如果看到回复，恭喜你！安装成功！ 🎊

💡 峰哥吐槽：这时候是不是有种”驯服野生AI”的成就感？别急，后面还有飞书、微信接入，那才叫真香！

3.5 出错了？别慌，峰哥给你兜底！

问题一：Gateway启动失败

• 症状：向导提示 
• 可能原因：端口18789被占用、权限不足、配置文件错误
• 解决：

问题二：发送消息无回复

• 症状：消息发出去，一直显示”正在输入”但没回复
• 可能原因：API Key错误、网络不通、模型服务异常
• 解决：

问题三：Web UI打不开

• 症状：浏览器访问  显示无法连接
• 可能原因：Gateway没启动、防火墙阻挡、地址输错
• 解决：

---

痛点：每天被飞书消息轰炸，回复到手软？让OpenClaw当你的”数字客服”！

整体流程（别搞错顺序！）

1. 平台侧建应用（拿凭证）
2. OpenClaw侧配置渠道（）
3. 启动Gateway并验证收发
4. 配对/白名单放行

4.1 Step 1：在飞书开放平台创建应用

进入飞书开发者后台，”创建企业自建应用”：

填写应用名称、应用描述，选个应用图标，点击创建。

获取应用凭证：创建成功后，在凭证与基础信息页面，记录 App ID 和 App Secret。这是核心凭证，妥善保管！

添加”机器人”能力：在应用能力 → 添加应用能力中，启用机器人能力，让应用能收发消息。

添加成功后，左侧出现机器人板块。

配置关键权限：进入权限管理，搜索并添加与即时通讯相关的核心权限。搜索 （英文冒号），让机器人能在会话中正常工作。

发布应用版本：进入版本管理与发布，填写版本和更新说明，点击保存。

点击创建版本。

应用发布成功！

如需审核，登录飞书客户端批准应用上线。

4.2 Step 2：在OpenClaw配置飞书

4.2.1 启用飞书插件查看插件列表：

如果存在feishu且状态是disabled，启用它：

⚠️ 注意：官方文档说可以用 ，但Windows下可能报错。建议优先启用内置plugin，Windows安装的需要重启网关才生效。

4.2.2 交互式添加Channel

按提示完成配置：

问题1：选择渠道类型

问题2：输入App ID粘贴你获取的App ID。

问题3：输入App Secret粘贴App Secret（粘贴时不显示字符，正常）。

问题4：选择飞书域名国内用户选 。

问题5：群聊策略先选 disabled，等私聊通了再开群聊。

问题6：需要mention才回复？选 yes，避免机器人在群里乱说话。

4.2.3 验证配置

应该显示：

4.3 Step 3：开启事件订阅（长连接）

⚠️ 重点：顺序不能搞错！

正确时序：

1. ✅ 飞书侧：创建应用 → 配置权限 → 发布应用
2. ✅ OpenClaw侧：配置渠道
3. ✅ OpenClaw侧：启动Gateway
4. ✅ 飞书侧：开启事件订阅（长连接）
5. ✅ 飞书侧：配置事件订阅地址

顺序错了，长连接会订阅失败，表现为”消息发出去，机器人没反应”。

4.3.2 启动Gateway

确认输出：

4.3.3 在飞书平台开启事件订阅回到飞书开放平台 → 事件与回调 → 事件订阅方式选择长连接，点击保存。

此时添加事件按钮从灰色变可操作，点击它：

搜索并勾选接收消息事件（核心事件，确保机器人能收消息）：

进入权限管理 → 点击开通权限，搜索并开通获取通讯录基本信息权限：

配置完成，进入版本管理与发布，重新发布应用，点击保存：

沿用此前流程，直接发布为在线应用。

4.4 Step 4：与机器人对话

打开飞书电脑客户端或手机APP，搜索之前创建的机器人：

应用发布成功后，返回飞书客户端找到机器人。这时候还不能直接对话，需要配对与放行！

首次交互后，机器人会回复含配对码（Pairing code）的内容，比如下图中的 ：

在命令行执行：

搞定！现在可以正常对话了：

💡 峰哥得意：这时候是不是觉得，有个24小时在线的飞书小助理很香？老板半夜@你，可以让AI先顶着！（开玩笑的，别真这么干😂）

---

痛点：以前还得开网页聊AI？现在直接在微信对话框里@它，响应速度杠杠的！

详细步骤

Step 3：进入应用管理 → 自建 → 创建应用

3.1 给应用取名：比如”疯聊AI客服机器人”，随便传个Logo。

3.2 可见范围：选你自己就行。

3.3 创建完成点击应用，记下两个参数：AgentId 和 Secret。

Secret需要点击”查看”按钮，按提示在企业微信中查看。

Step 4：创建API接收地址在企业微信网页下方配置接收消息 → 通过设置API接收：

需要配置3个信息（门槛：需要一个公网IP，所以本地部署的OpenClaw不适用）：

这时候点击保存是保存不了的，因为地址还不能访问，需要先装插件。

Step 5：安装插件在安装了OpenClaw的机器上运行：

Step 6：配置企业微信API编辑配置文件，添加企业微信相关参数：

Step 7：重启OpenClaw

Step 8：重新配置并保存将第4步的信息重新配置，点击保存，现在就能保存成功了。

Step 9：配置企业可信IP这个IP就是OpenClaw所在的IP地址。IP如果配错了可能发消息没反应，如果用我们平台部署遇到问题，文末扫码找小编协助。

Step 10：打开企业微信测试工作台 → 点击应用：

最重要的一步！启动微信插件点击我的企业 → 微信插件 → 扫码关注：

关注成功后，你的个人微信里就多了一个企业微信的消息入口：

现在就能和它聊天了！

---

痛点：每次都要重复教AI怎么做？Skill就是”一次教学，终身受益”！

6.1 什么是Skill？

Skill（技能）是一个包含指令的文件夹，用于教Claude如何处理特定任务或工作流程。它是定制Claude的最强大方式之一。

核心价值：

• 一次教学，永久受益：不用每次对话都重复解释
• 标准化工作流：团队成员用一致的方法完成任务
• 降低使用门槛：新用户快速上手复杂功能

6.2 Skill的组成部分

一个完整的Skill文件夹包含：

6.3 Skill vs MCP：厨房比喻 🍳

协同工作：MCP提供连接性（连Notion、Asana等），Skill提供知识层（教AI如何有效使用这些服务）。

6.4 为什么需要Skill？

没有Skill时：

• 用户连接MCP后不知道下一步该做什么
• 每次对话从零开始，结果不一致
• 支持工单激增：”如何用您的集成做X？”

有了Skill后：

• 预构建的工作流自动激活
• 一致、可靠的工具使用
• 每次交互都嵌入最佳实践

6.5 Skill的核心设计原则

（1）渐进式披露（Progressive Disclosure）三级系统优化Token使用：

（2）可组合性（Composability）Claude可同时加载多个Skill，你的Skill要能与其他Skill协作。

（3）可移植性（Portability）Skill在Claude.ai、Claude Code、OpenClaw及各vibe coding工具中工作方式相同，创建一次，全平台使用。

6.6 常见的Skill用例类别

类别1：文档与资源创建

• 用途：创建一致、高质量的输出（文档、演示文稿、应用、设计、代码等）
• 示例： Skill
• 关键技术：嵌入风格指南、模板结构、质量检查清单

类别2：工作流自动化

• 用途：多步骤流程，跨多个MCP协调
• 示例： Skill
• 关键技术：分步工作流、验证门、迭代优化循环

类别3：MCP增强

• 用途：增强MCP服务器提供工具访问的工作流指导
• 示例： Skill（来自Sentry）
• 关键技术：协调多个MCP调用、嵌入领域专业知识、错误处理

6.7 技术规范与文件结构

关键命名规则：

• SKILL.md：必须完全匹配（区分大小写），不接受、等变体
• Skill文件夹：使用短横线连接（kebab-case），如。❌ 不要有空格、下划线、大写字母
• 禁止事项：Skill文件夹内不要放README.md，文档放SKILL.md或references/中

YAML前置元数据（最重要！）：

字段要求：

• name（必需）：仅使用短横线连接，无空格或大写字母，与文件夹名称匹配
• description（必需）：必须包含两部分（功能+触发条件），少于1024字符，无XML标签，包含用户可能说的具体任务
• license（可选）：开源Skill使用，如MIT、Apache-2.0
• compatibility（可选）：1-500字符，指示环境要求
• metadata（可选）：自定义键值对，如author、version、mcp-server

💡 峰哥金句：YAML写不好，Skill等于白搞。这就像是给AI的”求职简历”，写不清楚，AI不知道啥时候该”上岗”！

---

痛点：市面上Skill成千上万，怎么找？怎么用？怎么造？

7.1 最简单的Claude Skill示例

咱们先开发一个最简单的Skill，理解原理。Claude通过目录结构和SKILL.md文件规范Skills。

创建目录结构：

在该路径下创建 SKILL.md（注意大写SKILL），内容：

准备其他文件，将一个srt文件放到SKILL.md同级目录：

启动Claude，输入选择模型：

通过进入skills，查看有哪些skills：

读取srt内容，还没完，咱们要转成Markdown！

通过进入该Skill，先读取，后存为Markdown文件：

同级目录下生成了文件：

打开看一眼，转换成功！

至此，用Skill成功生成Markdown格式文件！

也可以直接通过插件市场安装：

然后用自然语言让Claude Code创建Skill。

7.2 从资源站点安装现有Skill

每个Skill说明里都有安装命令，一般通过nodejs安装。如果没有安装命令，直接下载Skill文件包，放到：

打开skills目录，可以看到已安装的Skill目录，一个目录就是一个Skill：

用Skill创建Skill（套娃警告！）

这个Skill已经学会了Skill的创建方法，安装后可通过自然语言让它创建其他Skill：

✅ water-mark-add Skill 创建完成！

使用Skill：

效果：成功批量添加水印！

7.3 检查Skills是否可用

eligible表示：

• Skill已正确安装
• 所有依赖的Tools都已启用
• 可以正常使用

7.4 查看Skill详情

输出示例：

7.4 OpenClaw Skill使用示例

一个Skill只有一个基本功能，一个任务往往需要多个Skill按先后顺序执行，类似Coze、n8n等工作流产品。

7.4.1 安装示例Skill以为例：

7.4.2 调用Skill

方式一：对话中直接调用

方式二：使用命令

方式三：带参数调用

7.4.3 查看执行结果Skill执行后会：

• 显示执行日志
• 返回执行结果
• （可选）生成输出文件

示例输出：

7.5 Skill更新与回退

Skill是活的，可以编辑更新。

7.5.1 更新Skills

7.5.2 回退或覆盖安装

💡 峰哥建议：如果要”停用”某个Skill，建议在OpenClaw配置里将对应条目设为，而不是直接删除文件夹。留条后路，以防万一！

7.6 推荐Skills清单（峰哥精选）

（1）核心必备技能（必装/基础前置）

（2）效率工具类技能（办公神器）

（3）内容创作类技能（创作者必备）

（4）社媒运营类技能（自媒体利器）

（5）设备联动类技能（未来已来）

💡 峰哥展望：看到没？这就是未来！以后回家喊一声”我回来了”，OpenClaw帮你开灯、调空调、放音乐，还能汇报今天的待办事项。这生活，美滋滋！😎

---

“2026年，不会用AI Agent的人，就像2010年不会用智能手机的人——不是不能活，但会活得很累。”

咱们回顾一下，这篇指南解决了哪些痛点：

最后几个金句送给大家：

1. OpenClaw不是替代你，是放大你——它干重复劳动，你干创造性工作。
2. 本地优先不是技术洁癖，是数据主权——你的数据，你做主。
3. Skill生态的爆发，标志着AI从”玩具”走向”工具”——3000+插件，总有一款适合你。
4. 2026年是AI Agent元年，OpenClaw是第一个落地的”炮仗”——响声大，后劲足！

现在，轮到你动手了！

别收藏了吃灰，现在就：

1. 检查Node.js版本
2. 复制那行安装命令
3. 跟着向导走一遍
4. 发出你的第一条消息

遇到问题了？ 回来看这篇指南，或者扫码找峰哥😉

---

本文档由峰哥基于OpenClaw官方文档及社区资料整理以及新自实践操作验证，形成《openclaw入门宝典》。如有错漏，欢迎指正！

提示：完整宝典PDF领取公从好：九章智算云

记住：AI不会取代你，但会用AI的人会取代你。现在就开始，成为那个”会用AI的人”！ 🚀🦞