北京九章云极智能研究院：
《OpenClaw新手入门宝典》
（完整版.pdf ）
以下仅展示部分内容
下载方式见文末

2026年，AI Agent元年，一个叫OpenClaw的项目在GitHub上狂揽21.5万+星标，它究竟有何魔力？本文带你从0到1，全面了解并上手这个能替你“动手”执行任务的AI全能小助手。

写在前面：OpenClaw到底是什么？

如果你对AI的认知还停留在“聊天机器人”，那OpenClaw将彻底颠覆你的想象。简单来说，OpenClaw就是给你的大模型装上了一双手。

它不再满足于“只会说”，而是进化成了“能动手执行任务”的全能助手。你可以把它想象成一只听话又能干的AI小龙虾，住在你的电脑里，帮你处理各种繁琐的工作。它是一个AI智能体平台，让你能在自己的电脑上运行AI助理，并把它接入到你日常使用的工具里——比如飞书、微信等聊天工具。

第一部分：关于OpenClaw

它能做什么？

OpenClaw的能力远超你的想象，官方描述中，它可以成为你的数字管家：

• 文件管理：读写、编辑、组织电脑里的所有文件。

• 上网：搜索信息、抓取网页内容，甚至像人一样操作浏览器。

• 提醒和日程：设置定时任务、提醒事项，管理你的日历。

• 消息：帮你发送WhatsApp、Telegram、飞书、Discord等消息。

• 图片：分析图片内容。

• 语音：文字转语音。

• 文档：处理飞书文档、云盘文件。

• 设备：连接和管理你的其他设备。

它不能干什么？

OpenClaw很强大，但并非万能。它的“不能”主要来自物理限制、安全风控、模型依赖等方面：

• 无法突破物理世界：不能插网线、换硬盘，也无法感知现实环境，因为它没有实体。

• 无法绕过安全风控：不能绕过银行U盾、人脸识别、短信验证等强人机验证。

• 能力天花板受限于模型：它自身没有推理能力，完全依赖底层大模型，模型弱则执行差，模型强则成本高。

• 无法100%可靠执行：多步骤任务易卡死、死循环，人工干预率高，不能完全“无人值守”。

• 设计与架构局限：没有独立前端，必须通过聊天工具交互；配置对非技术用户不友好。

一句话总结：OpenClaw是数字世界的“执行手”，适合标准化、可自动化的任务，不适合需要物理操作、强安全验证或高可靠无人值守的场景。

为什么它突然火了？

2026年2月，OpenClaw的GitHub星标数从0飙升至21.5万+，成为现象级项目，主要归功于：

1. 市场刚需爆发：职场人需要数字秘书处理重复工作，开发者需要数字员工接管运维和开发流程。

2. 社区与传播：完全开源免费（MIT协议），部署极简，Skill生态爆发，社区贡献了3000+现成技能插件。

3. 事件催化：2026年2月的“谷歌大规模封号事件”（因使用OpenClaw操作Google账号）引爆全网，让OpenClaw从技术圈破圈，成为全民话题。

4. 时代背景：2026年被公认为AI Agent元年，OpenClaw是首个大规模落地、可直接使用的Agent框架。

OpenClaw与Manus有何异同？

Manus是云端托管、开箱即用的商业智能体；OpenClaw是本地优先、高度可定制的开源执行框架。

• Manus：像“五星级酒店式AI服务”，你只需动口，它包办一切，但需要付费，数据要交给它。

• OpenClaw：像“DIY厨房式AI工具”，厨房是你的，食材（模型）自己选，菜谱（Skill）自己写，完全自由，但得自己动手维护。

怎么选？ 非技术用户、追求开箱即用选Manus；开发者/极客、重视隐私与控制权选OpenClaw。

技术原理（简化版）

OpenClaw是一套本地优先的AI Agent执行引擎，核心架构分为三层：

• 最上层：智能大脑（LLM）：支持GPT-4、Claude等云端模型，也支持Llama等本地模型。

