OpenClaw本地部署安装手册

OpenClaw本地部署与入门实操经验分享

提起OpenClaw，它的功能和定位想必大家已经耳熟能详，网上的解读足够详尽。今天，咱们不聊概念，直接上干货——重点分享我在本地部署过程中趟过的路、踩过的坑，以及最终验证可行的完整操作流程。希望能帮你绕过那些恼人的报错，顺利把环境搭起来。

我的安装环境（已验证可用）

为了给你一个清晰的参考，先亮出我本次成功部署的“底牌”：

硬件是一台Mac笔记本，搭载Apple M3芯片，内存15.6GB。软件环境方面，Node.js版本为v22.220，包管理工具npm版本为v10.9.4。在这个组合下，后续的所有步骤都畅通无阻。

安装OpenClaw

安装过程有几个关键点，顺序错了或者权限没给够，很容易卡壳。咱们一步一步来。

1、配置npm全局权限

这一步至关重要！如果直接照着网上某些教程执行安装或运行install.sh，十有八九会因为权限问题失败。解决之道，是为npm配置一个你有完全控制权的全局安装路径。

打开终端，依次执行以下命令：

# 创建全局目录
mkdir -p ~/.npm-global

# 配置 npm 全局路径
npm config set prefix '~/.npm-global'

# 将全局路径加入环境变量（永久生效）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc

# 生效环境变量
source ~/.zshrc

这相当于给npm开了个“绿色通道”，后续的全局安装命令就能顺畅执行了。

2、执行安装OpenClaw

权限搞定后，就可以开始安装本体了。为了提高下载速度，建议先切换到国内镜像源。

# 先设置国内镜像，后执行安装
npm config set registry HTTPS://registry.npmmirror.com/

# 执行安装
npm install -g openclaw@latest

这里有个常见的“坑”需要留意：如果你的本地环境没有配置GitHub的SSH密钥认证，安装过程中克隆依赖库时会失败。别慌，有个简单的临时解决方案，将Git的克隆方式从SSH切换为HTTPS即可。

# 全局配置 Git：将 SSH 地址替换为 HTTPS（仅本次生效，不影响其他操作）
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"

# 重新安装 openclaw
npm install -g openclaw@latest

接下来，就是耐心等待安装完成。怎么确认成功了呢？在终端输入版本查询命令：

openclaw --version

如果屏幕上像这样显示出了版本号（例如2026.3.2），那么恭喜你，核心安装工作已经大功告成。

小结

回顾一下，整个安装环节有三个有效动作：首先，为npm配置专属的全局路径，解决了权限痛点；其次，设置国内镜像源，大幅提升下载效率；最后，针对Git认证问题，灵活地将SSH地址临时替换为HTTPS协议。这三步做到位，安装过程基本就稳了。

启动与模块配置

安装只是第一步，如何启动并进行后续的模块配置，直接关系到是否能真正用起来。这部分内容我们留到下一章节详细展开。

参考资料：

[1]: https://openclaw.ai
[2]: https://github.com/openclaw/openclaw/