Mac安装OpenClaw-cn保姆级教程
OpenClaw 是一个个人PC上运行的AI助手，且可以通过其支持的聊天程序（WhatsApp、Telegram、飞书等）来唤醒AI助手，帮助个人解决问题
本次任务
由简单到复杂，先搭建一个本地化的openclaw聊天AI助手，结合云端Deepseek大模型，指挥它干活；
下次任务：深度使用和查阅资料，进一步发散对openclaw应用上的想象力
一.安装/升级Node
1.检查node版本
jack@leogogoogooo ~ % node-v v18.17.0 jack@leogogoogooo ~ % whichnode /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
出现下面的输出则代表正常：
exportNVM_DIR="$HOME/.nvm"[-s"$NVM_DIR/nvm.sh"]&&\. "$NVM_DIR/nvm.sh"3.安装node 22版本
nvm install22验证：
jack@leogogoogooo ~ % node-v v22.22.0 jack@leogogoogooo ~ % whichnode /Users/jack/.nvm/versions/node/v22.22.0/bin/node 4.卸载旧版本
sudorm-rf /usr/local/bin/node sudorm-rf /usr/local/bin/npm sudorm-rf /usr/local/lib/node_modules sudorm-rf /usr/local/include/node sudorm-rf /usr/local/share/man/man1/node.1 二、安装Pnpm
使用国内的镜像源，再进行npm安装
npm config set registry https://registry.npmmirror.com npminstall-gpnpmpnpm也使用国内的镜像源
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
# 安装依赖 (飞快 🚀)pnpminstall# 构建前端界面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 --port18789--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 # 重新安装pnpminstall再次安装还是失败，又发现缺少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 pnpminstall
参考：https://open-claw.org.cn/guide/getting-started
二.原版Openclaw
cn版本做了汉化，可能滞后一两个版本，我使用上没有感觉，但是如果大家介意，可以按照下面的流程安装，主要是通过npm安装了，cn刚刚是下载源码进行编译buid构建得到，原版的Openclaw命令可以单独被安装识别：
## 0.node环境是通用的，22版本以上，和上面的教程一样## 1.安装最新的Openclawnpminstall-g openclaw@latest ## 2.验证安装成功 openclaw --version2026.2.26 ## 3.安装向导 openclaw onboard --install-daemon 参考文章：https://juejin.cn/post/7604084016510812201 【原版安装，很值得借鉴】
