核心解决方案(从 GitHub 获取)
从官方 GitHub 仓库克隆或下载(首选)

-
仓库地址:
https://github.com/openclaw/OpenClaw -
方法A(推荐给开发者):使用 Git 克隆
git clone https://github.com/openclaw/OpenClaw.git
如果速度慢,可以尝试使用 GitHub 的镜像地址:
git clone https://github.com.cnpmjs.org/openclaw/OpenClaw.git
-
方法B:直接下载 ZIP 包 在仓库页面,点击绿色的 “Code” 按钮,然后选择 “Download ZIP”,将压缩包下载到本地并解压。
GitHub 访问或下载缓慢
- 使用代理:这是解决 GitHub 下载慢最根本的方法。
- 使用 Gitee 镜像(国内速度快):
项目在 Gitee(码云)上通常有同步镜像,搜索 “OpenClaw” 即可找到,下载方式同上。
https://gitee.com/mirrors/OpenClaw(注意:镜像可能更新不及时,但源代码通常可用)
针对不同平台的后续步骤
下载到源代码后,你需要编译才能得到可执行程序,以下是简要指引:
对于 Windows 用户:
- 确保已安装 Visual Studio 2019 或更高版本(社区版即可),并在安装时勾选“使用 C++ 的桌面开发”。
- 使用 CMake(一个生成编译配置的工具)。
下载并安装 CMake: https://cmake.org/download/
- 打开 CMake GUI:
- “Where is the source code:” 选择你下载的 OpenClaw 源代码文件夹。
- “Where to build the binaries:” 创建一个新的子文件夹(
build)。 - 点击
Configure,选择你的 Visual Studio 版本和平台(如x64)。 - 点击
Generate。
- 完成后,打开生成的
build文件夹里的OpenClaw.sln文件,在 Visual Studio 中编译即可。
对于 macOS 和 Linux 用户:
- 确保已安装开发工具链(如
gcc,g++,make,cmake)。- Ubuntu/Debian:
sudo apt install build-essential cmake - macOS: 安装 Xcode Command Line Tools:
xcode-select --install
- Ubuntu/Debian:
- 在终端中进入源代码目录,并执行:
mkdir build && cd build cmake .. make -j4 # “4”代表使用4个CPU核心并行编译,可根据你的CPU调整
- 编译成功后,可执行文件通常会在
build目录中生成。
常见问题排查
-
错误:
Could not find OpenSSL或类似依赖缺失 这是编译时最常见的问题,你需要单独安装项目所需的开发库。- Windows:最方便的方法是使用
vcpkg(一个C++库管理器),按照 OpenClaw 仓库README.md中的说明操作。 - Linux/macOS:使用系统包管理器安装,例如在Ubuntu上可能需要:
sudo apt install libssl-dev libcurl4-openssl-dev
- Windows:最方便的方法是使用
-
我想要现成的安装包/可执行文件 OpenClaw 主要提供源代码,需要用户自行编译,这是开源项目的常见做法,请按照上面的编译步骤操作。
最佳建议
- 仔细阅读项目的
README.md文件:里面通常有最准确、最新的编译和安装指南。 - 查看项目的
Issues:在 GitHub 的 Issues 页面,搜索你遇到的错误信息,很可能已经有解决方案。
总结一下步骤:
- 从 GitHub/Gitee 下载源代码 -> 2. 安装对应平台的编译器和工具(VS/CMake/gcc) -> 3. 安装项目依赖库(如OpenSSL) -> 4. 使用 CMake 生成项目并编译。
如果遇到具体的错误信息,可以提供出来,我能给您更精确的指导,祝您顺利!