九章云《OpenClaw新手入门宝典》解读

北京九章云智能研究院最近也出了一本OpenClaw的学习手册《OpenClaw新手入门宝典》，如下：

第一部分：OpenClaw 到底是个啥？（核心画像）

简单来说，OpenClaw 就是给你的大模型装上了一双“手”。

以前的大模型（比如早期的 Chatbot）像个“军师”，只会动嘴皮子出主意，真让它去干活（比如改个文件、发个邮件、爬个网页），它就傻眼了。而 OpenClaw 是个本地优先的 AI 智能体平台（Agent Platform），它能让 AI 真正住进你的电脑里，通过调用各种工具（Skill），去操作文件系统、运行终端命令、控制浏览器，甚至接入飞书、微信帮你自动回复消息。

文档里有个比喻特别形象：Manus 是“五星级酒店”，你付钱，它包办一切，但你不能进厨房；OpenClaw 是“DIY 厨房”，房子（电脑）是你的，食材（模型）你随便选，菜谱（Skill）你自己写，虽然得自己动手折腾，但胜在自由、隐私可控，而且免费（开源）。

它能干啥？

• 文件管家：读写、整理、编辑文件。
• 网络冲浪：搜索信息、抓取网页、操作浏览器。
• 社交达人：接入飞书、微信、Telegram，自动发消息、回消息。
• 时间管理：设置定时任务、提醒事项。
• 多模态处理：看图、转语音、处理文档。

它不能干啥？（这点很重要，别神化它）

• 物理隔离：它摸不到现实世界，插不了网线，按不了电源。
• 安全高墙：绕不过银行 U 盾、人脸识别、复杂的验证码。
• 智商上限：它本身没脑子，全靠你接的大模型（如 GPT-4、Claude）。模型弱，它就笨；模型强，成本就高。
• 绝对可靠：多步骤任务容易卡壳、死循环，不能完全无人值守，偶尔还得人工救场。

第二部分：怎么把它跑起来？（安装与部署）

文档这部分写得非常细致，简直是“保姆级”教程。

1. 环境准备：

• 系统：Linux/macOS 原生支持最好；Windows 用户强烈建议用 WSL2（Windows 下的 Linux 子系统），不然容易踩坑。
• 核心依赖：必须装 Node.js 22.x 版本，这是它的运行底座。
• 模型后端：你可以选云端 API（如 MiniMax、OpenAI、Claude），也可以选本地模型（如 Ollama），丰俭由人。

2. 一键安装：

• 命令就一行：npm install -g openclaw@latest。
• 然后运行向导：openclaw onboard --install-daemon。这个向导会带你配置模型 Key、选择鉴权方式、安装 Skills 等。文档里特别提到，新手选 QuickStart 模式最快。

3. 避坑指南：

• 端口占用：默认端口 18789 如果被占了，记得换端口。
• 网络问题：国内用户用云端模型可能需要代理，或者直接用国产模型（文档推荐了 MiniMax）。
• Web UI 访问：如果是云服务器部署，记得配置公网 IP 映射和防火墙，不然网页打不开。

第三部分：怎么让它听话？（接入与 Skill 生态）

这是 OpenClaw 最强大的地方——扩展性。

1. 接入IM工具：

• 飞书/微信：文档详细讲了怎么在飞书开放平台和企业微信后台创建应用，获取 AppID/Secret，然后在 OpenClaw 里配置 Channel。
• 关键点：顺序不能乱！先建应用 -> 配 OpenClaw -> 启动网关 -> 最后再去 IM 平台开事件订阅。特别是微信，需要公网 IP 才能接收回调，本地部署搞不定就得用云容器或内网穿透（但文档提示微信官方有限制，建议直接用云服务）。

2. Skill（技能）系统：

• 什么是 Skill？
   就是一套标准化的“指令包”。它告诉 AI 在什么场景下、用什么工具、按什么步骤完成任务。
• 结构：一个文件夹，核心是 SKILL.md 文件（包含 YAML 元数据和 Markdown 指令）。
• 怎么用？
• 现成的：去 ClawHub 或 GitHub 上找别人写好的 Skill（如日报生成、网页抓取、PDF 处理），一行命令安装。
• 自己写：文档给了个超简单的例子——把 SRT 字幕转成 Markdown 笔记。只要按规范写好 SKILL.md，AI 就能学会这个新技能。
• 用 AI 写 Skill：甚至可以安装一个 skill-creator，让 AI 自己帮你写新的 Skill，这就有点“递归”的味道了。

第四部分：个人见解

看完文档，我有几个想法，文档里没明说，但值得你注意：

1）“本地优先”是把双刃剑。数据不出域，隐私安全性极高，适合处理敏感数据（如公司内部文档、个人财务），而且没有厂商锁，你想换模型就换模型。这对用户的运维能力有要求，你得自己管服务器、管密钥、管更新。对于非技术背景的普通白领，门槛还是有点高。文档里提到的“免部署方案”（第三方云服务）可能是未来大规模普及的关键。

2）Skill 生态是护城河。OpenClaw 的核心竞争力不在于框架本身，而在于社区贡献的 Skill 数量和质量。文档里提到已经有 3000+ 技能（文档的数据差了很多，我前不久看到已有1.8万个技能），覆盖办公、开发、生活。如果这个生态能持续繁荣，它会形成一个类似 WordPress 插件市场那样的网络效应。谁写的 Skill 好用，谁就能定义工作流。

3）安全与风险的平衡。文档很诚实地列出了“不能做什么”，但也提到了它可以获得 Shell 级权限。这意味着，一旦配置不当或被恶意 Skill 入侵，后果可能很严重（比如删库跑路）。虽然它有九层权限过滤和沙箱机制，但在生产环境中，“人在环”（Human-in-the-loop，人机协同） 的审核机制至关重要。不要完全信任 AI 的自主执行，特别是在涉及删除、转账、发送大量消息等操作时。

4）安全配置的深度不足。虽然提到了权限过滤，但对于如何配置细粒度的权限（比如只允许读某个目录，不允许删）、如何审计 Agent 的操作日志，讲得还不够深。对于企业级用户，这些是刚需。

https://pan.baidu.com/s/1BcqRkiSHvwxciI6ttDLBLQ?pwd=wzj2

提醒一句：以上资料请仅用于个人学习和研究之用，勿用于任何商业目的，切记！！！