OpenClaw（大龙虾）保姆级安装教程

OpenClaw（大龙虾）保姆级安装教程

写给参加完线下座谈会、想自己动手试试的朋友们

作者：小爪 🐾

适用版本：2026年3月

---

写在前面：别怕，咱们一步步来

你好呀！如果你正在读这篇文章，大概率是刚参加完 OpenClaw 的线下座谈会，被那只"大龙虾"种草了，想回家自己也装一个试试。

但我知道，很多朋友可能心里在打鼓：

• "我电脑是 Windows 家庭中文版，能装吗？"
• "网上那些教程都要科学上网，我不会啊..."
• "看到命令行就头大，会不会很复杂？"

别担心！ 这篇教程就是专门为你写的。我会用最通俗的语言，把安装过程中可能遇到的坑都提前告诉你，并且给出解决方案。

本文承诺：

• ❌ 不涉及任何科学上网教学
• ❌ 不搞复杂的 Docker 部署
• ✅ 只讲三种最主流的安装方式
• ✅ 遇到问题？每个环节都有"Plan B"

---

先搞清楚：OpenClaw 是什么？

简单说，OpenClaw（外号"大龙虾"🦞）是一个本地运行的 AI 助手网关。装好之后，你可以通过微信、飞书、Telegram、Discord等常用聊天软件，直接跟 AI 对话。

它的特点是：

• 数据存在你自己电脑上，隐私安全
• 一次安装，多端可用
• 支持各种 AI 模型（OpenAI、Claude、Gemini 等）

---

安装前准备：检查你的电脑

不管用哪种方式安装，都需要满足以下条件：

💡 小提示： 如果你不确定自己的电脑配置，按 `Win + R`，输入 `cmd` 回车，然后在黑窗口里输入 `systeminfo`，就能看到系统信息了。

---

方案一：纯 Windows 环境（最简单，推荐先尝试）

适合人群：不想折腾、想快速上手的 Windows 用户

步骤 1：安装 Node.js

OpenClaw 需要 Node.js 环境运行，就像游戏需要安装运行库一样。

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

2. 点击大大的绿色 "LTS" 按钮下载（推荐下载 22.x 版本）

3. 下载完成后双击安装，一路点"下一步"就行

⚠️ 避坑提醒：

• 安装过程中有一个选项 "Add to PATH"，一定要勾选！（默认是勾选的，别取消）
• 如果之前装过 Node.js，建议先卸载旧版本，再装新的

验证安装成功：

按 `Win + R`，输入 `cmd` 回车，输入：

node --version

如果显示类似 `v22.14.0` 的版本号，说明成功了！

步骤 2：安装 OpenClaw

在刚才的黑窗口（命令提示符）里，复制粘贴下面这行命令，然后回车：

iwr -useb https://openclaw.ai/install.ps1 | iex

💡 这是什么意思？

• 这是从 OpenClaw 官网下载安装脚本并执行
• 脚本会自动帮你下载 OpenClaw，并启动配置向导

⚠️ 常见问题及解决：

问题 1：提示 "无法识别 iwr 命令"

• 原因：你可能打开的是旧版命令提示符
• 解决：按 `Win + X`，选择 "Windows PowerShell" 或 "终端"

问题 2：提示 "执行策略禁止运行脚本"

• 原因：Windows 默认禁止运行下载的脚本
• 解决：以管理员身份运行 PowerShell，输入：

  Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后输入 `Y` 确认，再重新运行安装命令

问题 3：安装进度卡住不动

• 原因：网络下载慢
• 解决：耐心等待 3-5 分钟，或者换个时间段再试

步骤 3：运行配置向导

安装完成后，会自动启动配置向导，你只需要跟着提示一步步操作：

1. 选择 AI 模型：推荐先选 "OpenAI"（如果你有 API Key）或 "OpenRouter"（免申请，直接用）

2. 配置 API Key：根据你选择的模型，输入对应的 API Key

3. 选择通讯渠道：勾选你想用的聊天软件（飞书、Telegram、Discord 等）

💡 什么是 API Key？

简单说就是"使用 AI 的密码"。如果你还没有：

• OpenAI：访问 platform.openai.com 注册获取
• OpenRouter：访问 openrouter.ai 注册，有免费额度

步骤 4：启动 OpenClaw

配置完成后，输入以下命令启动：

openclaw gateway start

看到 "Gateway started" 的提示，就说明成功了！

🎉 恭喜！ 现在你可以打开浏览器，访问 http://127.0.0.1:18789 开始跟 AI 聊天了。

---

方案二：Windows + WSL（方案一失败时的救星）

适合人群：纯 Windows 安装遇到权限问题、系统不兼容，或者想更稳定运行的用户

什么是 WSL？

WSL（Windows Subsystem for Linux）是 Windows 内置的 Linux 子系统。简单说，就是在 Windows 里"虚拟"出一个 Linux 环境，很多开发工具在 Linux 下运行更稳定。

💡 需要科学上网吗？

不需要！WSL 是 Windows 自带功能，直接启用即可。

步骤 1：启用 WSL

1. 按 `Win + R`，输入 `optionalfeatures.exe` 回车

2. 找到 "适用于 Linux 的 Windows 子系统"，勾选并确定

3. 重启电脑

或者，用更简单的方式（推荐）：

以管理员身份打开 PowerShell（右键开始菜单 → Windows PowerShell (管理员)），输入：

wsl --install

这个命令会自动安装 WSL 和默认的 Ubuntu 系统。安装完成后重启电脑。

⚠️ 避坑提醒：

