做一个有温度和有干货的技术分享作者 —— Qborfy

前两篇我们搞清楚了 OpenClaw 是什么、怎么白嫖大模型。这一篇，我们终于要把龙虾装到你的电脑上，让它真正开始帮你干活！

是什么

安装龙虾的五种方式

OpenClaw 提供了五种安装方式，就像买手机有不同的套餐一样：

新手套餐：一键脚本安装（最快上手，5 分钟搞定）

• 适合：完全不懂技术的纯新手
• 就像：买手机直接开机就能用
• 优点：自动完成所有配置，无需手动操作
• 缺点：依赖网络环境

技术爱好者套餐：npm 安装（最灵活）

• 适合：有一定技术基础，想深度定制
• 就像：自己组装电脑，想怎么配就怎么配
• 优点：完全控制配置，随时更新
• 缺点：需要懂一点命令行

苹果用户套餐：客户端安装（最省心）

• 适合：使用苹果电脑的用户
• 就像：在 App Store 下载应用
• 优点：图形界面操作，无需命令行
• 缺点：仅支持 macOS

云服务器套餐：腾讯云一键秒部署（服务器用户首选）

• 适合：想快速搭建自己的机器人服务
• 就像：租一间精装修的房子，拎包入住
• 优点：云端部署，24 小时运行，无需本地电脑
• 缺点：需要付费购买云服务器

云服务器套餐：阿里云快速部署（企业用户推荐）

• 适合：企业级应用，需要稳定服务
• 就像：买精装房，配套齐全
• 优点：企业级支持，稳定可靠
• 缺点：成本相对较高

本篇重点讲一键脚本，因为这是新手最快上手的方式。其他四种方式会在文末简要说明。

怎么做

准备工作

在开始安装前，确保你的电脑满足以下条件：

• 操作系统：Windows 10/11、macOS 10.15+、Linux Ubuntu 18.04+
• 内存：至少 8GB（推荐 16GB）
• 硬盘空间：至少 2GB 可用空间
• 网络：能正常访问 GitHub 和国内大模型平台

如何打开”黑窗口”（终端/命令提示符）

很多新手一听到”命令行”就害怕，其实没那么复杂。终端就是一个可以输入命令的窗口，就像你平时用微信打字一样简单。

Windows 用户

方法一：使用命令提示符

1. 按键盘上的 Win + R 键（Win 键就是键盘左下角那个 Windows 图标键）
2. 在弹出的窗口中输入 cmd
3. 按回车键，会弹出一个黑色的窗口，这就是命令提示符

方法二：使用 PowerShell（推荐）

1. 在 Windows 搜索栏输入 PowerShell
2. 点击”Windows PowerShell”打开
3. PowerShell 比命令提示符功能更强大

macOS 用户

方法一：使用 Spotlight 搜索

1. 按键盘上的 Cmd + 空格 键（Cmd 键就是键盘左下角的 Command 键，上面有个 ⌘ 符号）
2. 在搜索框中输入”终端”或”Terminal”
3. 按回车键，会弹出一个白色的窗口

方法二：从启动台打开

1. 点击屏幕底部的”启动台”图标（那个有九个小方块的图标）
2. 找到”终端”应用并点击打开

Linux 用户

• Ubuntu/Debian：按 Ctrl + Alt + T 直接打开终端
• 其他发行版：在应用菜单中搜索”终端”或”Terminal”

小贴士：终端窗口打开后，你会看到一个闪烁的光标，那意味着电脑在等着你输入命令。

检查 Node.js 环境（仅 npm 安装需要）

如果你选择npm 安装方式，需要先检查电脑是否安装了 Node.js。

如何检查是否已安装 Node.js：

在终端中输入以下命令并按回车：

1

node -v

可能的结果：

• 如果看到版本号：比如 v18.17.0，说明已经安装了 Node.js，可以跳过安装步骤
• 如果提示”命令不存在”：说明没有安装，需要先安装 Node.js

如何安装 Node.js

Windows 用户：

1. 访问 Node.js 官网
2. 点击”下载”按钮（建议选择 LTS 版本，长期支持版本更稳定）
3. 下载完成后，双击安装包
4. 一直点”下一步”，使用默认设置即可
5. 安装完成后，重新打开终端，再次输入 node -v 验证

macOS 用户：

方法一：官网安装

1. 访问 Node.js 官网
2. 下载 macOS 版本的安装包（.pkg 文件）
3. 双击安装包，按照提示完成安装
4. 安装完成后，重新打开终端，输入 node -v 验证

