liyupi
3c34dc6bf8
新增 07 OpenClaw 保姆级安装教程，涵盖安装配置、接入 QQ 对话、卸载等完整流程。 同步更新 00/06/08/09 等关联文章的衔接引用，确保教程体系连贯。 Made-with: Cursor
508 lines
21 KiB
Markdown
508 lines
21 KiB
Markdown
# OpenClaw 保姆级安装教程
|
||
|
||
> OpenClaw 安装 + 接入 QQ 对话，傻瓜式教程
|
||
|
||
|
||
|
||
你好，我是鱼皮。
|
||
|
||
在前面的文章中，我们学习了 AI 代码编辑器、命令行编程工具、IDE 插件等各种 AI 编程工具。这些工具的定位都是帮你写代码、做项目，但有一类工具更特殊 —— 它不只是编程助手，而是一个能操作你电脑的 AI 数字员工。
|
||
|
||
最近特别流行养龙虾，不是真的龙虾，而是一个叫 OpenClaw 的 AI 智能助手。
|
||
|
||
|
||
|
||
你可以把它理解成一个住在你电脑里的 AI 员工，它不像普通的 AI 聊天机器人只能动嘴皮子，而是真的能帮你干活，读写文件、操作浏览器、执行命令、甚至搭建网站，通通不在话下。
|
||
|
||
|
||
|
||
OpenClaw 的火爆程度远超我的想象，从 2025 年 11 月上线，仅用了大约 120 天就登顶 GitHub 星标 **历史第一**，累计拿下 29 万+ Stars，超过了 Linux、React 等一众前辈！
|
||
|
||
|
||
|
||
本来以为只是个技术圈的玩意儿，结果竟然火出圈了！
|
||
|
||
国内出现了几百块的上门代装服务，你没听错，**上门帮你装一个开源软件，收费几百**。
|
||
|
||
|
||
|
||
更离谱的是，深圳腾讯大厦门口还搞了免费的线下 “装龙虾” 活动，近千人排队，四年级小学生、快 70 岁的老大爷都来了，场面跟老年人排队领鸡蛋似的。
|
||
|
||
|
||
|
||
但我总觉着吧，如果这玩意需要让别人操作你的电脑帮你安装，大概率你也不需要这玩意，装上后你也不会用。
|
||
|
||
实际上，在自己电脑上安装 OpenClaw 非常简单，鱼皮今天就提供一个《保姆级 OpenClaw 本地安装 + 接入 QQ 教程》，哪怕你完全没学过编程，只要跟着做，也能成功养虾 🦞~
|
||
|
||
建议收藏，我们开始。
|
||
|
||
⭐️ 推荐观看视频教程：https://www.bilibili.com/video/BV1D4wcz6EVV
|
||
|
||
> 注意，本文主要是照顾零基础的新手，不会讲解复杂的玩法。之前鱼皮已经分享过 [《OpenClaw 保姆级部署到云服务器的教程》](https://mp.weixin.qq.com/s/DZYc92rLzhX95L6OBEQUyQ)，以及 [《利用 OpenClaw 打造能在手机 QQ 上对话的 AI 伴侣》](https://mp.weixin.qq.com/s/GSwZE74o5-wq0_UOXL8AyA)，感兴趣的朋友可以按需学习。
|
||
|
||
|
||
|
||
## 开始前的准备
|
||
|
||
在安装之前，你只需要准备 2 样东西：
|
||
|
||
1. 10 分钟的时间
|
||
2. 一台能开机上网的电脑（Windows 就行，Mac 更好，有条件的话建议用虚拟机 / 备用机 / 云服务器，**一定要注意安全！！！**）
|
||
|
||
其他的，什么都不需要！
|
||
|
||
**不需要你会编程，不需要你有计算机基础，甚至不需要 1 分钱！**
|
||
|
||
|
||
|
||
## 安装教程大纲
|
||
|
||
整个安装过程分为 4 步：
|
||
|
||
1. 安装运行环境
|
||
2. 安装配置 OpenClaw
|
||
3. 接入 QQ 手机对话
|
||
4. 卸载
|
||
|
||
考虑到有些同学安装完 OpenClaw 后不知道怎么用、想要彻底清理掉，鱼皮连卸载都给大家讲解，够贴心吧？
|
||
|
||
|
||
|
||
## 一、安装运行环境
|
||
|
||
打开 [OpenClaw 官网](https://openclaw.ai/)，你会看到官方提供了一行命令来安装。
|
||
|
||
|
||
|
||
**如果你是 Mac / Linux 用户**，可以直接打开终端（按 `Command + 空格` 搜索 “终端” 打开），粘贴下面这行命令并回车：
|
||
|
||
```bash
|
||
curl -fsSL https://openclaw.ai/install.sh | bash
|
||
```
|
||
|
||
这行命令会自动帮你安装所有依赖和 OpenClaw 本体，一步到位，装完就可以直接跳到 **第二步 - 安装配置 OpenClaw**。
|
||
|
||
|
||
|
||
**但如果你是 Windows 用户，千万不要直接执行一行命令安装！失败率极高！！！**
|
||
|
||
鱼皮实测了多种安装方式，踩了不少坑，下面手把手带你走一遍 Windows 上最稳的安装方式。
|
||
|
||
|
||
|
||
### 1、安装 Node.js
|
||
|
||
首先，我们需要安装 Node.js。
|
||
|
||
什么是 Node.js？
|
||
|
||
你可以把它理解成 OpenClaw 的 “发动机”，OpenClaw 是用 JavaScript 语言写的，而 Node.js 就是让 JavaScript 在你电脑上跑起来的运行环境。没有它，OpenClaw 就启动不了。
|
||
|
||
打开 [Node.js 官网](https://nodejs.org/)，选择对应你操作系统的安装包，并执行下载。注意版本号 **至少选 22 以上**，低于这个版本就会逮虾失败。
|
||
|
||
|
||
|
||
下载完成后，运行安装包，什么都不用改，一路点击下一步就好：
|
||
|
||
|
||
|
||
安装 Node.js 成功后，会自动附带安装一个叫 npm 的工具，它是 Node.js 的应用商店，后面我们要用它来安装 OpenClaw。
|
||
|
||
|
||
|
||
### 2、安装 Git
|
||
|
||
接下来，安装 Git。
|
||
|
||
Git 是一个代码版本管理工具，OpenClaw 在安装过程中需要用它从网上下载一些依赖包。
|
||
|
||
你不需要学会怎么用 Git，只需要把它装上就行。
|
||
|
||
打开 [Git 官网](https://git-scm.com/downloads/win)，下载 Windows 版本的安装包：
|
||
|
||
|
||
|
||
同样，运行安装包，一路点击下一步，全都选择默认配置就好：
|
||
|
||
|
||
|
||
|
||
|
||
### 3、安装 OpenClaw
|
||
|
||
环境准备就绪，现在来安装 OpenClaw 本体。
|
||
|
||
首先，以管理员身份打开 PowerShell。PowerShell 是 Windows 自带的命令行工具，相当于 Mac / Linux 系统的终端。
|
||
|
||
在电脑的搜索栏中输入 "PowerShell"，右键选择 **以管理员身份运行**：
|
||
|
||
|
||
|
||
先试试官方提供的一键安装命令：
|
||
|
||
```bash
|
||
iwr -useb https://openclaw.ai/install.ps1 | iex
|
||
```
|
||
|
||
大概率你会跟鱼皮一样，直接报错，提示缺少执行脚本的权限：
|
||
|
||
|
||
|
||
没关系，执行下面这行命令，开启 PowerShell 的脚本执行权限：
|
||
|
||
```bash
|
||
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
|
||
```
|
||
|
||
如果弹出确认提示，输入 `A` 然后按回车即可。这行命令的作用是允许运行来自可信来源的脚本，类似手机上允许安装第三方应用。
|
||
|
||
|
||
|
||
然后重新执行一键安装命令，运气好的话能直接成功。但像我这种倒霉蛋子，安装过程中又报错了！
|
||
|
||
|
||
|
||
报错信息显示是 npm 安装失败，那我们手动输入 npm 命令来安装试试：
|
||
|
||
```bash
|
||
npm install -g openclaw
|
||
```
|
||
|
||
|
||
|
||
果不其然也报错了，因为一键安装脚本默认就是用 npm 来装的，根本原因一样。
|
||
|
||
|
||
|
||
别慌，其实换一个包管理工具就行，用 pnpm 来安装。
|
||
|
||
pnpm 和 npm 类似，也是一个软件商店，但它的兼容性更好、安装速度也更快。
|
||
|
||
先用 npm 全局安装 pnpm，输入命令：
|
||
|
||
```bash
|
||
npm install -g pnpm
|
||
```
|
||
|
||
安装完成后，检查一下 pnpm 的版本号，确认安装成功：
|
||
|
||
```bash
|
||
pnpm -v
|
||
```
|
||
|
||
|
||
|
||
然后执行 `pnpm setup`，这个命令会自动配置 pnpm 的全局安装路径，让你之后通过 pnpm 安装的工具能在任何地方直接使用：
|
||
|
||
|
||
|
||
注意！执行完 `pnpm setup` 后，**一定要关闭当前 PowerShell 窗口，重新以管理员身份打开一个新的**。 这是为了让刚才配置的环境变量生效。
|
||
|
||
在新的 PowerShell 窗口中，用 pnpm 来安装 OpenClaw：
|
||
|
||
```powershell
|
||
pnpm add -g openclaw@latest
|
||
```
|
||
|
||
|
||
|
||
等待一段时间后，安装成功！但你可能会看到一条提示，说忽略了一些包的构建脚本（Ignored build scripts）：
|
||
|
||
|
||
|
||
这是因为 pnpm 出于安全考虑，默认不会自动执行第三方包的构建脚本，需要你手动批准。
|
||
|
||
按照 OpenClaw 官方的指引，需要执行下面这条命令，来批准这些构建脚本：
|
||
|
||
```bash
|
||
pnpm approve-builds -g
|
||
```
|
||
|
||
|
||
|
||
不过执行这条命令可能会报错：
|
||
|
||
|
||
|
||
鱼皮在网上搜了一大圈解决方案，也没能解决这个问题，期待官方后续修复。但好消息是，**这行命令不执行也几乎不影响正常使用**，直接忽略就行。
|
||
|
||
最后，验证一下 OpenClaw 是否安装成功，执行：
|
||
|
||
```bash
|
||
openclaw -v
|
||
```
|
||
|
||
能够看到版本号，表示大功告成！
|
||
|
||
|
||
|
||
|
||
|
||
## 二、安装配置 OpenClaw
|
||
|
||
环境装好了，接下来进入 OpenClaw 的新手引导程序，定制你的小龙虾 🦞。
|
||
|
||
在 PowerShell（Windows 系统）或终端（Mac / Linux 系统）中执行下列命令：
|
||
|
||
```bash
|
||
openclaw onboard --install-daemon
|
||
```
|
||
|
||
`onboard` 就是新手引导的意思，`--install-daemon` 是指 “顺便把后台服务也装上”，让 OpenClaw 在后台持续运行，关掉终端也不会停。
|
||
|
||
执行后，会进入一个交互式引导程序，一步步带你完成配置。
|
||
|
||
|
||
|
||
首先会弹出一个使用协议，需要你确认同意。
|
||
|
||
|
||
|
||
这里提醒一下，OpenClaw 是一个能操作你电脑的 AI 工具，理论上它可以执行任何终端命令，包括删除文件之类的敏感操作。**所以建议有条件的话在虚拟机或备用机里玩耍**，避免误操作影响到重要数据。
|
||
|
||
确认没问题，就选 Yes 进入下一步。
|
||
|
||
|
||
|
||
### 1、选择安装模式
|
||
|
||
引导程序会问你选择 Quickstart（快速开始）还是 Manual（人工）。
|
||
|
||
建议新手直接选 Quickstart，它会帮你用默认配置快速搞定，人工模式适合有一定养虾经验的同学。
|
||
|
||
|
||
|
||
|
||
|
||
### 2、配置 AI 大模型
|
||
|
||
这是最重要的一步，你要告诉 OpenClaw 用哪个 AI 大模型来思考，也就是给龙虾选脑子。
|
||
|
||
引导程序会列出一些 AI 平台供你选择，比如 Anthropic（Claude）、OpenAI（GPT）、Qwen（通义千问）等。
|
||
|
||
鱼皮推荐新手选择 Qwen，因为它支持 OAuth 授权登录，会自动弹出网页让你扫码验证，不用手动去申请和填写 API Key，而且可以直接免费使用。缺点是调用太频繁可能会被限流，所以只适合快速上手体验。
|
||
|
||
|
||
|
||
选择 Qwen 后，引导程序会自动打开浏览器让你登录授权：
|
||
|
||
|
||
|
||
完成登录授权后，选择默认的编程大模型：
|
||
|
||
|
||
|
||
当然，你也可以选择其他大模型平台。如果你想了解各模型在 OpenClaw 场景下的实际表现，可以参考 [PinchBench](https://pinchbench.com/) 排行榜，这是一个专门测试大模型做 OpenClaw 任务的评测网站。目前成功率最高的是 Claude Opus 4.6（成功率 82.5%），最便宜的是 Google 的 gemini-2.5-flash-lite（每次任务只要 1 毛钱）。
|
||
|
||
|
||
|
||
不太建议新手一上来就用国外大模型来玩 OpenClaw，价格非常贵，尤其是你让 AI 干复杂的活时，Tokens 会烧得嘎嘎猛，要做好心理准备。国产的智谱、Kimi 也是不错的选择。
|
||
|
||
|
||
|
||
### 3、配置聊天渠道
|
||
|
||
引导程序会问你要不要连接 Telegram、WhatsApp、Discord、飞书等聊天平台，更方便地跟龙虾对话。
|
||
|
||
建议直接跳过，我们先用网页界面聊天就好，后面手动接入 QQ 其实更方便。
|
||
|
||
|
||
|
||
接下来还会问你要不要配置搜索服务提供者（比如 Brave Search），也建议先跳过，这些都需要额外申请 API Key，后面有需要再配：
|
||
|
||
|
||
|
||
|
||
|
||
### 4、安装 Skills 技能包
|
||
|
||
Skills 是给 AI 装的能力扩展包。OpenClaw 本身只是一个框架，装了 Skills 之后 AI 才能解锁各种具体的能力，比如搜索网页、操作浏览器、制作 PPT 等。
|
||
|
||
先开启技能配置：
|
||
|
||
|
||
|
||
然后引导程序会列出一些推荐的技能包，这里建议至少添加 **ClawHub** 这一个。ClawHub 是 OpenClaw 的官方技能市场，装了它之后，你的小龙虾就可以随时搜索和安装社区里上千个技能包，快速扩展自己的能力，非常方便。其他的技能按需选择即可。
|
||
|
||
|
||
|
||
选择完技能后，还要选择安装技能的工具，用 npm 就行：
|
||
|
||
|
||
|
||
之后还会询问一些额外服务的配置，比如是否要配置 AI 生图大模型等，新手直接无脑全部选 No：
|
||
|
||
|
||
|
||
|
||
|
||
### 5、启动网关服务
|
||
|
||
接下来会自动安装并启动 OpenClaw 的 Gateway 网关服务。你可以把网关理解成 OpenClaw 的总调度中心，它负责接收你从各个渠道（网页、QQ、飞书等）发来的消息，分配给 AI 处理，再把结果返回给你。
|
||
|
||
|
||
|
||
这时候 Windows 可能会弹出防火墙提示，问你是否允许公共网络和专用网络访问，**一定要点允许！** 否则网关服务无法正常工作。
|
||
|
||
|
||
|
||
启动成功后，引导程序会问你是在终端界面（TUI）还是网页浏览器中使用 OpenClaw。
|
||
|
||
TUI 就是直接在命令行里跟 AI 聊天，适合喜欢敲命令、有一定编程基础的同学。新手当然选 Web UI 网页中使用：
|
||
|
||
|
||
|
||
|
||
|
||
### 开始使用
|
||
|
||
选择之后，浏览器会自动打开 OpenClaw 的网页控制面板。恭喜，你的龙虾 1 号准备就绪！
|
||
|
||
先跟它打个招呼吧，问问它是谁。它还会主动引导你通过对话来设置身份、职责等个性化信息：
|
||
|
||
|
||
|
||
OpenClaw 内置了很多工具，比如文件读写、终端命令执行、网页搜索等。
|
||
|
||
试试让它帮你读取电脑上的文件，比如查看下载目录里有什么：
|
||
|
||
|
||
|
||
不过说实话，每次都要打开电脑上的网页控制面板才能跟 AI 对话，还是不够方便。所以接下来，我们要把 OpenClaw 接入 QQ 机器人，目标是能够随时随地用手机养虾~
|
||
|
||
|
||
|
||
## 三、接入 QQ 手机对话
|
||
|
||
以前想把 OpenClaw 接入 QQ，需要自己到 QQ 机器人开放平台申请、开白名单、获取密钥，还是有点儿麻烦的。
|
||
|
||
现在腾讯出手，专门为 OpenClaw 搞了一个快捷接入通道，几步就能搞定！
|
||
|
||
打开 [QQ 机器人 OpenClaw 接入页面](https://q.qq.com/qqbot/openclaw/index.html)，用 QQ 扫码登录：
|
||
|
||
> 指路：https://q.qq.com/qqbot/openclaw/index.html
|
||
|
||
|
||
|
||
点击「创建机器人」，直接秒出！
|
||
|
||
|
||
|
||
创建完成后，手机 QQ 立刻就会收到小龙虾打招呼的消息：
|
||
|
||
|
||
|
||
然后可以修改机器人的头像、昵称等信息，给你的龙虾起个好听的名字吧~
|
||
|
||
|
||
|
||
接下来是最关键的一步。页面上会显示三条配置命令，你只需要 **依次复制这 3 条命令到终端（PowerShell）中执行** 就可以了。
|
||
|
||
注意命令中包含你的密钥信息，不要泄露给别人！
|
||
|
||
|
||
|
||
到终端中依次执行命令：
|
||
|
||
|
||
|
||
接入成功后，你可以在 OpenClaw 的网页控制台的「频道」（Channels）板块看到已经接入了 QQ 机器人渠道：
|
||
|
||
|
||
|
||
现在，掏出手机试试吧！
|
||
|
||
直接在 QQ 上给小龙虾发消息下达任务，比如让它查看电脑配置、或者帮你写一篇文章。完成速度很快，而且支持 Markdown 格式输出，阅读体验不错：
|
||
|
||
|
||
|
||
如果你好奇它背后做了些什么，可以在 OpenClaw 的网页控制台中查看跟 QQ 机器人的完整对话记录。接入 QQ 机器人频道后，OpenClaw 能够理解怎么通过 QQ 发送图片、语音等内容：
|
||
|
||
|
||
|
||
除了基本对话和操作电脑之外，你还可以探索更多玩法。比如看鱼皮之前写的 [《GLM-5 + OpenClaw：打造你的 AI 伴侣》](https://mp.weixin.qq.com/s/GSwZE74o5-wq0_UOXL8AyA)，教你打造一个能发图片、发语音、甚至帮你干活的 AI 伴侣。还可以看 [《OpenClaw 保姆级部署教程》](https://mp.weixin.qq.com/s/DZYc92rLzhX95L6OBEQUyQ)，把 OpenClaw 部署到云服务器上 7 x 24 小时不间断运行。
|
||
|
||
当然，我估计更多同学折腾一下之后，就会心生退意：**我要，这龙虾有何用？！**
|
||
|
||
没错，你可能根本不需要 OpenClaw。
|
||
|
||
所以，接下来保姆皮还会教大家怎么卸载 OpenClaw，把它删的干干净净，虾皮都不剩。
|
||
|
||
|
||
|
||
## 四、卸载
|
||
|
||
其实只需要执行一行命令，就能卸载 OpenClaw 了：
|
||
|
||
```bash
|
||
openclaw uninstall
|
||
```
|
||
|
||
但是要注意观察执行命令后的输出结果，有些内容可能不会自动删除：
|
||
|
||
|
||
|
||
如果你想确保卸载得干干净净，直接复制下面对应你操作系统的所有命令，一把执行即可。
|
||
|
||
Mac / Linux 用户：
|
||
|
||
```bash
|
||
openclaw gateway stop
|
||
openclaw gateway uninstall
|
||
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
|
||
npm rm -g openclaw || pnpm remove -g openclaw
|
||
rm -rf /Applications/OpenClaw.app
|
||
```
|
||
|
||
Windows 用户（在 PowerShell 中执行）：
|
||
|
||
```powershell
|
||
openclaw gateway stop
|
||
openclaw gateway uninstall
|
||
schtasks /Delete /F /TN "OpenClaw Gateway"
|
||
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
|
||
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinue
|
||
npm rm -g openclaw
|
||
# 如果你是用 pnpm 安装的，改为执行：pnpm remove -g openclaw
|
||
```
|
||
|
||
这一梭子命令执行完，仿佛什么都没发生过。
|
||
|
||
|
||
|
||
## 写在最后
|
||
|
||
OpenClaw 确实是一个很酷的项目，它把用户操作 AI 智能体的入口变成了你日常使用的手机聊天软件，让 AI 无缝融入你已有的沟通习惯。现在各家也都在抢占 AI 入口，想方设法离用户更近。
|
||
|
||
但是 OpenClaw 虽好，也要用在正地。
|
||
|
||
我看到很多人在吹 “用手机远程操控 AI 办公”，但说实话，有多少人真的需要呢？
|
||
|
||
当你放松拿起手机的时候，你是想指挥 AI 办公，还是想刷个视频、看看朋友圈？
|
||
|
||
如果只是为了尝鲜装一个，最后的结局大概率是吃灰卸载。
|
||
|
||
而且如果你在电脑前工作，自动化的需求完全可以通过 AI 编程工具（比如 Claude Code / Cursor）或者 AI 桌面端助手来实现，比 OpenClaw 更简单直接，还不用自己折腾环境、配置 API Key，开箱即用。**比起追热点装一个用不上的工具，不如想想怎么用 AI 强化优化自己的工作流。** 找到真正能提升你效率的 AI 工具，坚持用起来，才是正道。
|
||
|
||
我觉得 OpenClaw 更适合想提高工作效率的职场商务人士，或者是喜欢折腾、想深度自定义 AI 行为的技术爱好者，不是人人都能养出比大厂专业团队封装地更好的龙虾的。很快各家也会推出自己的 OpenClaw，哦不，已经来了。
|
||
|
||
当然，我也会持续关注 OpenClaw 的发展，探索更多提高效率的玩法。
|
||
|
||
到这里，我们已经学完了主流 AI 编程工具的全部类型。在下一篇文章中，我会介绍 AI 辅助工具集，包括版本管理、项目部署等工具，帮你完善整个开发工具链。
|
||
|
||
加油！
|
||
|
||
|
||
|
||
## 推荐资源
|
||
|
||
1）鱼皮 AI 导航网站：[AI 资源大全、最新 AI 资讯、免费 AI 教程](https://ai.codefather.cn)
|
||
|
||
2）编程导航学习圈：[学习路线、编程教程、实战项目、求职宝典、交流答疑](https://www.codefather.cn)
|
||
|
||
3）程序员面试八股文：[实习/校招/社招高频考点、企业真题解析](https://www.mianshiya.com)
|
||
|
||
4）程序员写简历神器：[专业模板、丰富例句、直通面试](https://www.laoyujianli.com)
|
||
|
||
5）1 对 1 模拟面试：[实习/校招/社招面试拿 Offer 必备](https://ai.mianshiya.com)
|