目标:
从源码开始安装,以便有问题可以深入源码了解。
按照官方文档应该是如下几步:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
pnpm openclaw onboard --install-daemon
pnpm gateway:watch
正确的顺序应该是:
1、配置好GITHUB的SSH KEY
因为在安装过程中会通过GIT CLONE一个SSH的仓库。
2、安装npm
sudo apt install npm
如果不在执行pnpm之前做好这一步,会报错。
3、安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
4、安装22以上的node
不要直接sudo apt-get install node,那安装的是18的版本,达不到要求
nvm install node
安装出25的版本
node --version
(base) @ -VMware20-1:~/work/openclaw/openclaw$ node --version
v25.8.1
5、安装pnpm
前面依赖都解决之后,再执行
curl -fsSL https://get.pnpm.io/install.sh | sh -
如果没有安装npm,在执行过程中,会报如下错:
Running npm-install script... ERR_PNPM_PREPARE_PACKAGE Failed to prepare git-hosted package fetched from "git@github.com:tloncorp/api-beta.git
6、执行pnpm install
安装好pnpm就可以执行安装。
这一步遇到过两个问题,分别是GIT的问题和NPM没有安装的问题
如果按上述步骤来,不会再报错。
7、pnpm ui:build
这步没问题
8、pnpm build
这步也没问题
9、pnpm openclaw onboard --install-daemon
这一步也没问题。实际执行起来就是OpenClaw setup,进行配置。
下面的工作就是配置模型之类的事了。
等价于标准安装下的
openclaw configure
10、pnpm gateway:watch
等价于openclaw logs --follow
用于查看日志。
至此,成功。
注意,本地模型选择时不要选deepseek-r1:1.5b,那个还不支持工具调用
可以选择glm
11、修改配置
修改配置位于~/.openclaw/下
~/.openclaw$ vi openclaw.json
12、重启
日常管理,不是直接运行openclaw gateway restart 这类命令了
因为没有安装二进制程序到系统中。
必须先激活pnpm的运行PATH,同时要进入到源码目录。
否则会报找不到包。
例如,我不进我的源码路径执行:
pn openclaw gateway restart
它会报错:" No package.json was found " .因为pnpm运行时要找源码下文件。
重新进目录运行:
(base) -VMware20-1:~/.openclaw$ cd
(base) -VMware20-1:~$ cd work/openclaw/openclaw/
(base) -VMware20-1:~/work/openclaw/openclaw$ pn openclaw gateway restart
修改路径后成功。
以后这个openclaw的源码有何改动,就可以直接应用了。
注:pn是我在.bashrc中设置的别名
alias pn=pnpm