大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
2 万字零基础安装OpenClaw全教程，30分钟搞定别人折腾一周的事。
 

 这是「OpenClaw 从零到神」系列第一篇，纯小白也可以的 Openclaw 完全部署指南。第二篇技能篇已经发布！后续还有使用场景篇和高阶玩法篇，关注不迷路。如果你想立马用上，文末有方法～

最近一个月，好多帮人上门安装 Openclaw 的消息刷屏互联网了。当然，我的私信被同一个问题淹没了。

"OpenClaw怎么装？"

不是一两条。是几百条。

有用Mac的，有用Windows的，有连自己电脑是什么系统都搞不清楚的。

有截图问我"这个报错啥意思"的，有直接发语音"大佬救命"的。

有折腾了两天最后放弃的，也有折腾了一整周、差点把系统搞崩了才来找我的。

说实话，我本来不打算写 Openclaw 系列，因为我觉得它对于普通小白有点难，但是看到很多朋友一直在踩坑，所以打算怎么也要把这篇小白也能看懂的从 0 开始部署完整的 openclaw 教程写好。

一个23万Star的项目，大部分人倒在了安装这一步。这不应该。

OpenClaw这东西，它难。但是也真的不难。

难的是，网上那些教程，要么只讲Mac不讲Windows。要么面向程序员写得像天书。要么只有三五百字草草了事，装到一半报错了你完全不知道该怎么办。

所以我花了整整一周的时间，写了这篇保姆级安装教程。文章字数 2w+，力求用最精细的步骤教你理解、部署、进阶，一篇文章，慢慢来～

Mac和Windows双平台全覆盖。

核心步都有截图。

每一个可能出错的地方都有解决方案。

零基础。真的零基础。你只要会打字、会复制粘贴，就能跟着做完。

阅读导航：

不管你是哪类读者，都先看完第二章准备篇。里面的四个概念科普会让你后面每一步都看得更明白。

话不多说，开始。

在正式动手之前，我想先花两分钟，跟你说清楚你要装的这个东西到底是啥。

因为我发现，很多人是跟风来装的，"听说很厉害""群里都在聊"，但具体OpenClaw是干什么的，其实没太搞明白。

搞明白你在装什么，比装它本身更重要。

先看一组数据。

OpenClaw在GitHub上的Star数是262,000+。

Fork数50,200+。

MIT协议开源，意思是完全免费，代码公开，谁都能用，谁都能改。

这是什么概念呢？它是GitHub历史上增长最快的开源项目之一，上线不到一个月，就突破了19万Star。这个速度，在整个开源社区的历史上都极其罕见。关键是他已经破圈了，是全民生态下的最热门项目，不对，不是项目，是切切实实对工作有价值的工具。

但Star数说了不算。关键是，它到底能帮你干什么？

你用过ChatGPT、Claude、DeepSeek对吧？你让它帮你整理桌面文件，它给你列个一二三四五的步骤——但不会真的动手。

它会说，但它不会做。

OpenClaw不一样。

OpenClaw不是聊天机器人。它是一个真正能帮你干活的数字管家。

它做的事情是，给AI装了一部手机。

让AI能通过飞书、Telegram、Discord、WhatsApp等20多个聊天平台，随时随地帮你干活。

不只是聊天。是真的动手干。

你可以在飞书上跟它说"帮我把下载文件夹里的PDF按日期归档"，它就真的扫描你的下载文件夹，按日期创建子文件夹，把PDF一个个移过去。

你可以在Telegram上跟它说"读一下桌面上那篇论文，给我写个500字的中文摘要"，它就真的读了论文、理解了内容、写好了摘要、存成了文件。

你可以在微信上跟它说"每天早上8点帮我查一下今日AI新闻，整理成摘要发给我"，它就真的每天准时推送。

说白了，别的AI只会动嘴，OpenClaw真的动手。

"那它和Claude Code有什么区别？"——Claude Code是给程序员写代码用的闭源工具，OpenClaw是给所有人处理日常事务用的开源框架。定位完全不同。

这个"Open"，意思是开源，对所有人开放。记住这个词，后面收尾的时候我还要聊它。

对了，OpenClaw的创始人Peter Steinberger今年2月被OpenAI挖走了。但社区依然活跃——GitHub上每天都有新提交，2月份单月新增Issue超过800条。创始人被抢走了，项目反而更火了。 开源的韧性，就在这里。

好了，现在你知道你要装什么了。

一个247,000+Star、支持20多个聊天平台、本地部署数据不出设备、完全免费开源的AI数字管家。

说实话，光这几个标签，就够让人兴奋了。

别急着动手。

我知道你现在恨不得马上开始装。但请给我5分钟，让我把4个基础概念跟你说清楚。

这5分钟的投入，能让你后面节省至少1个小时的困惑和焦虑。

这玩意就像游戏教程，你跳过教程确实能省两分钟，但后面打Boss的时候你会被虐得怀疑人生。

2.1 什么是终端/命令行？

这是我被问得最多的问题。"终端是什么？""命令行是什么？""那个黑底白字的东西是什么？""是不是电影里黑客用的那个？"

别怕。真的别怕。

终端就像你给电脑发微信，你打字发指令，电脑收到后执行。它不说"好的亲"，直接把结果吐给你。

就这么简单。

你平时操作电脑，是用鼠标点来点去对吧？点文件夹、双击应用、拖拽文件。

终端做的是完全一样的事，只不过你不用鼠标了，用打字代替了点击。

比如你想看看桌面上有什么文件：

- 用鼠标？打开Finder（Mac）或者资源管理器（Windows），点进桌面文件夹，一目了然。

- 用终端？输入一行命令 ls ~/Desktop（Mac）或 dir Desktop（Windows），文件列表就打出来了。

效果一模一样。只是操作方式不同。

那为什么不用鼠标点呢？为什么要用命令行？

因为有些操作，比如安装软件包、配置环境变量、启动服务，用鼠标点不了，必须用命令行。就像有些表格操作必须用公式而不能手动填一样。

在Mac上，这个东西叫"终端"（Terminal）。

怎么打开？最快的方式：按 Command + 空格（会弹出Spotlight搜索），然后输入"终端"两个字，回车就打开了。

或者你也可以在"应用程序 → 实用工具"文件夹里找到它。

在Windows上，它叫"PowerShell"。

怎么打开？按 Win + R（会弹出"运行"对话框），输入 powershell，回车。

或者更简单：直接在Windows左下角的搜索栏里搜"PowerShell"，点击打开。

看到那个窗口了吗？

不管是黑底白字还是白底黑字还是蓝底白字，它就是一个打字的窗口而已。你接下来要做的事情，90%都是复制粘贴，把我给你的命令复制进去，回车，等它跑完。

2.2 什么是Node.js？为什么需要它？

安装OpenClaw的第一步，是安装一个叫Node.js的东西。之前的文章有介绍过，为了保持完整性，这里再强调一遍～

"这又是什么？为什么要装这个？OpenClaw不是主角吗？"

好问题。

Node.js就像一个翻译官。

OpenClaw是用JavaScript这门编程语言写的。但你的电脑原生不认识JavaScript，就像一个只会中文的人，面前摆了一本法语小说，每个字母都认识但连成句子就完全看不懂。

Node.js就是这个翻译官，它把JavaScript"翻译"成你的电脑听得懂的机器语言，让OpenClaw能在你的电脑上跑起来。

没有Node.js，OpenClaw就是一堆电脑看不懂的天书。

有了Node.js，OpenClaw才能正常工作。

所以Node.js是"前置依赖"，先装它，才能装OpenClaw。

版本要求：Node.js >= 22。

这个就像微信要求你的手机系统是iOS 15以上、Android 10以上一样。OpenClaw要求你的Node.js版本不能低于22。低了它启动不了。

还有一个你会经常看到的名词，npm。

npm全称是Node Package Manager，Node的"包管理器"。

