Mac安装OpenClaw-cn保姆级教程

再次安装还是失败，又发现缺少cmake，我的mac有点老，需要重新下载cmake，利用homebrew。参考：https://open-claw.org.cn/guide/getting-started。接下来会有快捷安装的成功的界面，中间有不确定的skip即可；我选择的是Deepseek模型；，并自动修改你的 shell 配置文件（如。的时候，很慢最终fail了；最后再次执行以下的命令，最终安装

差不多程序员

2570人浏览 · 2026-02-24 14:49:57

差不多程序员 · 2026-02-24 14:49:57 发布

OpenClaw 是一个个人PC上运行的AI助手，且可以通过其支持的聊天程序（WhatsApp、Telegram、飞书等）来唤醒AI助手，帮助个人解决问题

本次任务

由简单到复杂，先搭建一个本地化的openclaw聊天AI助手，结合云端Deepseek大模型，指挥它干活；
在这里插入图片描述
下次任务：深度使用和查阅资料，进一步发散对openclaw应用上的想象力

一.安装/升级Node

1.检查node版本

jack@leogogoogooo ~ % node -v
v18.17.0
jack@leogogoogooo ~ % which node
/usr/local/bin/node

2.升级node版本到22【必须】

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

这会把 NVM 安装到 ~/.nvm，并自动修改你的 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile）。

关闭终端再打开；

执行命令： cat ~/.zshrc | grep nvm

出现下面的输出则代表正常：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

3.安装node 22版本

nvm install 22

验证：

jack@leogogoogooo ~ % node -v
v22.22.0
jack@leogogoogooo ~ % which node
/Users/jack/.nvm/versions/node/v22.22.0/bin/node

4.卸载旧版本

sudo rm -rf /usr/local/bin/node
sudo rm -rf /usr/local/bin/npm
sudo rm -rf /usr/local/lib/node_modules
sudo rm -rf /usr/local/include/node
sudo rm -rf /usr/local/share/man/man1/node.1

二、安装Pnpm

使用国内的镜像源，再进行npm安装

npm config set registry https://registry.npmmirror.com
npm install -g pnpm

pnpm也使用国内的镜像源

pnpm config set registry https://registry.npmmirror.com/

三、安装OpenClaw

1.克隆仓库

git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git

切换到最新分支，不知道最新版本则使用 git tag查看最新版本：

git tag
v2026.2.2-cn

git checkout v2026.2.2-cn

2.编译open claw

# 安装依赖 (飞快 🚀)
pnpm install

# 构建前端界面
pnpm ui:build

# 构建核心服务
pnpm build

3.Quick Start

OpenClaw快捷安装界面；

执行命令：

pnpm openclaw onboard --install-daemon

接下来会有快捷安装的成功的界面，中间有不确定的skip即可；我选择的是Deepseek模型；

◇  Start TUI (best option!) ─────────────────────────────────╮
│                                                            │
│  This is the defining action that makes your agent you.    │
│  Please take your time.                                    │
│  The more you tell it, the better the experience will be.  │
│  We will send: "Wake up, my friend!"                       │
│                                                            │
├────────────────────────────────────────────────────────────╯
│
◇  Token ────────────────────────────────────────────────────────────────────────────────╮
│                                                                                        │
│  Gateway token: shared auth for the Gateway + Control UI.                              │
│  Stored in: ~/.openclaw/openclaw.json (gateway.auth.token) or OPENCLAW_GATEWAY_TOKEN.  │
│  Web UI stores a copy in this browser's localStorage (openclaw.control.settings.v1).   │
│  Get the tokenized link anytime: openclaw dashboard --no-open                          │
│                                                                                        │
├────────────────────────────────────────────────────────────────────────────────────────╯
│
◇  How do you want to hatch your bot?
│  Hatch in TUI (recommended)
 openclaw tui - ws://127.0.0.1:18789 - agent main - session main                                                                                                           

 session agent:main:main

5.测试一下

 Wake up, my friend!                                                                                                                                                       
                                                                                                                                                                           

 Hey! I'm awake and ready to help. What's on your mind today?                                                                                                              

                                                                                                                                                                           
 帮我看一下当前目录有多少文件                                                                                                                                              
                                                                                                                                                                           

 当前目录共有 10 个文件和文件夹（包括隐藏文件）：                                                                                                                          
                                                                                                                                                                           
 文件列表：                                                                                                                                                                
 1. .git/ - Git 仓库目录                                                                                                                                                   
 2. AGENTS.md - 你的工作空间配置文件                                                                                                                                       
 3. BOOTSTRAP.md - 启动引导文件                                                                                                                                            
 4. HEARTBEAT.md - 心跳检查文件                                                                                                                                            
 5. IDENTITY.md - 身份信息文件                                                                                                                                             
 6. SOUL.md - 你的个性配置文件                                                                                                                                             
 7. TOOLS.md - 工具配置笔记                                                                                                                                                
 8. USER.md - 用户信息文件                                                                                                                                                 
                                                                                                                                                                           
 另外还有当前目录（.）和上级目录（..）。                                                                                                                                   
                                                                                                                                                                           
 看起来这是一个 OpenClaw 的工作空间目录，包含了所有必要的配置文件。需要我帮你查看某个特定文件的内容吗？                                                                    
 connected | idle                                                                                                                                                          
 agent main | session main (openclaw-tui) | deepseek/deepseek-chat | tokens 12k/64k (19%)

6.中断程序后的恢复UI界面

默认快捷安装会有OpenClaw网关的服务，如果电脑重启（openclaw关闭）需要检查，启动一些相关的配置：

# 启动网关 (Gateway)
node openclaw.mjs gateway --port 18789 --verbose
# 打开管理面板 (Dashboard)
node openclaw.mjs dashboard

如果配置都没有问题，想再次回到OpenClaw命令行，则输入：

pnpm start -- tui

7.安装遇到的问题

执行pnpm install的时候，很慢最终fail了；发现是无法安装node-llama-cpp

解决方案，不安装，并且忽略

# 回到项目目录
cd openclaw-cn

# 清理 node_modules 和可能的锁
rm -rf node_modules
# 可选：清理 pnpm store 中的缓存（避免复用失败构建）
pnpm store prune

# 重新安装
pnpm install

再次安装还是失败，又发现缺少cmake，我的mac有点老，需要重新下载cmake，利用homebrew

brew install cmake

最后再次执行以下的命令，最终安装成功了

# 1. 回到家目录（解决 "directory not found" 错误）
cd ~

# 2. 安装 cmake
brew install cmake

# 3. 验证
cmake --version

# 4. 回到 openclaw 项目，重试安装
cd ~/openclaw-cn
rm -rf node_modules
pnpm install

在这里插入图片描述
参考：https://open-claw.org.cn/guide/getting-started

二.原版Openclaw

cn版本做了汉化，可能滞后一两个版本，我使用上没有感觉，但是如果大家介意，可以按照下面的流程安装，主要是通过npm安装了，cn刚刚是下载源码进行编译buid构建得到，原版的Openclaw命令可以单独被安装识别：

## 0.node环境是通用的，22版本以上，和上面的教程一样
## 1.安装最新的Openclaw
npm install -g openclaw@latest
## 2.验证安装成功
openclaw --version
2026.2.26
## 3.安装向导
openclaw onboard --install-daemon