本文涵盖环境准备、源码安装、自启动配置与基础配置要素说明，以及可能遇到的问题总结，适合喜欢全盘掌控自己管理程序安装的小伙伴，其中包含mac和Linux系统操作说明。
注：如果是想快速尝鲜可以不考虑各类工具安装位置和环境变量配置，直接命令安装即可，本文不赘述，基本自行命令安装 Node.js ≥ 22 + Git 即可 核心安装和初始化命令：
建议将 Node、Git、pnpm、Python 等安装在用户目录下，并通过统一的环境变量文件管理 PATH 与 OpenClaw 相关变量，以便控制权限和影响范围，避免污染系统路径、便于全局把控与排查。
0.1 约定目录结构（示例）
在用户目录下单独划一块“运行时/工具”目录，例如：
OpenClaw 运行数据与日志单独放到一个“数据目录”，便于备份与排错：
0.2 安装 Node.js（用户目录，≥22）
方式 A：官方二进制解压到用户目录（不依赖 root）
方式 B：nvm / fnm（推荐，便于多版本，如果不用多版本不需要安装）
nvm 和通过 nvm 安装的 Node 都在用户目录下，不写系统目录、无需 root：
- nvm 自身：安装在 （安装脚本默认即如此）
- Node版本：通过 安装的 Node 在 下，由 nvm 统一管理、切换。
0.3 安装 Git、pnpm、Python（用户目录或 PATH 优先）
- Git：若系统已有且版本够用，可直接用；否则可从源码或官方包安装到 ，并将 加入 PATH。
- Corepack：pnpm openclaw 安装 由 Node 自带的 corepack 管理，可执行文件在当前 Node 的 bin 目录里（与 、 同目录）。不会自动改你的 shell 配置：需要把 Node 的 bin 目录 加入 PATH（例如解压到 时加 ）， 才能用。若 Node 是系统包管理器或 nvm 装的，通常已配好 PATH；若是手动解压 Node，需自己在 里加 Node 的 bin。
- 独立脚本：默认安装到用户目录（如 ），脚本会在安装结束时把 和对应 bin 写入 / ，即会自动配置 PATH；新开终端即可用。
- Python（可选）：部分构建/插件可能需要；可用 pyenv 安装到 ，或官方安装包指定用户目录，并将 加入 PATH。
pnpm：在已安装 Node 的前提下，用 Corepack 或 独立脚本，均在用户目录下，不写系统目录：
0.4 统一环境变量文件（控制权限与影响范围）
在用户目录下建一个仅本机使用的环境变量文件，所有 OpenClaw 与工具链相关变量集中在此，便于自启动与终端一致、全局把控。
创建并编辑（路径可自定，下面以 为例）：
在 shell 配置中加载，使交互式终端与脚本使用同一套环境：
之后新开终端即生效；自启动服务也会在下面第二节中通过 EnvironmentFile（systemd）或 EnvironmentVariables（launchd）加载同一文件，保证与终端一致、权限与影响范围可控。
.openclaw.env 与 .zshrc 的使用方式（是否需要每次加载）
方式说明
~/.openclaw.env： 只放环境变量（PATH、OPENCLAWSTATEDIR、OPENCLAWCONFIGPATH 等），供终端与守护进程共用。
~/.zshrc（或 /.bashrc）：Shell 配置：在这里写 `source/.openclaw.env`，并放补全、OpenClaw 命令补全等；不要把补全或 shell 命令写进 .openclaw.env。
需要每次都手动加载吗？不需要。 每次你新开一个终端，zsh 会自动执行 ，里面的 会把环境变量加载好，无需再打 。守护进程（Gateway）：通过 安装后，launchd/systemd 会在进程启动时读取环境（例如从 .openclaw.env），也是自动的。只有这两种情况需要手动执行一次 ：
在当前已打开的终端里刚改过 ，希望本终端立即生效；
在脚本里跑 openclaw，且该脚本不会读 .zshrc（例如 cron、某些 CI），需在脚本开头加 。
日常开新终端即可，环境变量会自动带上；改过 .openclaw.env 且想在本终端立刻生效时，再执行一次 。
0.5 初始化数据目录与统一 logs 目录
首次使用前创建状态目录并统一日志到 logs 子目录（便于排查）：
说明： 守护进程（launchd/systemd）会把 Gateway 的 stdout/stderr 重定向到 和 （见第二节）。若还需将 Gateway 的文件日志（JSONL）也落到同一
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/283950.html原文链接：https://javaforall.net