你可以把npm理解成Node.js自带的"应用商店"。

你安装Node.js的时候，npm会自动一起装好。你不需要单独安装它。

等会儿我们安装OpenClaw的时候，就是通过npm来装的，就像你在App Store里搜索一个App然后点"获取"一样，只不过换成了在终端里输入一行命令。

Node.js是翻译官，npm是应用商店。记住这两个比喻，后面的步骤你就不会懵了。

2.3 什么是API Key？为什么需要它？

这个概念非常重要。如果你不理解API Key，后面配置的时候你一定会一脸懵。所以请认真看完这段。

先说结论：OpenClaw本身是免费的。完全免费。你不用花一分钱。

但OpenClaw本身并不"聪明"。

它是一个框架，一个"骨架"。它能帮你接收消息、执行任务、管理插件，但它没有"大脑"。

它的"大脑"是外接的，来自AI大模型（比如通义千问、Claude、GPT、Kimi等）。

你对OpenClaw说"帮我写一首诗"，OpenClaw自己写不了。它需要把你的请求转发给AI大模型，大模型思考完了把结果返回给OpenClaw，OpenClaw再把结果告诉你。

而要调用这些大模型的服务，你需要一个身份凭证。

这个身份凭证，就叫API Key。

API Key就像健身房的会员卡，器材（大模型）不是你的，但你刷卡就能用。

具体的工作流程是这样的：

1. 你对OpenClaw说："帮我写一首关于春天的诗"

2. OpenClaw收到请求，拿着你的API Key去找AI大模型（比如MiniMax）

3. MiniMax的服务器验证这个Key，"验证通过，是合法用户，放行"

4. MiniMax开始思考，生成了一首诗

5. 把诗返回给OpenClaw

6. OpenClaw把诗发送给你

整个过程中，你的对话内容、文件数据都在你自己的设备上。API Key只是用来向大模型"证明你是谁"的，不会泄露你的数据。

"那API Key怎么获取？要花钱吗？"

好消息来了。

这里有个容易踩的坑：OpenClaw 是 AI Agent，不是普通聊天工具。 它每次执行任务，可能要来回调用模型好几轮，Token 消耗比你手动打字聊天大得多。

MiniMax 推出的 Coding Plan，是专门针对这类高频调用场景设计的开发者套餐，单价低、用量足，日常运行 OpenClaw 基本够用，不会动不动就超额报错。

后面配置向导那一步，我会手把手教你怎么获取 API Key（以 MiniMax Coding Plan 为例）。截图、步骤、注意事项全部拉满。

现在你只需要知道，选对套餐，才不会跑着跑着就"断粮"。先把 Coding Plan 办上就行。

其他模型（Claude、GPT等）的API Key按 Token 计费，Agent 跑多了费用上去很快。等你用 MiniMax 玩熟了、摸清自己用量了，再考虑升级也不迟。

2.4 整体流程预览——就5步，一目了然

好，四个概念讲完了。

终端 = 给电脑发微信。Node.js = 翻译官。npm = 应用商店。API Key = 会员卡。

接下来，我们的整个安装过程，总共就5步：

Mac用户还需要在第1步之前装一个Homebrew（Mac的命令行应用商店），多加5-10分钟。

Windows用户需要额外装一个Git（代码工具），多加3-5分钟。

总计：大约30-45分钟。

对，就5步。

你想想，你第一次注册微信的时候，也是"下载App → 输手机号 → 填验证码 → 设置头像 → 开始用"。是不是也是5步？

OpenClaw的安装，本质上就是同一个事。

2.5 两个提前说清的小知识

在正式开始安装之前，还有两件事我先说清楚，后面Mac篇和Windows篇都会用到。

第一件：npm镜像源设置（国内用户必做）

npm默认从国外服务器下载东西，在国内访问可能很慢甚至超时。解决方案是把下载源换成国内镜像（npmmirror.com，原淘宝镜像），速度快十倍以上。就像你下载文件选了个国内CDN节点，不走国际线路了。后面安装OpenClaw之前，我会提醒你执行这一步。

第二件：WARN和ERROR的区别

安装过程中你会看到终端刷出各种信息。记住两个颜色：

- 黄色的WARN：友善提醒，"嘿，有个小事提醒你一下，但不影响安装。"——不用管。

- 红色的ERROR/ERR：出事了，需要处理。——看到了再往下翻常见问题排查。（实在不行，把截图发给 ai，让他指引你一步步完成）

只要没看到红色ERROR，就安心等它跑完。

好了，该动真格了。

Mac用户请继续往下看第三章Mac部署篇。

Windows用户请直接跳到第四章Windows部署篇。

Mac用户看这里。

如果你是Windows用户，请跳过这整章，直接去第四章。这一章的每一个命令、每一张截图都是Mac专属的，Windows上操作方式不一样。

这一章我会带你走完从打开终端到成功安装OpenClaw的完整过程。

准备好了吗？

打开你的终端，按 Command + 空格，输入"终端"，回车。

看到那个窗口了吗？

光标在闪？

好。我们开始。

3.1 第一步：安装Homebrew（Mac专属）

Homebrew是什么？

前面讲了，npm是Node.js的应用商店。Homebrew呢？

Homebrew是Mac整个系统的"命令行应用商店"。

你在App Store用鼠标点击就能装App对吧？Homebrew也是装东西的，只不过换成了在终端里输入一行命令。更快、更灵活。

后面我们要通过Homebrew来安装Node.js。所以Homebrew是第一步。

如果你已经装过Homebrew了，打开终端输入 brew --version，如果能看到版本号（比如 Homebrew 4.x.x），说明你已经有了，直接跳到3.2。

如果没装过，或者输入后提示"command not found"，跟着我来。

在终端里，复制粘贴下面这行命令（整行全部复制，一个字符都别漏），然后按回车：

GPT plus 代充 只需 145

curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh

这行不用管原理，复制粘贴回车就完了。它做的事情就是从Homebrew官方服务器下载安装脚本，安全可靠。

回车之后，终端会提示你输入Mac的开机密码（就是你每次开机/安装软件时输入的那个密码）。

注意，这里有一个让无数新手崩溃的"陷阱"：

你打密码的时候，屏幕上不会显示任何字符。没有星号、没有小圆点、什么都没有。

这是正常的。Mac的终端就是这样设计的，出于安全考虑，不显示密码的任何痕迹。

所以不要以为键盘坏了或者没输进去。你只管正常打完密码，然后按回车就行。

"我打了密码但什么都看不见，是不是输错了？"大概率没输错。直接回车试试。如果密码确实错了，它会再让你输一次。

输完密码后，Homebrew开始下载和安装。

这个过程大概需要3-10分钟，取决于你的网速。

说实话，我自己第一次装OpenClaw的时候，就是在这一步翻了车。Homebrew装了40分钟，我以为电脑死机了差点强制关机。后来才知道，是因为默认源在GitHub，国内访问慢得要命。

Apple的命令行工具安装速度，慢得像用信鸽传输。

所以如果你也卡住了，别慌，接着往下看。

你会看到终端里哗哗地刷出一堆文字。不用细看，也不用看懂。让它跑就行。

只要没有出现红色的 ERROR 字样，就没问题。

当你看到 Installation successful! 或类似的成功提示时，恭喜你，Homebrew装好了。

验证一下：在终端里输入：

brew --version

如果看到类似 Homebrew 5.x.x 的版本号，确认完毕，第一个任务搞定。

进度：1/5，环境准备的第一关过了。

你看，命令行不咬人。它只是长得凶。

常见问题：Homebrew安装过程中一直卡住不动？

如果安装过程中一直卡在"Downloading..."或者"Fetching..."不动，大概率是网络问题。因为Homebrew的默认源在GitHub（国外服务器），国内访问有时候会很慢甚至超时。

解决方案：换成国内镜像源安装。在终端输入以下命令：