方法二：使用 Homebrew（推荐，更方便）
如果你已经安装了 Homebrew（一个 Mac 上常用的软件管理工具），可以用这个命令：

1

brew install node

Linux 用户：

Ubuntu/Debian：

1
2

sudo apt update
sudo apt install nodejs npm

CentOS/RHEL：

1

sudo yum install nodejs npm

为什么要安装 Node.js？ Node.js 是一个可以让 JavaScript 在电脑上运行的环境，OpenClaw 的 npm 安装包需要它才能正常工作。

特别提醒：如果你在第 2 篇注册了智谱 AI，请把 API Key 准备好。如果还没注册，现在去注册：智谱 AI 开放平台

第一步：一键脚本安装（新手首选）

这是最简单的安装方式，全程只需要复制粘贴一条命令。

1. 打开”黑窗口”（终端/命令提示符）

• Windows：按 Win + R，输入 cmd，回车
• macOS：按 Cmd + 空格，搜索”终端”，打开
• Linux：按 Ctrl + Alt + T 打开终端

什么是终端？ 你可以把它理解成一个”打字机窗口”，在这里输入命令，电脑就会执行。

2. 执行一键安装命令

在终端中复制粘贴以下命令：

1

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

这条命令的作用：

• curl：从网上下载文件
• https://openclaw.ai/install.sh：官方安装脚本地址
• | bash：把下载的内容直接运行

安全提醒：这个脚本来自 OpenClaw 官方，可以放心使用。

3. 等待安装完成

安装过程大约需要 5-10 分钟，取决于你的网速。脚本会自动：

1. 检查你的系统环境
2. 下载最新版本的 OpenClaw
3. 安装必要的依赖包
4. 配置运行环境

你会看到类似这样的进度：

如果中途卡住：可能是网络问题，耐心等待或重新执行命令。

4. 输入”大脑钥匙”（API Key）

安装完成后，系统会提示你输入大模型配置。按照提示填写：

1
2
3
4
5
6
7
8

请选择大模型平台（输入数字）：
1. 智谱 AI (GLM)
2. 通义千问 (Qwen)
3. MiniMax
4. DeepSeek

请输入你的选择（默认 1）：1
请输入你的 API Key：zhipuai-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

把你在第 2 篇拿到的智谱 AI API Key 粘贴进去。

API Key 是什么？ 就像你家门的钥匙，有了这把钥匙，龙虾才能调用大模型的思考能力。

5. 启动龙虾（三步完成）

安装完成后，需要通过三个命令来启动龙虾。不要担心，这三个命令很简单：

第一步：运行配置向导

在终端中输入：

1

openclaw onboard

这个命令会启动一个交互式配置向导，引导你完成以下设置：

1. 风险确认：提示你 OpenClaw 会访问你的消息和应用，需要你确认是否同意
2. 上船模式选择：选择你想要的运行模式（如 Web 模式、消息机器人模式等）
3. 大模型/提供商配置：选择使用哪个大模型平台（智谱 AI、通义千问等）
4. 渠道选择：选择要接入的消息渠道（QQ、飞书、企业微信等）
5. 技能配置：选择要启用的技能（天气、日历、新闻等）

按照向导提示一步步操作，就像填表一样简单。

第二步：启动网关服务

配置完成后，启动 OpenClaw 的网关服务：

1

openclaw gateway start

这个命令会启动 OpenClaw 的核心服务，包括：

• Web 服务（提供 Web 界面）
• 消息接收器（接收 QQ、飞书等消息）
• 任务调度器（执行定时任务）
• 技能引擎（调用各种技能）

你会看到类似这样的输出：

1
2
3
4
5
6

[INFO] OpenClaw Gateway 启动中...
[INFO] Web 服务已启动：http://127.0.0.1:18789
[INFO] QQ 机器人已连接
[INFO] 飞书机器人已连接
[INFO] 任务调度器已启动
[INFO] OpenClaw 服务运行中 ✓

什么是网关？ 网关就像一个”总机”，负责接收所有消息，然后分发给不同的处理器处理。

第三步：打开 Web 界面（可选）

如果你想在浏览器中管理 OpenClaw，可以打开 Web 界面：

1

openclaw dashboard

这个命令会自动在浏览器中打开 OpenClaw 的管理界面，地址是：

1

http://127.0.0.1:18789

在 Web 界面中，你可以：

• 查看运行状态
• 管理技能
• 查看日志
• 配置参数

注意：openclaw dashboard 命令会自动打开浏览器。如果你的浏览器没有自动打开，可以手动在浏览器中输入 http://127.0.0.1:18789 访问。

恭喜！ 龙虾已经在你电脑上运行起来了。

