源码安装是深度参与OpenClaw开发的唯一方式，需严格校验Python≥3.10、Node.js≥22.0.0、Git，并用pnpm安装依赖、构建UI与主程序，最后注册openclaw命令至系统PATH。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望深度参与 OpenClaw 的开发、调试或定制功能，则源码安装是唯一能完全掌控构建过程与运行时行为的方式。以下是针对 Windows 11、Linux 和 macOS 平台的完整源码安装步骤，覆盖环境准备、依赖拉取、构建执行与命令注册等关键环节：
一、确认并安装必要运行时环境
源码安装要求明确版本的底层工具链，任意一项不满足将导致 pnpm install 或 build 阶段失败。必须严格校验 Python、Node.js 和 Git 的存在性与版本兼容性。
1、检查 Python 版本：在终端中执行 python --version，确保输出为 3.10 或更高版本（推荐 3.11/3.12）；若未安装，请从 Python 官网下载并勾选「Add Python to PATH」。
2、检查 Node.js 版本：执行 node -v，确认输出为 v22.x 或 v24.x（≥22.0.0）；低于该版本需卸载后重装 LTS 或 Current 版本。
3、检查 Git 是否可用：运行 git --version，若提示命令不存在，请前往 git-scm.com 下载 Windows 安装包或通过 Homebrew（macOS）/ apt（Ubuntu）安装。
二、安装 pnpm 并配置全局包管理器
OpenClaw 项目强制使用 pnpm 进行依赖解析与链接，其 monorepo 构建机制依赖 pnpm 的硬链接策略，npm 或 yarn 均不可替代。
1、执行全局安装命令：npm install -g pnpm
2、验证安装成功：pnpm -v 应返回类似 9.7.2 的版本号。
3、（可选）为避免权限问题，建议设置 pnpm store 路径至用户目录：pnpm config set store-dir ~/pnpm-store
三、克隆源码仓库并进入工作目录
源码必须从官方 GitHub 仓库完整拉取，包括 .git 子模块与全部 workspace 配置，直接下载 ZIP 包将缺失构建脚本与版本元数据。
1、创建本地项目根目录，例如：mkdir ~/openclaw-src && cd ~/openclaw-src
2、执行克隆命令：git clone https://github.com/openclaw/openclaw.git .（注意末尾的英文句点）
3、确认当前路径下存在 pnpm-workspace.yaml 与 packages/ 目录，否则克隆不完整。
四、安装项目依赖并完成构建
依赖安装阶段会解析全部 workspace 子包并建立符号链接，构建阶段则生成可执行入口文件与 UI 静态资源，二者缺一不可。
1、运行依赖安装：pnpm install；等待输出中出现 Progress: resolved XXX, reused YYY, downloaded ZZZ 且无 ERROR 行。
2、构建 UI 界面：pnpm ui:build；成功后 dist/ui/ 目录应包含 index.html 及 assets 子目录。
3、构建主程序入口：pnpm build；完成后 dist/entry.js 文件必须存在，大小不为零字节。
五、注册全局命令并验证安装结果
源码构建产物默认不注入系统 PATH，需手动建立软链接或配置 shell 别名，否则执行 openclaw 命令时将报错「command not found」。
1、为 Linux/macOS 用户创建软链接：sudo ln -s $(pwd)/dist/entry.js /usr/local/bin/openclaw
2、为 Windows 用户配置 PATH：将当前目录下的 dist\ 路径添加至系统环境变量 PATH 中。
3、验证命令可用性：openclaw --version 应输出类似 v0.12.4 的语义化版本号；若失败，请检查 dist/entry.js 是否可执行及权限位（Linux/macOS 需 chmod +x）。