• 如果提示 "无法解析服务器名称"，检查你的网络连接
• 如果安装很慢，可以耐心等待，这是正常现象

步骤 2：设置 Ubuntu 用户名和密码

重启后，会自动打开 Ubuntu 窗口，提示你创建用户名和密码：

Enter new UNIX username: （输入你想要的用户名，比如你的名字拼音）
New password: （输入密码，注意输入时不会显示字符）
Retype new password: （再输一遍密码）

💡 重要提示：

• 密码输入时不会显示任何字符，这是正常的，输完直接回车
• 这个密码以后经常要用，务必记住！

步骤 3：在 WSL 里安装 OpenClaw

现在你在 Linux 环境里了，安装更简单：

1. 更新软件包列表（复制粘贴执行）：

   sudo apt update && sudo apt upgrade -y

2. 安装 Node.js：

   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
   sudo apt install -y nodejs

3. 验证 Node.js 安装：

   node --version

4. 安装 OpenClaw：

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

⚠️ 常见问题：

问题 1：提示 "curl: command not found"

• 解决：先安装 curl

  sudo apt install curl -y

问题 2：安装脚本执行失败

• 解决：检查网络连接，或者多试几次

步骤 4：配置和启动

和方案一一样，运行配置向导：

openclaw onboard --install-daemon

然后启动：

openclaw gateway start

💡 WSL 特别说明：

• WSL 里的 OpenClaw 和 Windows 是独立的，配置也要重新做一遍
• 但 WSL 运行更稳定，推荐长期使用

---

方案三：MacBook 环境（苹果用户专区）

适合人群：MacBook / iMac 用户

步骤 1：检查 macOS 版本

点击屏幕左上角 🍎 → "关于本机"，查看版本号。

• macOS 10.15 (Catalina) 及以上：可以继续
• 更早的版本：建议先升级系统

步骤 2：安装 Homebrew（如果还没有）

Homebrew 是 Mac 上的软件包管理器，类似 App Store，但是给程序员用的。

打开"终端"（按 `Cmd + 空格`，输入 `Terminal` 回车），粘贴执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

按照提示输入密码，等待安装完成。

⚠️ 避坑提醒：

• 安装过程中可能需要输入 Mac 的开机密码
• 如果提示 "无法验证开发者"，去 "系统设置 → 隐私与安全性" 里允许

步骤 3：安装 Node.js

在终端里执行：

brew install node@22

步骤 4：安装 OpenClaw

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

步骤 5：配置和启动

openclaw onboard --install-daemon
openclaw gateway start

💡 Mac 用户专属福利：

• OpenClaw 有原生的 macOS App，带菜单栏图标，体验更好
• 安装完成后，可以在 Launchpad 里找到 "OpenClaw" App

---

安装后的配置：连接你的聊天软件

OpenClaw 装好了，但还需要跟你常用的聊天软件"配对"才能用。

飞书（国内用户推荐）

1. 访问飞书开放平台：https://open.feishu.cn

2. 创建企业自建应用

3. 获取 App ID 和 App Secret

4. 在 OpenClaw 配置中添加：

   {
     "channels": {
       "feishu": {
         "appId": "你的AppID",
         "appSecret": "你的AppSecret"
       }
     }
   }

Telegram（国际用户推荐）

1. 找 @BotFather 创建机器人

2. 获取 Bot Token

3. 在 OpenClaw 配置中添加：

   {
     "channels": {
       "telegram": {
         "token": "你的BotToken"
       }
     }
   }

Discord

1. 访问 Discord Developer Portal

2. 创建 Application 和 Bot

3. 获取 Bot Token 并配置

💡 配置文件的地址：

• Windows：`C:Users你的用户名.openclawopenclaw.json`
• Mac/Linux：`~/.openclaw/openclaw.json`

---

常见问题急救包

Q1：提示 "openclaw 不是内部或外部命令"

原因： Node.js 的全局模块路径没有加入系统环境变量

解决：

1. 找到 Node.js 的安装路径（通常是 `C:Program Filesnodejs`）

2. 右键"此电脑" → 属性 → 高级系统设置 → 环境变量

3. 在 "Path" 中添加 Node.js 的安装路径

Q2：启动后无法访问 http://127.0.0.1:18789

原因： 端口被占用或防火墙拦截

解决：

1. 换个端口启动：`openclaw gateway --port 8080`

2. 检查 Windows 防火墙，允许 Node.js 通过

Q3：配置向导卡住不动

原因： 可能是网络问题或权限问题

解决：

1. 按 `Ctrl + C` 取消，重新运行

2. 尝试用管理员身份运行终端

Q4：怎么卸载 OpenClaw？

Windows：

npm uninstall -g openclaw

Mac/Linux：

npm uninstall -g openclaw
rm -rf ~/.openclaw

---

写在最后

恭喜你读到这里！🎉

安装 OpenClaw 确实需要一点耐心，特别是对于不熟悉命令行的朋友。但相信我，一旦装好了，你会发现这一切都是值得的——拥有一个 24 小时在线、随时待命的 AI 助手，真的很香。

如果这篇教程帮到了你，欢迎分享给其他参加座谈会的朋友。

如果还是遇到问题，可以：

1. 检查每一步是否按顺序执行

2. 仔细阅读错误提示（通常是英文，可以用翻译软件）

3. 在 OpenClaw 的 GitHub Issues 里搜索类似问题

祝安装顺利，早日用上你的专属 AI 助手！🦞

---

本文基于 OpenClaw 官方文档编写，更新时间：2026年3月15日

如有变动，请以官方文档为准：https://docs.openclaw.ai