GPT plus 代充 只需 145

/bin/zsh -c "$(curl-fsSLhttps://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

这是一个国内开发者维护的Homebrew安装脚本，走的是Gitee（国内代码托管平台）的镜像，下载速度会快很多。

执行后它会让你选择镜像源，选哪个都行，推荐选"中科大"或"清华"。

好，Homebrew搞定了。

3.2 第二步：安装Node.js

有了Homebrew，安装Node.js就是一行命令的事。

在终端输入：

brew install node

一句话：告诉Homebrew帮我装Node.js。

Homebrew会自动帮你完成以下所有步骤：

1. 从镜像服务器下载Node.js安装包

2. 解压并安装到正确的目录

3. 配置好环境变量（让你在终端里能直接用 node 和 npm 命令）

你什么都不用管。就等着它跑完就行。

安装过程大概1-3分钟。

跑完之后，验证一下：

GPT plus 代充 只需 145

node -v

如果看到 v22.x.x 或更高的版本号，完美。Node.js安装成功。

再验证一下npm（应用商店）：

npm -v

看到版本号就行。npm是Node.js自带的，装了Node.js就自动有了，不需要单独安装。

进度：2/5，翻译官到位了。

两行命令，一个翻译官就位。这节奏比点外卖还快。

如果你的Node.js版本低于22怎么办？

比如你之前装过旧版本的Node.js，node -v 显示的是 v18.x.x 或 v20.x.x。

解决方案：

GPT plus 代充 只需 145

brew upgrade node

这行命令会把Node.js升级到Homebrew能提供的最新版本。

升级完再 node -v 验证一下，确认版本号 >= 22。

如果升级后版本还是不对（极少见情况），试试：

brew unlink node && brew link node --overwrite

两行命令，搞定。继续。

3.3 第三步：安装OpenClaw

好，重头戏来了。主角登场。

安装OpenClaw有两种方式：

方式一：官方一键脚本（推荐）

GPT plus 代充 只需 145

curl -fsSL https://clawd.org.cn/install.sh | bash

方式二：通过npm安装（备选）

npm install -g openclaw-cn@latest

我推荐方式一。这是官方中文社区维护的安装脚本，一行命令搞定所有依赖配置，路径、权限、环境变量全部自动处理好，出了问题也容易定位。

方式二的npm安装适合已经熟悉Node.js生态的用户。如果你是第一次接触，直接用方式一。

回车后脚本会自动运行，你会看到终端里刷出安装进度。

老规矩：黄色WARN不用管，只有红色ERROR才需要处理（准备篇讲过的）。

安装完成后（通常1-3分钟），验证一下：

GPT plus 代充 只需 145

openclaw-cn --version

如果看到版本号，比如 openclaw-cn/2026.2.23 或类似的，你已经成功在Mac上安装了OpenClaw主程序。

进度：3/5，主角登场了。最难的部分已经过了。

一行命令、验版本，两步。说实话，很多人想象中的"安装部署"是一座大山，走到这才发现——也就两级台阶。

常见问题：报EACCES权限错误？

报错长这样：Error: EACCES: permission denied

意思是：你没有权限往这个目录里装东西。

解决方案：在命令前面加 sudo（管理员权限运行）：

sudo curl -fsSL https://clawd.org.cn/install.sh | bash

sudo = "用管理员身份执行这个命令"。终端会让你输入密码（依然不显示字符），输完回车就行。

好，OpenClaw主程序装好了。

但它现在还是一个"空壳"，知道自己是OpenClaw，但不知道用哪个AI来思考、你的API Key是什么、该怎么跟你通信。

安装顺利的话，直接跳到第五章"通用配置篇"。如果遇到报错，先查阅下方3.4的常见问题排查。

3.4 Mac常见问题排查——4个最高频的坑

装的过程中遇到问题了？别慌。

我把Mac用户最常见的5个问题收集在这里。每10个找我求助的Mac用户里，有7个的问题都在这5个里面。

问题1：Homebrew安装卡住——一直显示Downloading不动

原因：GitHub服务器在国外，国内直连太慢。

解决：用国内镜像安装（前面已经给过了）：

GPT plus 代充 只需 145

/bin/zsh -c "$(curl-fsSLhttps://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

如果安装进行了一半卡住，按 Ctrl + C 中断当前操作，然后用上面的国内镜像命令重新安装。



问题2：安装脚本报EACCES权限错误

报错内容：Error: EACCES: permission denied

原因：当前用户没有权限往系统目录写入文件。

解决：在命令前加 sudo（管理员权限运行）：

sudo curl -fsSL https://clawd.org.cn/install.sh | bash

加 sudo 就是用管理员身份执行。输入Mac密码后回车（密码不显示是正常的）。

问题3：`node -v`显示版本低于22

原因：之前安装过旧版Node.js。

解决：

GPT plus 代充 只需 145

brew upgrade node

升级后再 node -v 验证。

如果升级后版本依然不对：

brew unlink node && brew link node --overwrite

如果还不行（极端情况）：

GPT plus 代充 只需 145

brew uninstall node && brew install node

完全卸载后重新安装。

问题4：网关启动报"端口被占用"

报错内容：Error: listen EADDRINUSE: address already in use :::18789

原因：18789端口已经被其他程序占用了。

解决：先查看谁占了这个端口：

lsof -i :18789

这行命令会显示占用该端口的进程名和PID（进程ID）。

然后杀掉该进程：

GPT plus 代充 只需 145

kill -9

把   替换成上面查到的数字。

杀掉后重新运行 openclaw-cn gateway --port 18789。

如果你不想杀进程，也可以在配置中修改OpenClaw的端口号：运行 openclaw-cn configure，在端口设置那一步输入一个不同的端口号（比如18790）。



好。Mac安装篇全部结束。

接下来请跳到第五章"通用配置篇"，完成配置和首次运行。

如果你是Windows用户，请继续看下面的第四章。

Windows用户看这里。

首先，不要看上面的Mac部署篇。Mac和Windows的操作完全不同，命令不一样，工具不一样，踩的坑也不一样。如果你参照Mac的步骤在Windows上操作，你一定会出问题。

Windows确实比Mac多几个坑。这是事实。但这些坑全在我的掌控之中，我已经帮你把每个坑标好了位置，告诉你怎么跨过去。

跟着做就行。

4.1 第一步：安装Node.js

Windows安装Node.js不需要Homebrew，直接从官网下载安装包，双击安装。

跟你平时装、装微信、装钉钉完全一样的流程。

Step 1：下载安装包

打开浏览器，访问：https://nodejs.org/en/download

在页面上找到 "Windows Installer (.msi)"。

选择 64-bit 版本，现在的电脑基本都是64位的，你不需要特意确认。

确保版本号 >= 22。页面上应该会显示类似"v22.14.0 LTS"这样的字样。LTS是"长期支持版"的意思，适合我们用。

点击下载。文件大概100MB左右。

Step 2：运行安装包

下载完成后，找到那个 .msi 文件（通常在"下载"文件夹里），双击运行。

安装向导会弹出来。

接下来基本就是一路Next，但有一个极其关键的地方你必须注意。

我拆开每一步给你看：

1. Welcome页面：点 Next

2. License Agreement（许可协议）：勾选"I accept"，点 Next

3. Destination Folder（安装路径）：保持默认（C:Program Files odejs），点 Next

4. Custom Setup（自定义设置）：

在这个页面上，你会看到几个可选的组件。

确保 "Add to PATH" 这个选项是被勾选的（或者显示为"Will be installed on local hard drive"）。没有这个勾，后面全白装。

"Add to PATH"是什么意思？

简单说，它让Windows知道 node 和 npm 这两个命令在哪里。有了它，你在PowerShell里输入 node，系统能找到对应的程序。没有它，系统会告诉你"'node'不是内部或外部命令"。

一定要勾选。一定要勾选。一定要勾选。

