01-OpenClaw 安装教程「适合：Mac、Windows」

你好，我是悦创。

这里先做一下简单的科普：OpenClaw 的名字经历了三次变更，第一次叫做 ClawdBot，后来因为名字跟 Claude 太过相似，被 Claude 告侵权，遂改名 MoltBot 。

但是后来在改名过程中遭遇域名和社交账号被抢注，甚至出坑同名加密货币割韭菜的情况，导致名称传播受阻。

最终定名为：OpenClaw。

所以，名字经历先后顺序为：ClawdBot -> MoltBot -> OpenClaw

大家不要因为名字困惑了，怀疑是不是自己下错软件了，他们都是同一个。

1. 什么是 OpenClaw？

1.1 真正“能干活”的个人 AI 助手

OpenClaw（前身为 Clawdbot） 是一款在 2026 年迅速走红的开源个人 AI 助手，在 GitHub 上已收获 10 万+ Star。

它和你熟悉的那些“只会聊天”的 AI，有着本质上的不同。

1.2 🚀 它和传统 AI 的根本差异

• 不是只会说，而是真的会做：不仅能回答问题，还能直接在你的电脑上执行操作。

• 全天候在线的数字助理：你休息时，它依然在后台替你完成任务。

• 完全开源 & 永久免费：没有黑箱，代码透明，所有数据牢牢掌握在自己手中。

• 全平台指挥，一句话下达任务：海外支持：WhatsApp、Telegram、Discord、Slack、iMessage；国内支持：飞书、钉钉等主流办公与即时通讯工具

1.3 🤖 OpenClaw 能为你做什么？

它不是“陪你聊天”的机器人，而是真正会在你电脑上动手干活的 AI。

• 你说一句：“帮我整理一下上个月的邮件”

  它就开始自动分类、归档、清理。

• 你已经入睡：它仍在后台运行，退订垃圾广告、预约行程、巡检日志、定位 Bug……

• 你在任何一个聊天软件里：给它发条消息，它就立刻执行。

1.4 ✨ 一句话总结

把事情交给它就行了。

从整理文件、处理邮件，到自动化任务，甚至联动智能家居控制灯光—— OpenClaw 都会在后台默默完成。

它不是助手的“概念版”，而是你电脑里真正存在的 JARVIS 级 AI 管家。

一个超级智能、能落地、能执行的个人 AI 助理。

令我感到遗憾的是：还不能达到真正的“手”不能自动识别各种软件，要是可以识别就可以扩展更多功能。（至少还不能发微信～）

2. 安装 Node.js

下载地址：https://nodejs.org/zh-cn/download

自行选择 Mac 或 Windows 进行下载、安装，安装步骤默认操作即可。

3. 开始安装「MacOS & Windows」

3.1 Mac 和 Windows 说明

Mac 直接启动终端即可，Windows 需要按如下指示操作：

1. 设置 PowerShell 执行权限

   1. 按 Win 键，搜索 PowerShell
   2. 右键点击 Windows PowerShell
   3. 选择 以管理员身份运行
   4. 点击 是 确认

   

2. 在管理员 PowerShell 窗口中，依次执行以下两条命令：

   # 第一条命令：允许当前用户运行本地和下载的脚本
   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   # 第二条命令：允许当前用户运行本地和下载的脚本
   Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

   安全提示：这些命令只会影响您自己的账户，不会影响系统安全或其他用户。

   

3.2 执行一键安装命令

• Mac 使用官方推荐命令，进行一键安装：

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

• Windows 在 PowerShell 执行如下命令：

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

安装过程会自动完成：

• 检测系统环境
• 安装必要依赖（Node.js 等）
• 下载 OpenClaw 核心文件
• 配置环境变量
• 启动配置向导

注意：如果前面你并没有自己提前安装 Node.js，但执行命令后，出现报错，可以自己到官网下载 node 安装包，自己安装 node 环境，注意版本最好在 node v22.x 以上， node 官网下载地址：https://nodejs.org/zh-cn/download，若还是不懂怎么安装，可以添加我微信：Jiabcdefh 进行付费安装。

Tisp：下面截图是 Windows 界面，Mac 类似，就不提供截图了。

4. 初始配置向导

安装完成后，会自动进入配置向导（openclaw onboard）。

4.1 风险告知

这一步主要是告诉你，使用 OpenClaw 可能会有一些风险。请问你是否继续？

