OpenClaw的安装全过程(从0到1)

 

不走容器技术,直接纯净安装。

说真的还挺费劲的!!!!我看小红书上有人发帖说上门安装一次500元。

现在想想,真要从0安装还真的会遇到各种问题。

这里我采用的vultr家的产品,安装的系统是Ubuntu 22或者24均可。虽然Debian更简洁一些,但是openclaw官方的建议是采用ubuntu。

https://www.vultr.com/?ref=9639205-9J

你可以通过上面链接注册,也许有300美元的赠送券。

大体的VPS,默认是2GB内存是至少的,4GB勉强能跑一些任务,但是稍微大一些的,我觉得还是建议用8GB内存为好,我用的是8GB的内存。

Press enter or click to view image in full size

我分3个大步骤:

1.操作系统基础安装 ; 2.OpenClaw安装 ; 3.API key设置

Ubuntu系统安装基础框架

第一步:安装基础依赖:

sudo apt updatesudo apt install -y curl git build-essential ca-certificates
Press enter or click to view image in full size

第二步:安装nvm

我有好几次直接安装脚本,装不上,主要是nodejs居然找不到,或安装报错。

所以直接自己用nvm安装省事。官方Node下载明确提示,很多三方脚本都不是官方在维护的,而且openclaw要求node>=22.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

然后让它立即生效