重要的事情说三遍。

5. 继续 Next → Install（可能需要确认管理员权限）→ Finish

安装完成。

Step 3：验证安装

按 Win + R（同时按住Windows键和R键），弹出"运行"对话框。

输入 powershell，回车。

PowerShell窗口打开了。

在PowerShell里输入：

node -v

如果看到 v22.x.x 或更高的版本号，Node.js安装成功。

再验证npm：

GPT plus 代充 只需 145

npm -v

看到版本号就行。

如果提示"'node'不是内部或外部命令，也不是可运行的程序"，说明PATH没有正确配置。最快的解决方案：

1. 打开"控制面板 → 程序和功能"，找到Node.js，卸载

2. 重新下载安装包，重新安装

3. 安装时仔细确认"Add to PATH"已勾选

卸载重装是最干净的办法。不要试图手动改PATH，容易改出新问题。

好，Node.js搞定了。跟装微信一样，下载、双击、一路Next。Windows的安装体验在这一步反而比Mac还省心。

4.2 第二步：安装OpenClaw

Node.js装好后，直接安装OpenClaw。

Windows的安装方式和Mac不同，用的是官方提供的PowerShell脚本，一行命令搞定。

极其重要，请以管理员身份打开PowerShell。

方法：在Windows左下角的搜索栏里搜索"PowerShell"，然后右键点击搜索结果，选择"以管理员身份运行"。

打开后，窗口标题栏会显示"管理员: Windows PowerShell"，确认一下是管理员模式。

在PowerShell里输入：

iwr -useb https://clawd.org.cn/install.ps1|iex

拆解给你听：

- iwr → Invoke-WebRequest 的缩写，意思是：从这个URL下载内容

- -useb → 使用基本解析（Use Basic Parsing），兼容性更好

- | iex → 把下载的内容直接执行（Invoke-Expression）

说白了，就是从官方服务器下载安装脚本，然后立刻执行。跟Mac那边的 curl | bash 是同样的逻辑，只是Windows用的是PowerShell语法。

回车后等待。过程中看到黄色WARN不用管，只有红色ERROR才需要处理。

如果一切顺利，1-3分钟后安装就完成了。

4.3 验证安装

安装脚本跑完后，验证一下：

GPT plus 代充 只需 145

openclaw-cn --version

如果看到版本号，你已经成功在Windows上安装了OpenClaw。



如果你遇到了ExecutionPolicy报错：

报错可能长这样：无法加载文件 xxxxxxx，因为在此系统上禁止运行脚本。

或者英文：cannot be loaded because running scripts is disabled on this system

微软的安全策略，设计得像给你家大门上了三把锁，钥匙塞在锁孔里，你就是不知道转哪把。

解决方案，在PowerShell（管理员模式）里执行：

Set-ExecutionPolicy -ScopeCurrentUser -ExecutionPolicy RemoteSigned

这行命令把当前用户的脚本执行策略改为"RemoteSigned"，允许运行本地脚本和来自互联网的已签名脚本。

这是一个安全的设置，微软官方文档中也推荐这个策略。它只影响你当前用户，不影响系统其他用户。

执行后它可能会问你"确定要更改吗？"，输入 Y，回车。

然后重新执行安装命令：

GPT plus 代充 只需 145

iwr -useb https://clawd.org.cn/install.ps1|iex



Windows的坑确实比Mac多，但你全趟过来了。

能在Windows上把这一套跑通的人，说明动手能力已经超过了九成来问我私信的读者。真的。

接下来，跳到第五章"通用配置篇"，完成配置向导和首次运行。

4.4 Windows常见问题排查——4个最高频的坑

问题1：ExecutionPolicy报错——禁止运行脚本

前面已经讲过了。解决：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

输入Y确认。然后重新执行安装脚本：

GPT plus 代充 只需 145

iwr -useb https://clawd.org.cn/install.ps1|iex

问题2：`openclaw-cn` 命令找不到

报错：'openclaw-cn' 不是内部或外部命令

原因：安装脚本完成后，当前PowerShell窗口还没有刷新环境变量。

解决：关掉当前PowerShell，以管理员身份重新打开一个新的窗口，再执行 openclaw-cn --version 验证。

问题3：端口18789被占用

查看占用端口的进程：

netstat -ano | findstr 18789

最右边那一列是PID（进程ID）。

杀掉该进程：

GPT plus 代充 只需 145

taskkill /PID /F

把   替换成查到的数字。/F 表示强制终止。

然后重新运行 openclaw-cn gateway --port 18789。

问题4：防火墙拦截——WebUI打不开

浏览器访问 127.0.0.1:18789 但页面加载不出来。

大概率是防火墙把Node.js的网络通信拦截了。

解决：

1. 打开"控制面板 → Windows Defender防火墙 → 允许应用通过防火墙"

2. 点击"更改设置"

3. 找到列表中的Node.js

4. 勾选"专用"和"公用"两个复选框

5. 确定

如果列表里找不到Node.js，点击"允许其他应用"，手动添加 C:Program Files odejs ode.exe。



好。Windows安装篇全部结束。

接下来请跳到第五章"通用配置篇"。

不管你是Mac用户还是Windows用户，走到这一步，说明你已经成功安装了OpenClaw主程序。

接下来的配置和启动步骤，Mac和Windows完全一样。

5.1 运行配置向导

在终端（Mac）或PowerShell（Windows，管理员模式）输入：

openclaw-cn onboard --install-daemon

这行在干什么？openclaw-cn onboard 启动初始化配置向导（onboard = "入职引导"，就像新员工入职培训）；--install-daemon 顺便把守护进程装上（让OpenClaw能在后台持续运行）。

回车后，配置向导就启动了。

它不是一下子让你填完所有东西，而是一步一步问你问题，你根据我下面的指引逐步回答就行。

如果某一步你不确定选什么，选默认的。默认值是开发团队推荐的配置，适合大多数人。后面随时可以改。

我把每一步都详细拆开讲：

向导第1步：选择工作区路径

配置向导首先会问你：把OpenClaw的数据（配置文件、聊天记录、技能等）存在哪个目录里？

它会给你一个默认路径，直接回车，用默认就行。

除非你有特殊需求（比如想把数据放在外接硬盘上），否则不需要改。

回车，进入下一步。

向导第2步：选择AI模型提供商

这一步非常关键，它决定了你的OpenClaw用哪个"大脑"来思考。

向导会给你列出一堆选项：

- Anthropic（Claude系列，效果最好，但需要代理+付费）

- OpenAI（GPT系列，老牌选手，需要代理+付费）

- DashScope/阿里云（通义千问，国内常用，免费额度充足）

- Moonshot（Kimi，国内替代方案，长文本很强）

- MiniMax（国内模型，Coding Plan 专为高频调用设计，单价低、用量足）

- Google（Gemini，需要代理）

- Cloudflare AI

- Z.AI

- 其他

选项很多，别懵。

如果你是国内用户，我只推荐一个选择：MiniMax（Coding Plan）。

为什么？三个原因：

1. OpenClaw 是 Agent，Token 消耗远大于普通聊天，Coding Plan 是专为开发者/高频调用场景定价的套餐，单价低、用量足，日常跑任务基本够用，不像按需计费那样动不动就心疼

2. 不需要代理/翻墙，国内网络直连，响应速度很快

3. 效果足够好，日常对话、任务执行、文件处理都没问题，模型持续在迭代升级

Claude效果确实更好，但你得先有代理，还得付费，而且 Agent 模式下 Claude 的调用费用会相当高。在你对OpenClaw还不够熟悉的阶段，先用性价比高的跑起来，比什么都重要。

等你用了一段时间，觉得 MiniMax 满足不了你了，再换 Claude 也来得及。

用方向键上下选择"MiniMax"相关的选项，然后回车。

向导第3步：输入API Key

好，到了最让人紧张的一步——输入API Key。