按 向左方向键 ←，选择 Yes，按 Enter 回车确认：

4.2 选择 QiuickStart 模式

4.3 配置 AI 模型 API Key

OpenClaw 需要连接到大语言模型才能工作。Openclaw 比较费token，国外模型成本高，门槛也高，这里我选择国内的智谱的 GLM 4.7

如果没有智谱的 API Key，点击官方地址自己注册账号获取 API key：https://www.bigmodel.cn/invite?icode=kfX4Vy3FW818IlOHqfkX%2BlwpqjqOwPB5EXW6OL4DgqY%3D

输入自己的 API Key：

4.4 选择 AI 模型

这里我选择默认的 GLM 4.7，也是智普当前的旗舰模型。

4.5 连接即时通讯平台

配置完 AI 模型后，OpenClaw 会询问你要连接哪个通讯平台？

OpenClaw 原生支持的即时通信平台主要是海外的 WhatsApp、Telegram、Discord、Slack、iMessage 等，国内用户不习惯，这里国产即时通信软件大厂也跟进了，现在钉钉，飞书等都已支持接入 OpenClaw

后面会带领大家把飞书机器人接入 OpenClaw，使大家可以通过飞书即可指挥 OpenClaw 为我们干活，但是飞书配置比较复杂，这里我们先选择跳过，后面我们可以通过继续进行配置：

4.6 选择 Skills

这里也选择：No，暂不配置，后面通过UI界面进行配置：

4.7 是否开启 Hooks

操作步骤：先敲空格，表示选中当前项，再敲回车键。

4.8 启动服务并打开 UI 界面

此时它会自动再打开一个命令窗口来启动服务：

这个过程是在启动服务，可能会需要等一点时间。

Mac 系统不会打开新的命令窗口，只会在同一个窗口执行。

同时，大约过 30 秒左右，我们回到刚才的设置窗口，选择 Open the Web UI ，打开 OpenClaw 的 UI 界面：

浏览器自动打开Web UI界面：

4.9 测试一下

5. 对接飞书机器人

我们需要先到飞书平台创建自己的机器人来接入 OpenClaw：

5.1 来到飞书开发者后台

飞书开放平台地址：https://open.feishu.cn，没有飞书账号的，需要自己注册账号。

点击右上角进入 开发者后台：

5.2 创建应用

5.3 填写应用信息

5.4 给应用添加机器人

5.5 给应用配置权限

把即时通讯相关的权限全部开通：

5.6 创建版本并发布

5.7 来到飞书客户端进行审批

5.8 获取自己的应用凭证

5.9 安装飞书插件

你可知道：写着写着 OpenClaw 就更新了，也支持了飞书功能。估计是有“大佬”，向 OpenClaw 官方投稿了，依然是以插件的形式存在。链接：https://docs.openclaw.ai/channels/feishu 下面的图片因为已经做好，所以就不进行太多更新，整体是一致的。（国外的通讯软件也很好用，很好配置（推荐））

OpenClaw 官方飞书投稿的教程，写的很烂～

并且在你初始化 OpenClaw 的时候，就会有飞书的选项。

并且选择进去后，会提示：是否下载。

【Mac 操作相同，打开终端】打开 powershell，输入以下命令，安装飞书插件：

# openclaw plugins install @m1heng-clawd/feishu
openclaw plugins install @openclaw/feishu

# 如果你的 OpenClaw 一开始使用 OpenClaw 是从仓库抓取下来，仓库已经内置。可以使用如下命令：
openclaw plugins install ./extensions/feishu

安装成功后，再打开一个新的命令窗口，开始配置飞书插件：

输入命令：

openclaw config

选择渠道：

选择配置链接：

输入飞书的 AppID，AppSecrect：

域名选择中国的：

接受群组聊天：

选择完成：

选择 Yes：

选择 open：

选择继续，完成配置：

重启服务，使配置生效。终端可以看到飞书插件已经配置成功：

5.10 回到飞书后台设置事件回调

选择 使用长连接接收事件 ：

可以看到添加事件按钮由原来的灰色不可点击变为可点击：

添加接收消息事件：

给应用开通获取通讯录基本信息的权限：

重新发布版本：

跟前面的步骤一样，发布为在线应用即可。

现在可以在 飞书中与 AI 助手对话了！

