2026年OpenClaw-CN 完整安装教程与避坑指南（国内镜像加速版）

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

# Mac安装OpenClaw-cn避坑指南

环境准备阶段常见问题

Node.js版本问题

坑点1：Node.js版本不兼容 OpenClaw-cn要求Node.js版本必须为22或更高，低于此版本会导致构建失败[ref_1]。

# 检查当前Node.js版本 node -v # 如果版本低于22，使用nvm安装正确版本 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 重启终端后执行 nvm install 22

解决方案：安装完成后验证路径和版本，确保使用的是nvm管理的Node.js 22版本，而非系统自带的旧版本[ref_1]。

pnpm安装配置

坑点2：网络超时和下载失败 直接使用默认npm源安装pnpm可能会因网络问题失败。

GPT plus 代充 只需 145# 配置国内镜像源 npm config set registry https://registry.npmmirror.com npm install -g pnpm # pnpm也配置国内镜像 pnpm config set registry https://registry.npmmirror.com/

源码编译阶段关键问题

依赖安装失败

坑点3：node-llama-cpp编译失败 这是最常见的安装失败原因，特别是在较老的Mac设备上[ref_1]。

# 进入项目目录 cd openclaw-cn # 清理可能的缓存和失败构建 rm -rf node_modules pnpm store prune # 重新安装依赖 pnpm install

如果仍然失败，可以暂时忽略node-llama-cpp的安装，因为主要功能依赖云端模型。

CMake缺失问题

坑点4：构建工具链不完整 较老的macOS系统可能缺少必要的构建工具。

GPT plus 代充 只需 145# 使用Homebrew安装cmake brew install cmake # 验证安装 cmake --version # 返回项目目录重新安装 cd ~/openclaw-cn rm -rf node_modules pnpm install

版本选择和仓库操作

分支选择

坑点5：使用错误的分支版本

# 克隆仓库 git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git # 查看最新版本标签 git tag # 切换到最新稳定版本（示例） git checkout v2026.2.2-cn

注意：cn版本相比原版有汉化，但可能滞后1-2个版本。如果介意版本滞后，可以考虑安装原版OpenClaw[ref_1]。

构建和启动阶段

构建流程

GPT plus 代充 只需 145# 安装依赖 pnpm install # 构建前端界面 pnpm ui:build # 构建核心服务 pnpm build

初始化配置

坑点6：快捷安装界面选项困惑

执行pnpm openclaw onboard --install-daemon后，在TUI界面中： - 遇到不确定的选项可以选择skip - 模型选择推荐Deepseek（对国内用户友好） - Token配置会自动保存到~/.openclaw/openclaw.json[ref_1]

服务管理和恢复

网关服务启动

坑点7：重启后服务未自动启动

# 手动启动网关服务 node openclaw.mjs gateway --port 18789 --verbose # 打开管理面板 node openclaw.mjs dashboard

TUI界面恢复

如果配置正常但需要回到命令行界面：

GPT plus 代充 只需 145pnpm start -- tui

原版与cn版本选择

| 特性 | OpenClaw-cn | 原版OpenClaw | |------|-------------|--------------| | 安装方式 | 源码编译 | npm全局安装 | | 语言支持 | 中文汉化 | 英文原版 | | 更新速度 | 可能滞后1-2版本 | 最新版本 | | 依赖管理 | 需要完整构建环境 | 直接npm安装 | | 适用场景 | 需要中文界面 | 追求最新功能 |

# 原版安装命令（备选方案） npm install -g openclaw@latest openclaw --version openclaw onboard --install-daemon

验证安装成功

基础功能测试

启动TUI界面后，发送测试消息："Wake up, my friend!"，应该能得到正常响应。可以进一步测试文件操作等基础功能[ref_1]。

服务状态检查

确保以下服务正常运行： - Gateway服务（端口18789） - 管理面板可访问 - TUI界面响应正常

总结建议

环境准备：确保Node.js ≥ 22，安装最新cmake
网络优化：配置国内镜像源加速下载
问题排查：遇到构建失败先清理缓存再重试
版本选择：根据语言偏好选择cn版或原版
服务管理：了解手动启动命令以备重启需要

遵循以上避坑指南，可以显著提高Mac上安装OpenClaw-cn的成功率。如果某个步骤持续失败，建议尝试备选的原版安装方案。