"我还没有API Key啊！"

别急。跟着下面的步骤，5分钟就能搞到。

【MiniMax Coding Plan API Key获取完整教程——手把手级别】

Step 1：打开浏览器（Safari/Chrome/Edge都行），在地址栏输入：

GPT plus 代充 只需 145

https://platform.minimaxi.com/

这是MiniMax的开发者平台，也是获取和管理API Key的地方。

Step 2：如果你没有MiniMax账号，点击页面右上角的"注册"按钮。

注册方式很简单，手机号 + 验证码，完成实名认证后即可使用。整个流程不超过3分钟。

Step 3：登录后，在页面左侧菜单找到"API Keys"入口（或点击右上角头像 → 账号设置 → API Keys）。

点击进入。

Step 4：点击页面上的"创建新的 API Key"或"+ 新建"按钮。

在弹出的对话框里给这个 Key 取个名字（比如"OpenClaw"），方便你以后认出它是干嘛用的，然后点击确认。

关于 Coding Plan： MiniMax 面向开发者推出的 Coding Plan 套餐，专为 Agent 这类高频调用场景设计，相比按需计费单价更低、用量更足。OpenClaw 每次执行任务要来回调用好几轮模型，用 Coding Plan 跑日常任务基本够用，不会动不动就超额。进入控制台后可以在"用量与计费"页面查看实时消耗。

Step 5：系统会生成一串类似这样的字符串：

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

这串字符就是你的API Key。你的"会员卡号"。

极其重要的两件事：

1. 这个Key只会完整显示一次。 页面关掉后你就再也看不到了（只能看到最后几位）。所以，现在立刻复制下来，粘贴到一个安全的地方。备忘录、记事本、密码管理器都行。

2. 永远不要把API Key发给别人、贴到朋友圈、发到群里。 它就像你的银行卡密码，别人拿到了就能用你的额度。如果你怀疑Key泄露了，立刻回到MiniMax平台删掉它并创建一个新的。

好，Key拿到手了。

回到终端的配置向导，它正在等你输入API Key。

在终端里粘贴Key：

- Mac终端的粘贴快捷键：Command + V

- Windows PowerShell的粘贴方式：右键单击窗口（传统方式）或 Ctrl + V（较新版本支持）

粘贴后你可能看不到完整的Key内容（出于安全考虑，终端不会显示你输入的敏感信息）。这是正常的。

直接按回车。

如果Key没问题，向导会自动进入下一步。

如果提示Key无效，检查一下是不是复制的时候多了空格或者少了字符。重新复制粘贴一次。

向导第4步：配置网关端口

它会问你：OpenClaw网关使用哪个端口？

默认是18789。直接回车。

端口就像门牌号，你家住在"18789号"，别的程序住在别的号。只要不跟其他程序冲突就行，而18789基本没人用。

向导第5步：通信通道配置

它会问你要不要配置聊天平台的接入（飞书、Telegram等）。

现在选"跳过（Skip）"。

我们先把OpenClaw本体跑通。聊天平台的接入放到后面第六章进阶篇再讲。

一步一步来。别贪多。一次想配太多东西，出了问题你都不知道是哪一步出的。

向导第6步：是否安装守护进程

它会问你：Install daemon? (Y/n)

输入Y，回车。

守护进程是什么？就像你手机上的微信后台运行，即使你没有打开微信App，微信也在后台跑着。有新消息了它能第一时间收到并推送给你。

OpenClaw的守护进程也是这样，安装后，OpenClaw会在后台持续运行。你不需要每次用的时候都手动启动它。

在Mac上，守护进程是通过系统自带的LaunchAgent实现的，非常轻量，几乎不占用CPU和内存。在Windows上，可能通过"计划任务（Task Scheduler）"或者"Windows服务"来实现。如果安装过程中提示需要额外确认，按提示操作。

如果守护进程安装失败了也没关系，最多每次用OpenClaw的时候手动运行 openclaw-cn gateway --port 18789。功能完全不受影响，只是少了"开机自启"的便利性。

向导第7步：确认配置摘要

最后，向导会给你显示一个配置摘要，你选了什么模型、工作区路径在哪、端口号是多少、守护进程是否安装。

过一眼确认没问题，然后回车。

当你看到"Configuration complete!"（配置完成）的提示——

深呼吸。配置向导跑完了。

你离"跟AI对话"这个终极目标，只剩最后一步了。

Windows用户注意——防火墙弹窗：

当你启动网关时（或者配置过程中），Windows防火墙很可能会弹出一个弹窗，问你是否允许Node.js通过网络通信。

点"允许访问"。

如果你手快点了"取消"，OpenClaw的网关可能无法正常工作（因为它需要在本地网络上监听端口）。

补救方法：打开"控制面板 → Windows Defender防火墙 → 允许应用通过防火墙"，找到Node.js相关的项目，勾选"专用网络"和"公用网络"。

5.2 首次运行——见证奇迹的时刻

好。

所有准备工作都完成了。

Node.js装了。OpenClaw装了。配置向导跑完了。API Key填好了。

现在，按下那个按钮，让引擎发动。

在终端/PowerShell输入：

GPT plus 代充 只需 145

openclaw-cn gateway --port 18789

这个你已经懂了：启动OpenClaw的网关服务，负责接待你发来的消息，把消息转发给AI大模型处理，再把AI的回复传回给你。--port 18789 是指定端口号，用默认值就行。

回车后，你会看到终端里刷出一堆日志信息。各种 INFO、时间戳、模块名之类的。

不用看懂。

只需要关注一个关键信息：当你看到类似以下的字样时——

Gateway is running on port 18789

或者

GPT plus 代充 只需 145

Server started at http://127.0.0.1:18789

这说明，OpenClaw已经在运行了。

不确定网关是否在跑？另开一个终端窗口，输入：

openclaw-cn gateway status

它会告诉你当前网关的运行状态。

现在，不要关闭终端窗口（关了的话网关就停了，除非你安装了守护进程）。

打开浏览器，或者直接输入命令：

GPT plus 代充 只需 145

openclaw-cn dashboard

它会自动打开浏览器并跳转到控制台。你也可以手动在地址栏输入：

http://127.0.0.1:18789/

127.0.0.1 就是"你自己的电脑"的意思。:18789 是端口号。

回车。

如果你看到了一个干净的聊天界面，一个输入框，等待你说第一句话——

现在，在输入框里打字：

GPT plus 代充 只需 145

你好，介绍一下你自己

回车。

等几秒钟……

AI回复了。它在跟你说话。它在向你介绍自己。

这不是一个网页上的聊天工具。这是一个跑在你自己电脑上的AI代理。

你的数据不会离开你的设备。 你的API Key只有你自己知道。你拥有完全的控制权。

你成功了。从复制粘贴第一行命令到这一刻，你完成了一件23万人给它点Star的事。

认真的。

你知道有多少人在Homebrew那一步就放弃了吗？有多少人在API Key那一步就懵了吗？有多少人折腾了一周最后放弃了吗？

但你没有。

你一行命令一行命令地敲过来了。每一个报错你都没有被吓跑。每一个陌生的概念你都耐心看完了。

从复制粘贴第一行命令，到听见AI第一句回复——这30分钟，你跨过了23万人给它点Star之前的那道门槛。

好，如果你想先休息一下，完全可以。OpenClaw已经跑起来了。如果你装了守护进程，关掉终端也没关系，下次直接运行 openclaw-cn dashboard 或手动打开浏览器访问 http://127.0.0.1:18789/ 就行。

5.3 配置和运行常见问题

问题：API Key配置了但对话没有回复 / 回复报错

可能原因1：API Key输错了

运行 openclaw-cn configure，重新输入Key。复制的时候注意不要多复制了空格或者换行符。

可能原因2：网络问题（如果用的是海外模型）