三步启动流程总结：

1. openclaw onboard - 配置向导，设置参数
2. openclaw gateway start - 启动服务
3. openclaw dashboard - 打开管理界面（可选）

第二步：验证安装是否成功

安装完成后，用这几个方法测试龙虾是否正常工作。

方法一：打开 Web 管理界面（推荐）

在终端中输入：

1

openclaw dashboard

这会自动在浏览器中打开 OpenClaw 的管理界面，地址是：

1

http://127.0.0.1:18789

如果浏览器自动打开了管理界面，并且能看到运行状态、技能列表等信息，说明安装成功！

Web 界面里能看到什么？

• 运行状态：显示服务是否正常运行
• 技能列表：已安装的技能有哪些
• 日志查看：可以看到龙虾的运行日志
• 配置管理：可以修改各种配置

方法二：发送测试指令

打开 QQ 或飞书，给龙虾发送一条消息：

1

/help

如果龙虾回复了帮助信息，说明安装成功！

方法三：执行简单任务

发送一条实际的任务指令：

1

现在几点了？

如果龙虾正确回复了当前时间，说明它不仅能接收消息，还能调用技能完成任务。

方法四：检查服务状态

在终端中输入：

1

openclaw status

如果看到类似这样的输出，说明服务正常运行：

1
2
3
4

[INFO] OpenClaw 服务状态：运行中
[INFO] Web 服务：http://127.0.0.1:18789
[INFO] QQ 机器人：已连接
[INFO] 飞书机器人：已连接

其他四种安装方式（简要说明）

npm 安装方式（适合有技术基础的用户）

如果你熟悉命令行和 npm，可以用 npm 安装：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 1. 确保已安装 Node.js（参考上面的安装教程）
# 验证是否安装成功
node -v

# 2. 安装最新版本的 OpenClaw
npm install -g openclaw@latest

# 3. 运行配置向导
openclaw onboard

# 4. 启动网关服务
openclaw gateway start

# 5. 打开 Web 管理界面（可选）
openclaw dashboard

适合人群：

• 熟悉命令行操作
• 了解 Node.js 和 npm
• 希望随时更新到最新版本
• 想要深度定制配置

优点：

• 可以随时更新到最新版本
• 完全控制安装位置和配置
• 适合开发者和高级用户

缺点：

• 需要懂一点技术
• 需要手动配置环境变量
• 遇到问题需要自己排查

注意：

• npm 安装的包名是 openclaw，不是 @openclaw/cli
• @latest 表示安装最新版本，如果不加这个标签，可能会安装旧版本
• 安装完成后，启动流程和一键脚本一样，需要运行 openclaw onboard 和 openclaw gateway start

苹果客户端安装（macOS 用户）

如果你是苹果电脑用户，可以下载客户端：

1. 访问 OpenClaw 发布页面
2. 下载最新版本的 .dmg 文件
3. 双击安装包，将 OpenClaw 拖到应用程序文件夹
4. 在启动台找到 OpenClaw 并打开

优点：

• 图形界面操作，无需命令行
• 自动更新，无需手动维护
• 系统集成，支持菜单栏快捷操作

注意：仅支持 macOS 系统，Windows 和 Linux 用户请使用其他方式

腾讯云一键秒部署（云服务器用户）

如果你想在云服务器上部署龙虾，腾讯云提供了一键秒部署服务：

1. 访问 腾讯云 OpenClaw 一键部署页面
2. 登录腾讯云账号（没有的话先注册）
3. 选择服务器配置（建议：2 核 4G 以上）
4. 点击”一键部署”，等待 5-10 分钟

优点：

• 24 小时运行，无需本地电脑开机
• 自动配置网络和安全组
• 支持公网访问，随时随地使用

适合场景：

• 想搭建自己的机器人服务
• 需要长期稳定运行
• 不想占用本地电脑资源

阿里云快速部署（企业用户）

阿里云也提供了快速部署方案：

1. 访问 阿里云 OpenClaw 快速部署页面
2. 登录阿里云账号
3. 按照向导完成部署配置
4. 等待部署完成

优点：

• 企业级支持，稳定可靠
• 完善的监控和告警
• 支持高并发场景

适合场景：

• 企业级应用部署
• 需要稳定的服务保障
• 团队协作使用

国内替代方案（基于 OpenClaw 开源）

除了官方的 OpenClaw，国内也有不少基于 OpenClaw 开源的第三方服务，更符合国人使用习惯：

腾讯 WorkBuddy

腾讯推出的企业助手，基于 OpenClaw 开源框架开发：

