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. 开始安装

3.1 MacOS

3.2 Windows

3.2.1 设置 PowerShell 执行权限

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 所走的证书也问题；

可以考虑如下操作建议：

• 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 做你的代理软件，因为这样命令肯定和我一样。

• npm config set registry https://registry.npmmirror.com 验证：npm config get registry

配置通讯软件时，推荐开启：虚拟网卡，保证命令行使用代理。

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