Claude、GPT等模型的API在国外，国内直连不通。要么配代理（后面进阶篇讲），要么换国内模型。

可能原因3：Token 用量超额了

登录MiniMax开发者平台（https://platform.minimaxi.com/），在"用量与计费"页面查看你的API调用量和剩余 Token 额度。OpenClaw 是 Agent，每次任务会多轮调用，消耗比普通聊天快——这正是推荐 Coding Plan 的原因，它的单价更低。

可能原因4：模型服务暂时不可用

偶尔MiniMax的服务会短暂波动。等几分钟重试，或者查看MiniMax官方状态页面确认服务是否正常。

如果以上都不是，运行 openclaw-cn doctor 让OpenClaw自我诊断一下，它会告诉你哪里出了问题。

OpenClaw装好了。能聊天了。能执行简单任务了。

但说实话，你现在只发挥了它不到20%的能力。

就像你买了一辆特斯拉，但只会用它代步，还没开过自动驾驶、没试过狂暴模式、没连过手机蓝牙。

接下来这一章，我带你把剩下的80%也解锁了。

6.1 切换AI模型——找到最适合你的"大脑"

你在配置向导里选了 MiniMax？很好。它够用。能完成大部分日常任务。

但OpenClaw支持十几个模型提供商。每个模型的风格、能力、价格都不一样。就像同一款手机可以插不同运营商的SIM卡，换模型就像换SIM卡，手机还是那个手机，但信号源变了，体验可能完全不同。

想换模型？很简单。在终端/PowerShell里输入：

openclaw-cn configure

这会重新启动配置向导。你可以选择新的模型提供商，输入新的API Key。其他配置不需要改。

主流模型提供商对比，帮你做选择：

我的推荐路径：

1. 起步阶段：MiniMax Coding Plan。OpenClaw 是 Agent，Token 消耗比普通聊天大，Coding Plan 专为高频调用定价，国内直连，跑日常任务基本够用、不心疼。

2. 进阶阶段：如果你有代理，换Claude试试。Claude在理解复杂任务和执行多步骤操作方面明显强于其他模型。OpenClaw 2026.2.23版本已经支持最新的Claude Opus 4.6。

3. 日常使用：可以根据任务类型切换，简单任务用MiniMax（省钱），复杂任务切Claude（效果好）。

各模型API Key获取地址汇总：

- MiniMax：https://platform.minimaxi.com/

- 通义千问：https://dashscope.console.aliyun.com/

- Kimi/Moonshot：https://platform.moonshot.cn/

- Claude：https://console.anthropic.com/

- OpenAI：https://platform.openai.com/

- Gemini：https://aistudio.google.com/

流程都差不多，注册账号、创建API Key、复制粘贴到OpenClaw里。

6.2 代理/网络配置——国内用户的特殊处理

如果你用的是国内模型（MiniMax、通义千问、Kimi等），这一节可以跳过。国内模型不需要代理。

如果你想用Claude、GPT、Gemini这些国外模型，你需要配置代理。

为什么？因为这些模型的API服务器在国外，国内网络直连不上。就像你用国内手机号打美国电话，不开国际漫游就打不通。

配置方式取决于你用的代理工具。大部分代理工具都会提供一个本地HTTP代理地址，通常长这样：http://127.0.0.1:7890（端口号可能是7890、1080、8080等，看你的工具设置）。

Mac设置方式：

GPT plus 代充 只需 145

export https_proxy=http://127.0.0.1:7890 export http_proxy=http://127.0.0.1:7890 export all_proxy=http://127.0.0.1:7890

Windows PowerShell设置方式：

$env:https_proxy="http://127.0.0.1:7890" $env:http_proxy="http://127.0.0.1:7890" $env:all_proxy="http://127.0.0.1:7890"

注意：7890 是你代理工具的端口号，不同工具不一样。打开你的代理工具设置页面，找到"HTTP代理端口"或"本地端口"那个数字，替换进去。

设置好后，运行 openclaw-cn gateway --port 18789。

另一个方案是在OpenClaw的配置文件中永久设置代理，这样你不用每次启动前都手动设环境变量。具体方法参考OpenClaw中文社区文档。



嫌麻烦？

确实麻烦。2026年了，用个API还得配代理，这体验约等于用传真机发邮件。代理配置是很多人放弃使用海外模型的原因。

我的建议：如果你不想折腾代理，直接用国内模型就完事了。

MiniMax Coding Plan 是专门为高频调用设计的套餐，单价低，跑 OpenClaw 这类 Agent 基本够用。Kimi在处理长文本方面甚至比很多国外模型还强。

别让代理成为你使用OpenClaw的拦路虎。先用起来。体验了OpenClaw的强大之后，你自然会有动力去折腾代理。

6.3 接入聊天平台——解锁真正的"随时随地"

前面你一直是通过浏览器的WebUI跟OpenClaw对话的。

这已经很不错了。

但OpenClaw的真正杀手锏是，你可以把它接入飞书、Telegram、Discord等聊天平台。

装好之后，你可以躺在沙发上，用手机上的飞书对它说"帮我整理桌面上的PDF"，它就真的去整理了。

不需要打开电脑。不需要打开浏览器。不需要坐在桌前。

你发一条飞书消息，OpenClaw在你电脑后台默默干活。干完了给你发一条消息："搞定了，文件已按日期归档到Documents/Archive/文件夹下。"

这才是数字管家应有的样子。

这里我重点讲飞书接入，国内用户最常用、OpenClaw支持最好的平台。

飞书接入分两部分：先在飞书开放平台创建应用（7步），再在OpenClaw里配置连接（5分钟）。全程跟着走，不需要任何开发经验。

第一部分：在飞书开放平台创建自建应用

Step 1：打开飞书开放平台

打开浏览器，访问：https://open.feishu.cn/app

用你的飞书账号登录（扫码或密码均可）。

Step 2：创建企业自建应用

登录后，点击右上角"创建应用"按钮，选择"企业自建应用"。

在弹出的表单里填写：

- 应用名称：随便取，比如"我的AI助手"或"OpenClaw"

- 应用描述：随便写几个字，比如"个人AI助手"

- 应用图标：可以跳过，默认图标就行

填完点"创建"，进入应用详情页面。

Step 3：获取App ID和App Secret

进入应用后，在左侧菜单找到"凭证与基础信息"，点击进入。

你会看到两个关键信息：

- App ID：格式是 cli_xxxxxxxxxxxxxx（以 cli_ 开头）

- App Secret：一串随机字符，默认隐藏，点击"查看"后复制

把这两个值复制下来存好，后面配置OpenClaw要用。

和API Key一样，App Secret属于机密信息，永远不要发给别人。

Step 4：配置权限

在左侧菜单点击"权限管理"。

这一步告诉飞书：你的机器人被允许做什么。

OpenClaw需要以下核心权限——点击"批量申请权限"，搜索并勾选：

GPT plus 代充 只需 145

{  "scopes": {    "tenant": [      "aily:file:read",      "aily:file:write",      "application:application.app_message_stats.overview:readonly",      "application:application:self_manage",      "application:bot.menu:write",      "cardkit:card:write",      "contact:contact.base:readonly",      "contact:user.employee_id:readonly",      "corehr:file:download",      "docs:document.content:read",      "event:ip_list",      "im:chat",      "im:chat.access_event.bot_p2p_chat:read",      "im:chat.members:bot_access",      "im:message",      "im:message.group_at_msg:readonly",      "im:message.group_msg",      "im:message.p2p_msg:readonly",      "im:message:readonly",      "im:message:send_as_bot",      "im:resource",      "sheets:spreadsheet",      "wiki:wiki:readonly"    ],    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]  }}

勾选后提交。

个人飞书账号的权限通常会立即生效。企业账号可能需要管理员审批，提交后等通知即可。

Step 5：启用机器人能力

在左侧菜单找到"应用能力"，点击进入，找到"机器人"这一项，点击"启用机器人"。