• 特点：深度集成企业微信，适合企业内部使用
• 适用场景：企业办公、团队协作
• 获取方式：通过企业微信应用市场安装

Kimi Claw

月之暗面推出的智能助手，支持微博接入：

• 特点：直接接入微博平台，可以自动发布微博
• 适用场景：社交媒体运营、内容创作
• 获取方式：访问 Kimi 官网申请

智谱 AutoClaw

智谱 AI 推出的自动化助手：

• 特点：深度集成智谱大模型，中文理解能力强
• 适用场景：文档处理、知识问答
• 获取方式：访问智谱 AI 开放平台

MiniMax MaxClaw

MiniMax 推出的智能助手：

• 特点：多模态支持，可以处理图片和语音
• 适用场景：客服机器人、智能对话
• 获取方式：访问 MiniMax 官网申请

字节跳动 Moltbook

字节跳动推出的中文版智能笔记助手：

• 特点：深度集成飞书，适合知识管理
• 适用场景：笔记管理、知识库构建
• 获取方式：通过飞书应用市场安装

如何选择？

• 个人用户：优先选择官方 OpenClaw 或 Kimi Claw
• 企业用户：考虑腾讯 WorkBuddy 或字节 Moltbook
• 技术爱好者：推荐官方 OpenClaw，可深度定制

经典案例

安装后的第一个实用场景

安装完成后，你可以立即让龙虾帮你做这件事：

场景：让龙虾每天自动推送早报

在 QQ 或飞书里给龙虾发送：

1

每天早上 8 点，把今天的天气、3 条重要新闻、今日日程发给我。

龙虾会自动：

1. 查天气（调用天气技能）
2. 抓取新闻（调用新闻技能）
3. 读取你的日历（调用日历技能）
4. 整理成早报格式发给你

效果：从此每天早上不用刷手机，直接看龙虾整理的早报。

动手试试！

现在就能完成的三件事

第一件：用一键脚本安装龙虾

按照上面的步骤，现在就去安装。整个过程只需要 5-10 分钟。

预计时间：5-10 分钟

第二件：测试龙虾的基本功能

安装完成后，发送这些指令测试：

1
2
3

/help          # 查看所有可用指令
现在几点了？     # 测试基础功能
今天的天气怎么样？ # 测试技能调用

第三件：设置你的第一个自动化任务

尝试设置一个简单的定时任务：

1

每天晚上 10 点提醒我睡觉

龙虾会自动在每天晚上 10 点给你发提醒消息。

常见问题解答

Q1：一键脚本安装失败怎么办？

A：常见原因和解决方案：

• 网络问题：脚本需要从 GitHub 下载文件，如果网络不稳定会失败
  • 解决方案：重新执行命令，或尝试使用 VPN
• 权限问题：脚本需要权限来安装软件
  • 解决方案：在命令前加 sudo：curl -fsSL https://openclaw.ai/install.sh | sudo bash
• 系统不兼容：脚本可能不支持你的系统版本
  • 解决方案：尝试其他安装方式（npm 或客户端）

Q2：npm 安装时找不到命令怎么办？

A：确保你按照正确的步骤操作：

第一步：确认 Node.js 已安装

1

node -v

如果提示”命令不存在”，请先按照上面的教程安装 Node.js。

第二步：使用正确的命令安装

1
2
3
4
5

# 正确的命令（添加 @latest 确保安装最新版本）
npm install -g openclaw@latest

# 错误的命令（不要用这个）
npm install -g @openclaw/cli

第三步：验证安装是否成功

1

openclaw -v

如果显示版本号，说明安装成功。

第四步：按照三步流程启动

1
2
3
4
5
6
7
8

# 1. 运行配置向导
openclaw onboard

# 2. 启动网关服务
openclaw gateway start

# 3. 打开 Web 界面（可选）
openclaw dashboard

如果遇到权限问题（尤其是 macOS 和 Linux 用户）：

1
2

# 使用 sudo 安装
sudo npm install -g openclaw@latest

注意：使用 sudo 安装时，系统会要求你输入管理员密码。

Q3：苹果客户端无法安装怎么办？

A：常见问题：

• 无法打开应用：macOS 安全设置阻止了未签名的应用
  • 解决方案：在”系统偏好设置”→”安全性与隐私”中允许打开
• 找不到下载链接：访问 GitHub 发布页面
  • 下载文件名类似 OpenClaw-v1.0.0.dmg 的文件

Q4：如何更新龙虾到最新版本？

A：根据你的安装方式选择更新方法：

• 一键脚本用户：重新执行安装命令，脚本会自动更新

  1	curl -fsSL https://openclaw.ai/install.sh | bash

