第02篇-三种方式安装和启动OpenClaw

〖OpenClaw系列〗三种方式安装和启动OpenClaw

上篇回顾

第1篇我们讲了AI网关的核心设计------Gateway做路由、Agent做任务、Skill做能力、Channel做接入。现在你知道OpenClaw是什么了，这篇讲怎么把它装起来。

安装方式概览

安装OpenClaw有三种方式，看你是什么场景选什么：

方式	难度	适合场景	升级方式
Docker	★☆☆	大多数用户，个人开发者	docker pull重启
二进制	★★☆	没有Docker的服务器	下载替换二进制
源码编译	★★★	开发者、想改源码	git pull重新编译

建议：第一次用选Docker。用熟了想折腾了，再换二进制或源码。

方式一：Docker安装（推荐）

最简单、最省事的方式。适合大多数用户。

安装命令

bash 复制代码

# 拉取镜像
docker pull openclaw/openclaw-gateway:latest

# 运行容器
docker run -d --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw-gateway

启动后用浏览器打开 http://localhost:18789，看到控制台界面就算装好了。

参数说明

参数	作用	能不能改
`-p 18789:18789`	端口映射	可以改端口
`-v ~/.openclaw:/root/.openclaw`	配置文件持久化	路径可以改
`--name openclaw`	容器名	可以改

⚠️ -v 这行不能少。少了的话，重启容器后配置就丢了。

升级步骤

bash 复制代码

# 拉取新版本
docker pull openclaw/openclaw-gateway:latest

# 停止旧容器
docker stop openclaw

# 删除旧容器
docker rm openclaw

# 重新运行（命令同上）
docker run -d --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw-gateway

升级步骤就四步，跟重装差不多。

方式二：二进制安装

Docker用不了的环境，或者想直接跑进程的时候。

安装步骤

bash 复制代码

# 下载
wget https://github.com/openclaw/openclaw/releases/latest/download/openclaw-linux-amd64.tar.gz

# 解压
tar xzf openclaw-linux-amd64.tar.gz

# 加执行权限
chmod +x openclaw

# 运行
./openclaw gateway

安装后确认

bash 复制代码

# 看端口是否在监听
ss -tlnp | grep 18789

# 看进程是否在跑
ps aux | grep openclaw

# 测试接口
curl -s http://localhost:18789 | head -5

升级步骤

bash 复制代码

# 下载新版本
wget https://github.com/openclaw/openclaw/releases/latest/download/openclaw-linux-amd64.tar.gz

# 停旧进程
pkill openclaw

# 替换文件
tar xzf openclaw-linux-amd64.tar.gz

# 启动
./openclaw gateway

方式三：源码编译

想自己改代码，或者想体验未发布的功能时。

编译步骤

bash 复制代码

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
npm install

# 编译
npm run build

# 运行
./openclaw gateway

什么情况下选择源码

场景	说明
改代码	你想自己改OpenClaw的代码
体验新功能	你想体验最新的代码（还没有发版）
调试	你调试时想加一些自己的日志

代价

编译需要Node.js环境和npm包，第一次下载比较久
升级要手动git pull重新编译
不建议生产环境用源码跑

安装后的检查

装完别急着关，先确认Gateway正常。三步检查：

第一步：看端口

bash 复制代码

ss -tlnp | grep 18789

看到LISTEN说明Gateway在运行。

第二步：看Web界面

浏览器打开 http://localhost:18789，看到登录界面。

第三步：看日志

bash 复制代码

tail -20 ~/.openclaw/logs/gateway-stderr.log

没有ERROR级别的日志就算正常。

常见问题

端口被占用

如果18789已被其他程序占用，可以在openclaw.json里改端口：

json 复制代码

{
  "port": 18790
}

改了端口后，浏览器访问也要用新端口。

Docker挂载目录不能少

-v ~/.openclaw:/root/.openclaw 是最容易漏掉的一行。少了这行的话，容器重启后所有的配置都会丢失------因为新容器用的是新的空目录。

权限问题

如果以普通用户运行二进制文件，确保 ~/.openclaw 目录对当前用户可写。

bash 复制代码

mkdir -p ~/.openclaw
chmod 755 ~/.openclaw

防火墙不放行

云服务器的话，检查安全组/防火墙是否放行了18789端口。有些云服务商默认只放行22和80端口。

bash 复制代码

# 检查防火墙状态（Ubuntu/Debian）
ufw status

# 放行端口
ufw allow 18789/tcp

FAQ

Q：装好了，但浏览器访问不了，怎么办？

A：三步排查：

ss -tlnp 确认端口监听
防火墙是否放行
如果用的是云服务器，安全组规则是否开放了端口

Q：Docker和二进制哪个更适合新手？

A：Docker。因为升级方便，配置挂载后也不容易丢。

Q：可以装在树莓派或低配VPS上吗？

A：可以。OpenClaw本身资源消耗很低（内存<100MB）。但跑大模型需要额外配置Ollama或API Key。

总结

本文介绍了三种安装方式：

方式	难度	适合场景	关键注意点
Docker	低	大多数用户	别忘了 `-v` 挂载
二进制	中	无Docker环境	注意权限和防火墙
源码	高	开发者	不建议生产使用

安装后必做：端口检查、Web界面检查、日志检查。

下一篇预告

第3篇：配置文件 openclaw.json 详解

装好了，下一步是配置------openclaw.json里每一行是干什么的。

本文是系列第2篇。你已掌握 OpenClaw 的安装方法。

📌 觉得有用？点个「在看」 👇

👨‍💻 关注「敏叔侃技术」 ，每周更新 OpenClaw 实战干货

⭐ **收藏这篇文章，作为安装部署参考