• 中间层：神经中枢（Gateway）：基于Node.js的守护进程，负责消息标准化、会话路由、技能调度。

• 最下层：手脚（渠道与Skill）：通过飞书、微信等渠道交互，通过Skill插件执行具体任务。

它的核心运行逻辑是“思考-行动-反馈-记忆”的Agent循环，让AI能持续优化，越用越精准。

第二部分：安装环境准备

安装OpenClaw前，需要确认你的环境是否满足要求：

• 操作系统：Linux（Ubuntu 20.04+）、macOS（12+）、Windows 10/11（强烈建议使用WSL2），或使用云容器。

• 核心软件依赖：

• Node.js：必须为22.x或更高版本。

• Git：2.30+版本。

• 模型后端：二选一。要么准备云端API（OpenAI/Claude/MiniMax等），要么本地部署Ollama等本地模型服务。

• 网络与端口：云端模型需稳定访问海外API；主网关端口18789必须开放。

• 安全与权限：本地部署可能需要管理员权限；云端API Key需妥善保管。

新手快速部署建议

• 使用官方一键脚本自动检测环境：

• Linux/macOS: curl -fsSL https://openclaw.ai/install.sh | bash

• Windows (PowerShell): iwr -useb https://openclaw.ai/install.ps1 | iex

• Windows用户优先安装WSL2。

• 如果不想折腾，也可以选择第三方提供的免部署在线产品。

第三部分：OpenClaw安装部署（实战）

1. 环境检查：Node.js

打开终端，输入 node --version。如果版本低于v22或提示未安装，需要先安装Node.js 22.x版本。

2. 安装命令

确认Node.js版本后，执行一行命令即可安装：

npm install -g openclaw@latest

安装完成后，输入 openclaw --version 验证是否成功。

3. 运行向导：openclaw onboard

这是最关键的一步，运行以下命令开始初始化：

openclaw onboard --install-daemon

向导会依次询问以下问题：

• 风险提示：选“Yes”。

• 配置模式：新手选“QuickStart”。

• 模型提供商：选择你准备好的，如MiniMax，并输入API Key。

• 模型选择：通常选最新最强的，如MiniMax-M2.5。

• 配置Channel（渠道）：先“Skip for now”，后面再单独配置飞书、微信。

• 配置Skills（技能）：建议先选“NO”，后续再根据需要安装。

• 配置Hooks（钩子）：全选默认的几个。

• 选择访问方式：在云容器中部署的，选“Open the Web UI”。

4. 开始对话

配置完成后，通过Web UI（http://127.0.0.1:18789 或云容器提供的公网地址）或终端，输入你的第一个指令，比如“爬取10条关于今天A股的新闻”或“请告诉我北京今天的天气，并给出穿衣建议”。

如果能得到结构化结果，恭喜你，安装成功！

5. 常见问题

• Gateway启动失败：检查端口18789是否被占用，可尝试更换端口。

• 发送消息无回复：检查API Key是否正确，用 openclaw doctor 和 openclaw logs 排查。

• Web UI打不开：确认Gateway是否在运行，用 openclaw status 查看状态。

第四部分：接入飞书

让OpenClaw接入飞书，你就可以在群里@它来帮你办事了。

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

1. 登录飞书开放平台，创建企业自建应用。

2. 记录下应用的App ID和App Secret。

3. 为应用添加“机器人”能力。

4. 配置权限，搜索并添加 im:message 等核心消息权限。

5. 发布应用版本。

Step 2：在OpenClaw配置飞书

1. 启用飞书插件：openclaw plugins enable feishu。

2. 运行交互式添加Channel：openclaw channels add。

3. 按提示输入App ID、App Secret，选择飞书域名（feishu.cn），群聊策略建议先选disabled。

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

1. 启动Gateway：openclaw gateway start。

2. 回到飞书开放平台，进入“事件与回调”，将“事件订阅方式”改为“长连接”。

3. 添加“接收消息”事件。

4. 再次发布应用版本。

Step 4：与机器人对话