• npm 用户：

  1	npm update -g openclaw

• 苹果客户端用户：在应用内检查更新，或重新下载最新版本

Q5：启动命令 openclaw start 提示不存在怎么办？

A：OpenClaw 没有直接的 openclaw start 命令，需要按照三步流程启动：

正确的启动流程：

1
2
3
4
5
6
7
8

# 第一步：运行配置向导（首次安装必须执行）
openclaw onboard

# 第二步：启动网关服务（每次启动都要执行）
openclaw gateway start

# 第三步：打开 Web 界面（可选）
openclaw dashboard

为什么需要三步？

• openclaw onboard：配置向导，只需要在首次安装或需要重新配置时运行
• openclaw gateway start：启动核心服务，每次重启电脑后都需要运行
• openclaw dashboard：打开 Web 管理界面，可选操作

如果想让服务开机自动启动：

可以使用系统的开机启动项功能，或者在配置文件中设置自动启动。具体方法请参考官方文档。

进阶知识（可选阅读）

理解龙虾的安装架构

一键脚本实际上帮你完成了这些步骤：

1. 检测系统环境：自动识别你的操作系统和版本
2. 下载安装包：从 GitHub 获取最新版本的 OpenClaw
3. 安装依赖：自动安装必要的运行环境
4. 配置环境：设置数据库、日志系统、权限管理
5. 安装默认技能：天气、日历、邮件等常用技能
6. 启动服务：运行 Web 服务、消息接收器、任务调度器

自定义配置选项（技术爱好者专用）

如果你想要更多定制化选项，可以修改配置文件：

配置文件位置：~/.openclaw/openclaw.json

这个配置文件是 OpenClaw 的核心配置文件，用于管理模型、通道、技能插件等关键参数。

常用配置项示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

{
  "models": {
    "providers": {
      "zhipuai": {
        "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
        "apiKey": "你的智谱AI API Key",
        "models": ["glm-4-flash"]
      },
      "qwen": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "你的通义千问 API Key",
        "models": ["qwen-turbo"]
      }
    },
    "default": "zhipuai"
  },
  "channels": {
    "qqbot": {
      "token": "你的QQ机器人AppID:AppSecret",
      "adapter": "websocket"
    },
    "feishu": {
      "app_id": "你的飞书应用ID",
      "app_secret": "你的飞书应用密钥"
    }
  },
  "skills": {
    "enabled": ["weather", "calendar", "news", "browser"]
  },
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1"
  },
  "memory": {
    "conversation_history": 50
  }
}

配置说明：

• models：大模型配置，支持多个提供商和故障转移
• channels：消息通道配置（QQ、飞书、企微、钉钉等）
• skills：启用的技能列表
• gateway：Web 服务配置
• memory：对话历史和记忆配置

修改配置后重启服务：

1
2

# 重启网关服务使配置生效
openclaw gateway restart

配置文件备份建议：

在修改配置前，建议先备份：

1
2
3
4
5

# 备份配置文件
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

# 修改配置后验证
openclaw validate-config

注意：这部分是给技术爱好者看的，新手可以完全跳过，用默认配置就足够了。

总结

安装龙虾其实很简单，记住三件事：

1. 选择适合你的安装方式：新手用一键脚本，技术爱好者用 npm，苹果用户用客户端
2. 准备好大模型 API Key：这是龙虾的”大脑”，没有它龙虾无法工作
3. 验证安装是否成功：发送测试指令，确保龙虾能正常响应

下一篇，我们学习怎么给龙虾下指令——同样的需求，不同的说法，效果天差地别。学会正确的指令格式，让龙虾真正”听懂”你。

系列文章目录

• 第 0 篇：系列介绍
• 第 1 篇：认识龙虾——OpenClaw 是什么，能做什么，和普通 AI 有什么本质区别
• 第 2 篇：白嫖大模型——智谱、MiniMax、通义千问免费额度全攻略
• 第 3 篇：安装龙虾——一键脚本、npm、客户端、腾讯云、阿里云五种方式（本文）
• 第 4 篇：学会下指令——怎么给 OpenClaw 下指令，附常用指令模板（即将发布）
• 第 5 篇：装上技能包——Skills 安装与必备推荐（即将发布）
• 第 6 篇：安全使用指南——权限管理、数据安全与避坑指南（即将发布）

参考资料

• OpenClaw 官方安装文档
• 一键安装脚本
• GitHub 发布页面
• Node.js 安装指南
• 智谱 AI API 文档
• 常见安装问题排查

赏

谢谢你请我吃糖果

支付宝

微信