启用后，你可以给机器人设置一个显示名称，这会在飞书聊天界面显示为机器人的昵称。

第二部分（插在这里）：先在OpenClaw中配置飞书渠道并启动网关

⚠️ 顺序很重要！在飞书开放平台配置事件订阅（Step 6）之前，必须先完成以下两步：1. 在OpenClaw里添加飞书渠道2. 确认OpenClaw网关正在运行如果网关没跑起来，飞书的长连接设置会保存失败，机器人永远收不到消息。

方式一：通过配置向导（推荐）

在终端（Mac）或PowerShell（Windows）输入：

openclaw-cn channelsadd

或者重新运行配置向导：

GPT plus 代充 只需 145

openclaw-cn onboard

向导会一步步引导你：选择平台（选"飞书"）→ 输入 App ID → 输入 App Secret。填完就行。

方式二：直接编辑配置文件

如果你更喜欢手动操作，也可以直接编辑配置文件。

配置文件路径：~/.openclaw/openclaw.json

用文本编辑器打开（Mac用TextEdit，Windows用记事本），在 channels 里加入以下内容：

{"channels": {"feishu": {"enabled": true,"dmPolicy": "pairing","accounts": {"main": {"appId": "cli_你的AppID","appSecret": "你的AppSecret","botName": "我的AI助手"        }      }    }  }}

把 cli_你的AppID 和 你的AppSecret 替换成 Step 3 里复制的实际值，botName 填机器人名字，保存文件。

启动网关，确认运行状态

保存配置后，启动（或重启）OpenClaw网关：

GPT plus 代充 只需 145

openclaw-cn gateway --port 18789

验证网关正在运行：

openclaw-cn gateway status

看到"running"状态，说明OpenClaw已经就位。确认运行后，回到飞书开放平台继续 Step 6。

Step 6（回到飞书）：配置事件订阅

在左侧菜单点击"事件订阅"。

接收事件的方式，选"使用长连接接收事件"（WebSocket模式）。

为什么是长连接，不是URL回调？

URL回调需要你有一个公网IP或域名，本地部署的机器基本没有这个条件。长连接是OpenClaw主动去飞书服务器拉消息，不需要公网IP，在家里或公司网络下都能用。对于本地部署，选长连接就对了。

选好之后，在下方"添加事件"里搜索并添加：

GPT plus 代充 只需 145

im.message.receive_v1

这个事件的作用是：每当你给机器人发消息，飞书就会通知OpenClaw来处理。

保存后，飞书会和你本地正在运行的OpenClaw网关建立长连接，确认连通。这也是刚才必须先把网关跑起来的原因。

Step 7：发布应用

在左侧菜单点击"版本管理与发布"。

点"创建版本"，填写版本号（比如 1.0.0）和版本说明（随便写），然后点"申请发布"。

应用不发布，机器人就在飞书里搜索不到。这一步不能跳过。

个人飞书账号通常无需审核，直接发布即可。企业账号需要管理员审批，提交后等通过就行。



两边都配置完毕。

验证：发送第一条消息

打开飞书（App或网页版），在搜索栏里搜索你在 Step 2 填的应用名称。

找到机器人，发一条消息：

你好

机器人回复了吗？

恭喜，飞书接入成功。你现在可以躺在沙发上用手机发指令，让OpenClaw在电脑后台默默干活了。

进阶：访问控制配置

默认情况下，第一次给机器人发消息的用户需要"配对"才能使用，这是安全机制，防止别人乱用你的机器人（毕竟API消耗是你的）。

查看待批准的配对请求：

GPT plus 代充 只需 145

openclaw-cn pairing list feishu

批准某个用户：

openclaw-cn pairing approve feishu <配对码>

如果是完全自用，嫌每次审批麻烦，可以把配置文件里的 dmPolicy 改成 "open"。如果想限制只有特定人能用，改成 "allowlist"。

飞书接入常见问题

问题1：机器人收不到我的消息

按顺序检查这5点：

1. 应用有没有发布？（Step 7）没发布的应用，机器人不会响应任何消息。

2. 事件订阅里有没有配置 im.message.receive_v1？（Step 6）

3. 接收方式是不是选的"长连接"，不是URL回调？（Step 6）

4. im:message 权限有没有通过审核？（Step 4）

5. OpenClaw网关有没有在运行？运行 openclaw-cn gateway status 检查。

5项都没问题？再跑一下诊断：

GPT plus 代充 只需 145

openclaw-cn logs --follow

看实时日志，找红色ERROR信息。

问题2：在群里@机器人没反应

群组消息需要额外的权限 im:message.group_msg（Step 4 里提到的敏感权限）。去飞书开放平台 → 权限管理，添加这个权限。

另外，群组里默认需要@机器人才触发响应（@你的机器人名字 + 消息内容）。如果群组里希望不@也能响应，参考官方文档的 requireMention: false 配置。

问题3：App Secret泄露了怎么办

立刻去飞书开放平台，进入你的应用 → 凭证与基础信息 → 重置App Secret。

重置后旧Secret立刻失效，新Secret立刻生效。

然后更新OpenClaw配置文件里的 appSecret，重启网关。

问题4：发消息失败，提示权限不足

检查 im:message:send_as_bot 权限是否已申请通过（Step 4）。这是机器人发送消息的必要权限，缺了就只能收不能回。

除了飞书，OpenClaw还支持20多个聊天平台。列几个常用的：

- 国内：飞书、钉钉、企业微信

- 国际：Telegram、Discord、Slack、WhatsApp

- Apple生态：iMessage

- 其他：Line、Matrix、Signal、Messenger等

每个平台的接入方式类似，安装对应的插件 → 在平台方创建应用/机器人 → 获取Token → 配置到OpenClaw → 完成。

6.4 技能（Skills）扩展——让OpenClaw学会新本事

OpenClaw还有一个非常酷的机制，Skills（技能）。

Skills是预制的能力包。安装一个Skill，OpenClaw就多学会一项新技能。

就像你的手机出厂只有打电话发短信的功能，但通过安装App你可以让它变成导航仪、计算器、相机、音乐播放器。

OpenClaw出厂只有基础对话能力。通过安装Skills，你可以让它学会浏览网页、定时执行任务、对接外部API、控制智能家居等等。

内置Skills（安装OpenClaw后自带的）：

- 浏览器控制：让OpenClaw能打开网页、搜索信息、提取网页内容

- 定时任务：设置"每天早上8点帮我查新闻"之类的自动化任务

- Webhooks：接收来自外部系统的事件通知，触发相应操作

社区Skills：

OpenClaw有一个社区Skills市场，有点像App Store但是给AI用的。全球开发者在上面分享自己制作的Skills。

数据说话，截至目前，已经有1.6万+个Expert Agent（专家代理）被创建。社区的活跃度相当高。

安装一个社区Skill的命令类似：

openclaw-cn skill sinstall

比如想安装一个能帮你管理日程的Skill：

GPT plus 代充 只需 145

openclaw-cn skills install @community/calendar-manager

你配置好一个Skill，比如"每天下午5点帮我汇总今日邮件并写一份摘要"，它就会每天准时执行。你不需要每次都手动告诉它。

一次配置，永久复用。这就是自动化的魅力。

OpenClaw有三样核心本事——记得住你（持久化记忆）、看得懂图片和文件（多模态交互）、学得会新技能（Skills扩展）。Skills是第三样，也是OpenClaw从"能用"到"玩出花"的关键。

OpenClaw装好了，进阶功能也了解了。

现在给你3个实用技巧，让你的OpenClaw用起来更顺手、更高效。

技巧1：开启持久化记忆——让它越用越懂你

默认情况下，OpenClaw每次新开对话都是"失忆"的，它不记得你叫什么名字、做什么工作、有什么偏好。每次都得重新介绍自己。

开启持久化记忆后，它会记住你。