在飞书中搜索你创建的应用，第一次对话会收到配对码，在命令行中执行配对命令后，即可正常对话。

第五部分：接入微信

将OpenClaw接入微信，需要企业微信作为桥梁。

1. 注册企业微信：无需认证，注册一个即可。

2. 创建自建应用：在“应用管理”中创建，记录下AgentId和Secret。

3. 配置API接收地址：在应用详情页的“接收消息”设置中，填写URL（需公网IP）、Token和EncodingAESKey（先随机获取，记录备用）。

4. 安装并配置OpenClaw插件：

openclaw plugins install @openclaw-china/wecom-app

1. 然后编辑 ~/.openclaw/openclaw.json，在 channels 下添加 wecom-app 配置，填入corpId（企业ID）、corpSecret、agentId、token、encodingAESKey等。

2. 重启OpenClaw：openclaw gateway restart。

3. 回填并保存API接收地址：此时再回到企业微信后台，保存之前的API接收设置，应该会成功。

4. 配置企业可信IP：填入OpenClaw服务器的公网IP。

5. 关注微信插件：在企业微信后台的“我的企业->微信插件”中，扫码关注，即可在个人微信中看到并使用该应用。

第六、七部分：Skill技术原理与实战

Skill是OpenClaw的灵魂，它让AI从“什么都能聊”变成“什么都能做”。

什么是Skill？

Skill是一个包含指令的文件夹，用于教AI如何处理特定任务或工作流程。它是定制AI以满足特定需求的最强大方式，实现“一次教学，永久受益”。

Skill的组成部分

• SKILL.md：核心文件，包含YAML元数据（name, description）和Markdown格式的指令。

• scripts/：可选，存放可执行代码脚本。

• references/：可选，存放参考文档或模板。

Skill vs MCP

• MCP：类比专业厨房，提供各种工具、食材和设备（连接外部服务）。

• Skill：类比食谱，提供步骤指导和最佳实践（如何使用这些工具）。

Skill的核心设计原则

• 渐进式披露：只加载必要的元数据，在需要时才加载完整指令，节省Token。

• 可组合性：Skill之间应能良好协作。

• 可移植性：一个Skill可以在Claude.ai、Claude Code、OpenClaw等多个平台通用。

Skill实战

• 最简单的Skill示例：创建一个目录 .claude/skills/字幕转markdown，在其中创建 SKILL.md 文件，按照规范编写YAML和Markdown内容。之后，你只需在Claude中输入 /srt字幕转markdown笔记，就能让它自动将SRT字幕文件转换为Markdown笔记。

• 安装现有Skill：使用 npx skill4agent add <仓库名> 或直接下载放到 ~/.openclaw/skills 目录下。

• 用Skill创建Skill：安装 skill-creator Skill后，你可以直接用自然语言说：“用skill-creator创建一个为图片添加水印的skill，名称为water-mark-add”，OpenClaw就会自动帮你生成一个新的Skill。

• 检查与使用：用 openclaw skills list --eligible 检查Skill是否可用，然后在对话中直接调用即可。

推荐Skills清单

• 核心必备：clawhub（技能管理）、skill-creator（创建技能）。

• 效率工具：agent-browser（操作浏览器）、research（联网查资料）、shell（执行命令）、pdf（处理PDF）。

• 内容创作：frontend-design（前端设计）、copywriting（文案撰写）、obsidian（知识管理）。

• 社媒运营：twitter-automation、TwitterX。

• 设备联动：Nodes（联动手机）、Spotify（控制音乐）。

第八部分：资源站点

想要深入探索OpenClaw，下面这些资源网站是您的不二之选：

• OpenClaw官网与中文教程：https://docs.openclaw.ai/zh-CN

• GitHub仓库（150k+ ★）：https://github.com/openclaw/openclaw

• ClawHub 技能市场：https://clawhub.com

• Discord 社区：https://discord.com/invite/clawd

• 新闻与资讯：The Verge、TechCrunch、CNBC等科技媒体持续跟踪报道。