```bashexport NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

如果你用的是 bash,也可以写进配置文件:

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrcecho '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrcecho '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> ~/.bashrcsource ~/.bashrc
Press enter or click to view image in full size

第三步,用nvm安装Node 22或者24

nvm install 22nvm use 22nvm alias default 22

完成后,顺便检查一下,实际否显示v22.x.x的字样。

node -vnpm -v

安装OpenClaw

npm install -g openclaw@latest
Press enter or click to view image in full size

上面的警告信息可以不管。

直接测试执行命令:

openclaw --version
Press enter or click to view image in full size

有显示版本就是对的,我这边是2026.2.26.

开始配置openclaw

openclaw configure
Press enter or click to view image in full size

这里local ,直接按回车键。

这里也直接回车,选择workspace.

这里路径别去修改,直接回车。

这里配Model,用键盘的上下左右来选择,光标移动到Model后回车。

默认我也只用openai,虽然后面我发现claude才是openclaw的最爱,不过还是先选openai吧。

这里我选择openai codex,其实我这里应该可能不是最佳选择,我用令牌获取。

Press enter or click to view image in full size

把这里的很长一串网址复制到本地浏览器,然后授权打开。

打开后会有一个localhost的地址。

把那个地址复制回来,然后再粘贴进去,再回车。

http://localhost:1455/auth/callback?code=ac_nnX2YwuYY4OdpwYh5uK8v5BkEFC4AH3RyUCqiwVNDGE.iNiZ7-wujm60wSwqLDXkCBiSVDJoTHLHFiIUWnQvRYY&scope=openid+profile+email+offline_access&state=一串key

回传网址大致如上。

Press enter or click to view image in full size

好,现在进入模型的选择。

Press enter or click to view image in full size

直接输入gpt-5

Press enter or click to view image in full size

会自动个搜索,然后找到openai/gpt-5

Become a Medium member

找到后按一次Tab键,让它被选中。

Press enter or click to view image in full size

现在把光标移动到最底部的continue,然后回车。

Press enter or click to view image in full size

好了,安装配置完成了。

openclaw doctor

执行一下做一下配置检查。

Press enter or click to view image in full size

这里选YES

Press enter or click to view image in full size

继续YES

Press enter or click to view image in full size

再次YES

Press enter or click to view image in full size

还是YES

Press enter or click to view image in full size

这里保持默认继续回车。

Press enter or click to view image in full size

这里doctor完成了,做一下检查。

openclaw gateway status
Press enter or click to view image in full size

API key设置

现在我们可以用电脑本地终端来建立一个SSH隧道,然后再用浏览器访问。

先说win自带的powershell的命令:

ssh -N -L 18789:127.0.0.1:18789 root@207.148.92.216

我实际执行,遇到了一些问题。

一直卡住了。

我后面采用xshell来建立。

Press enter or click to view image in full size

这里的设置规则如上。

这个方式比较简单,还不容易错。

完成设置后,就确定一下。

而且底部有转移规则,你可以确认一下,是否在端口转发。

然后就是在浏览器打开网址:

http://localhost:18789/#token=你的token
Press enter or click to view image in full size

打开后,发一个hello看看。

Press enter or click to view image in full size

出现了失败。

在这里的过程,我费了很大的劲。

左侧agent:

Press enter or click to view image in full size

这里直接点击左下角的RAW

我是直接改了这里的JSON文件:

{  "meta": {    "lastTouchedVersion": "2026.2.26",    "lastTouchedAt": "2026-02-28T10:53:34.866Z"  },  "wizard": {    "lastRunAt": "2026-02-28T10:00:21.943Z",    "lastRunVersion": "2026.2.26",    "lastRunCommand": "doctor",    "lastRunMode": "local"  },  "agents": {    "defaults": {      "model": "openai/gpt-5",      "models": {        "openai/gpt-5": {}      },      "workspace": "/root/.openclaw/workspace",      "compaction": {        "mode": "safeguard"      },      "maxConcurrent": 4,      "subagents": {        "maxConcurrent": 8      }    }  },  "messages": {    "ackReactionScope": "group-mentions"  },  "commands": {    "native": "auto",    "nativeSkills": "auto",    "restart": true,    "ownerDisplay": "raw"  },  "gateway": {    "mode": "local",    "auth": {      "mode": "token",      "token": "__OPENCLAW_REDACTED__"    }  }}

还有就是在认证的地方,也是采用RAW格式,复制进去,我以openai为例。

Press enter or click to view image in full size
{  "meta": {    "lastTouchedVersion": "2026.2.26",    "lastTouchedAt": "2026-02-28T11:13:40.515Z"  },  "wizard": {    "lastRunAt": "2026-02-28T10:00:21.943Z",    "lastRunVersion": "2026.2.26",    "lastRunCommand": "doctor",    "lastRunMode": "local"  },  "auth": {    "profiles": {      "openai-default": {        "provider": "openai",        "mode": "api_key"      }    }  },  "agents": {    "defaults": {      "model": "openai/gpt-5",      "models": {        "openai/gpt-5": {}      },      "workspace": "/root/.openclaw/workspace",      "compaction": {        "mode": "safeguard"      },      "maxConcurrent": 4,      "subagents": {        "maxConcurrent": 8      }    }  },  "messages": {    "ackReactionScope": "group-mentions"  },  "commands": {    "native": "auto",    "nativeSkills": "auto",    "restart": true,    "ownerDisplay": "raw"  },  "gateway": {    "mode": "local",    "auth": {      "mode": "token",      "token": "__OPENCLAW_REDACTED__"    }  }}

保存一下。

然后,关键的一步,把openai api key写进ubuntu的环境变量。

nano /root/.bashrc
Press enter or click to view image in full size
Press enter or click to view image in full size

最后一行是这样的。

至于openai的API key如何获取,你问问AI吧,这个很简单。

官网登进去就有。

在下面,就新起一行,输入:

export OPENAI_API_KEY="你的OpenAI_API_Key"
Press enter or click to view image in full size

下一步,让这个key立即生效。

执行:

source /root/.bashrc

执行完后,再执行这一条检查一下

echo $OPENAI_API_KEY
Press enter or click to view image in full size

就这样会显示一条长长的key。

现在先让 OpenClaw 的 gateway服务也读到这个环境变量。
在 Ubuntu 终端里,按顺序执行这两条:

systemctl --user import-environment OPENAI_API_KEYsystemctl --user restart openclaw-gateway

执行完后,看一下状态

openclaw gateway status

现在再去OpenClaw聊天页,随便去发一条信息,测试一下:

Press enter or click to view image in full size

这里有一些错误是历史消息。

但是

Press enter or click to view image in full size

这里显示的是API没有额度了。

主要是API是单独计费的,我里面没有充值。

但是实际上是可以用的。

但是openai的API费用挺贵的,我接下来是寻找国内的AI接口来替代一下。

有好多家是有免费额度的,用免费的额度先顶着。

评论