Mac 环境下通过 nvm 升级 Node.js 至 v22，配置 pnpm 国内镜像源，克隆 OpenClaw-CN 仓库并编译构建。使用 onboard 命令完成快捷安装与网关启动，支持本地终端交互及唤醒指令。若遇依赖安装失败可清理缓存或补全 cmake 工具。同时提供原版 OpenClaw 的 npm 安装方案作为备选。
OpenClaw 是一个个人 PC 上运行的 AI 助手，且可以通过其支持的聊天程序（WhatsApp、Telegram、飞书等）来唤醒 AI 助手，帮助个人解决问题。
node -v
which node
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"
nvm install 22
验证：
node -v
which node
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
使用国内的镜像源，再进行 npm 安装
npm config set registry https://registry.npmmirror.com
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com/
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
切换到最新分支，不知道最新版本则使用 git tag 查看最新版本：
git tag v2026.2.2-cn
git checkout v2026.2.2-cn
# 安装依赖 (飞快 🚀)
pnpm install
# 构建前端界面
pnpm ui:build
# 构建核心服务
pnpm build
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
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%)
默认快捷安装会有 OpenClaw 网关的服务，如果电脑重启（openclaw 关闭）需要检查，启动一些相关的配置：
# 启动网关 (Gateway)
node openclaw.mjs gateway --port 18789 --verbose
# 打开管理面板 (Dashboard)
node openclaw.mjs dashboard
如果配置都没有问题，想再次回到 OpenClaw 命令行，则输入：
pnpm start -- tui
执行 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
cn 版本做了汉化，可能滞后一两个版本，我使用上没有感觉，但是如果大家介意，可以按照下面的流程安装，主要是通过 npm 安装了，cn 刚刚是下载源码进行编译 build 构建得到，原版的 OpenClaw 命令可以单独被安装识别：
## 0.node 环境是通用的，22 版本以上，和上面的教程一样
## 1.安装最新的 Openclaw
npm install -g openclaw@latest
## 2.验证安装成功
openclaw --version
## 3.安装向导
openclaw onboard --install-daemon
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online