5.11 在飞书中与 OpenClaw 对话

来到飞书客户端或者手机飞书 app 上：

以下是 openclaw 文件夹下面的文档内的内容：

5.12 访问 Web 控制面板

配置完成后，PowerShell 窗口底部会显示控制面板链接，格式类似：

Control UI: http://127.0.0.1:18789

1. 复制完整链接
2. 在浏览器中打开
3. 即可看到可视化UI管理界面

6. 常用命令速查

7.FAQ

Q1：npm 证书校验失败

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

  🦞 OpenClaw Installer
  Welcome to the command line: where dreams compile and confidence segfaults.

✓ Detected: macos
✓ Homebrew already installed
✓ Node.js v23.11.0 found
✓ Git already installed
→ Installing OpenClaw (latest)...
→ npm install failed; cleaning up and retrying...

npm config set strict-ssl false  # 关闭
npm config set strict-ssl true   # 开启

Q2：OpenClaw 不回复

我的修好了，忘记截图出问题的界面，图片来自：https://zeabur.com/forum/posts/697ca71becc019f67a62eaac

如果你使用官方推荐的命令：curl -fsSL https://openclaw.ai/install.sh | bash 安装之后，出现如下现象：

• 现象一：在你初始化安装时，出现类似提示：npm install failed; cleaning up and retrying...；（或者连准备安装 OpenClaw 的版本号都没显示出来）

  

• 现象二：已经按照官方安装方法，OpenClaw 一直不回复；

• 现象三：就算换模型、给 API 充钱、卸载重新安装都不回复；

• 现象四：安装 OpenClaw 提供的安装包安装后，一切显示正常，但是依然不回复；

经过长达两天不间断的排查，我发现：

• 使用国内源安装 brew、node 版本并不是最新的，虽然符合要求，但这显然不对劲！
• npm 所走的证书也问题；（使用命令：npm config set strict-ssl false）

可以考虑如下操作建议：

• Step 1：重装 Mac 系统；（可选｜便捷）

• Step 2：启动终端，安装 Xcode：输入命令 xcode-select --install 后，Mac 会弹出安装提示，点击安装即可；

• Step 3：下载 SwitchHosts：https://switchhosts.vercel.app/zh；（可选｜在无法正常请求 GitHub 时需要开启）

  按下图配置，新建配置文件，名称随意：

  

  199.232.68.133 raw.githubusercontent.com
  199.232.68.133 user-images.githubusercontent.com
  199.232.68.133 avatars2.githubusercontent.com
  199.232.68.133 avatars1.githubusercontent.com

  这个软件，先安装不要启动。

• **Step 4：**推荐使用 brew 官方安装方法安装，国内安装方法虽然快速、方便，但是会存在一切无法预料的问题；

  • 官方命令：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"；

  • 国内镜像命令：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" 国内教程：https://bornforthis.cn/blog/2022/02.html

  • 如果安装出现问题、卡顿：

    配置 git 代理：解决git clone及huggingface下载等网络失败问题

    我使用的是 Clash Verge 所以是如下配置：

    git config --global http.proxy socks5://127.0.0.1:7897
    git config --global https.proxy socks5://127.0.0.1:7897
    
    # 后期想要取消 git 代理配置时，使用如下命令
    git config --global --unset http.proxy
    git config --global --unset https.proxy

    推荐你使用 Clash Verge 做你的代理软件，因为这样命令肯定和我一样。

• Step 5：brew 安装完成后，安装 Nodejs 使用命令：brew install node 进行安装；

• Step 6：接下来我们进行安装 OpenClaw：

  # 可以先尝试用这个方法进行安装
  curl -fsSL https://openclaw.ai/install.sh | bash
  
  # 不过我实际成功是使用如下命令
  # Install OpenClaw
  npm i -g openclaw
  
  # Meet your lobster
  openclaw onboard

• Step 7：接着按照 OpenClaw 的指示，一步步配置即可。

• 这样就莫名的解决了，希望你可以在评论区和我一起交流。

• 如果最后 npm 实在安装不了，再考虑 npm 换源。换源命令：npm config set registry https://registry.npmmirror.com 验证：npm config get registry

Q3：通讯软件配置问题

配置通讯软件时，有时会出现网络问题。此时，推荐开启：虚拟网卡，保证命令行使用的网络，也走代理。

公众号：AI悦创【二维码】