你告诉它"我是做产品经理的，平时写PRD比较多"，下次你说"帮我写个需求文档"，它会直接用PRD的格式来写，不需要你再解释。

你告诉它"我喜欢简洁的回复风格，不要啰嗦"，以后它的回复就会变得精炼。

配置方式：在WebUI的设置页面中找到"Memory"或"记忆"相关的选项，开启即可。

或者直接在对话中告诉它："请记住我是XXX，我的偏好是XXX。"开启持久化记忆后，它就真的记住了。

技巧2：常用命令备忘——建议存到手机备忘录

把下面这几个命令存起来。日常使用中你会经常用到。

其中 openclaw-cn doctor 特别有用。OpenClaw出了任何问题，先跑一下doctor。它会自动检查你的配置文件、网络连接、模型状态、依赖版本等，然后告诉你哪里有问题、怎么修。

就像去医院之前先做个体检，省时省力。

技巧3：保持更新——一行命令，永远最新

OpenClaw更新非常频繁。

给你几个时间点感受一下：

- 2026.2.17版本：深度集成Sonnet 4.6模型，支持1M超长上下文

- 2026.2.21版本：新增Gemini 3.1支持

- 2026.2.23版本：新增Claude Opus 4.6支持，安全性大幅提升

基本每周都有新版本。新功能、Bug修复、安全更新、新模型支持，全在里面。

更新方法：重新执行一次官方安装脚本就行，它会自动覆盖升级到最新版。

Mac/Linux：

curl -fsSL https://clawd.org.cn/install.sh | bash

Windows：

GPT plus 代充 只需 145

iwr -useb https://clawd.org.cn/install.ps1|iex

就像你手机上点一下"系统更新"一样，脚本会自动识别你已安装的版本并升级，不需要手动卸载。

建议每1-2周更新一次。保持最新版本才能用到最新的功能、最好的模型支持和最及时的安全补丁。

OpenClaw能帮你做什么——3个我亲测的使用场景

最后，给你看3个我自己亲测过的使用场景，让你更直观地感受到OpenClaw不只是"能聊天"。

场景1：147个文件，3分钟归档

上周我桌面堆了147个文件，各种PDF、截图、文档混在一起。我以前都是手动整理，每次花半小时以上。

这次我对OpenClaw说了一句："帮我把桌面上的文件按类型分类归档到Documents/Archive下面，PDF放一个文件夹，图片放一个，文档放一个。"

3分钟后，它告诉我："已完成。PDF 43个归入Archive/PDF/，图片67个归入Archive/Images/，Word/Excel 28个归入Archive/Documents/，其余9个归入Archive/Other/。"

我打开文件夹确认了一下，分类准确率100%。以前半小时的活，3分钟搞定。

场景2：英文论文速读，含翻车

我把一篇24页的英文论文丢给它，说："用中文给我写一个500字的结构化摘要，重点讲方法论和主要结论。"

2分钟后，摘要出来了。结构清晰，核心观点都抓到了。

但说实话，第一次它漏掉了论文里一个重要的实验对比数据。我追问了一句"论文里Table 3的实验对比结果呢？"它补充了，这次完整了。

所以我的经验是：AI生成的摘要拿来做初筛非常好，但关键数据你最好自己再核实一遍。

场景3：定时新闻推送

配合定时任务Skills，我设置了："每天早上8点，帮我汇总今日AI圈的重要新闻，写成5条摘要，发到我的飞书上。"

从此以后，每天早上我打开飞书，就有一份热乎的AI新闻摘要等着我。用了两周了，漏发过一次（那天通义千问的API短暂抽风），其余都准时到达。

你的专属AI新闻编辑，准时上岗。



看到了吗？

文件整理、论文速读、定时推送，这些事情，以前要么得你自己动手，要么得找人帮忙。

现在，一句话的事。

我统计了一下，OpenClaw的GitHub Issue里，排名前10的问题全是安装相关的，占了所有Issue的七成。也就是说，你今天花30分钟搞定安装这件事，就已经跨过了七成人迈不过去的那道坎。

这哪是工具？这是你的专属数字管家。你睡觉它还在线，你度假它还在岗。

而你，已经拥有了它。

后续资源

走到这一步的你，已经是一个合格的OpenClaw用户了。

我把你接下来可能需要的资源整理在这里：

官方文档：

- OpenClaw中文社区入门指南：https://clawd.org.cn/start/getting-started.html

- OpenClaw中文社区配置向导：https://clawd.org.cn/start/wizard.html

- OpenClaw GitHub仓库：https://github.com/openclaw/openclaw

- 中文版GitHub文档：https://github.com/jiulingyun/clawdbot-chinese

推荐教程：

- 飞书保姆级对接指南：https://www.cnblogs.com/catchadmin/p/

- Windows部署全攻略补充：https://www.cnblogs.com/fxio/p/

- 云部署 vs 本地部署对比：https://new..com/rain/a/A01RCI00

懒人方案（不想自己装的看这里）：

MiniMax上线了MaxClaw，把OpenClaw搬进了网页端，开箱即用，不需要安装任何东西。阿里云和腾讯云也推出了一键部署方案。适合"我不想折腾，只想用"的朋友，但是还是需要自己配置 Skills。

对了，部署过程中遇到问题的、或者压根不想自己折腾的，可以链接我，一起讨论讨论——我自己搭了一套开箱即用的方案，服务器、API、Skills和Agent系统全帮你弄好，一起配置一下就能直接用，也许能帮你省个一两周



写这篇教程，花了整整一周。每一个报错，都是我自己或读者真实踩过的坑。每一个解决方案，都验证过确实有效。

说实话，最让我感触的不是技术层面的东西。

是那几百条私信背后的人。

有退休的阿姨，想跟AI聊聊天，被"Node.js""API Key"这些名词吓退了。

有在三四线城市做老师的朋友，想用AI帮学生批改作业，但身边没有一个人能教他怎么装。

他们不笨。他们只是，不在"技术圈"里。

技术的最大壁垒，从来不是技术本身。是那些写教程的人，忘了什么叫从零开始。

AI本应是所有人的工具。



顺便说个小彩蛋。OpenClaw的前身叫Clawdbot，因为商标太像Claude被Anthropic告了，被迫改名。先改成Moltbot，又不行。最后改成了现在的OpenClaw。改了两次名才活下来，这项目命也是够硬的。

而这个"Open"——

不只是开源。更是打开。

打开一扇门，让每个人都能拥有自己的AI助手。

今天你就可以，花30分钟把OpenClaw装好。

当你第一次在手机上给它发消息，它真的在你电脑上执行了任务的那一瞬间。

你就会懂。

为什么23万人给它点了Star。

不是因为它的代码有多优雅。

不是因为它的架构有多先进。

是因为——

它让每一个普通人，都拥有了一个24小时待命的数字助手。

你不需要是程序员。

你不需要懂JavaScript。

你不需要懂Docker。

你不需要懂服务器。

你只需要，会打字。

然后告诉它，你需要什么帮助。

它就会去做。



从0到1！大模型(LLM)最全学习路线图，建议收藏！

想入门大模型(LLM)却不知道从哪开始? 我根据最新的技术栈和我自己的经历&理解，帮大家整理了一份LLM学习路线图，涵盖从理论基础到落地应用的全流程!拒绝焦虑，按图索骥~~

因篇幅有限，仅展示部分资料，需要点击下方链接即可前往获取

因篇幅有限，仅展示部分资料，需要点击下方链接即可前往获取

因篇幅有限，仅展示部分资料，需要点击下方链接即可前往获取

因篇幅有限，仅展示部分资料，需要点击下方链接即可前往获取

因篇幅有限，仅展示部分资料，需要点击下方链接即可前往获取

因篇幅有限，仅展示部分资料，需要点击下方链接即可前往获取

因篇幅有限，仅展示部分资料，需要点击下方链接即可前往获取