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

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

安装方式概览

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

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

方式一：Docker安装（推荐）

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

安装命令

# 拉取镜像docker pull openclaw/openclaw-gateway:latest# 运行容器docker run -d --name openclaw \  -p 18789:18789 \  -v ~/.openclaw:/root/.openclaw \  openclaw/openclaw-gateway

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

参数说明

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

升级步骤

# 拉取新版本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用不了的环境，或者想直接跑进程的时候。

安装步骤

# 下载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

安装后确认

# 看端口是否在监听ss -tlnp | grep 18789# 看进程是否在跑ps aux | grep openclaw# 测试接口curl -s http://localhost:18789 | head -5

升级步骤

# 下载新版本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

方式三：源码编译

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

编译步骤

# 克隆仓库git clone https://github.com/openclaw/openclaw.gitcd openclaw# 安装依赖npm install# 编译npm run build# 运行./openclaw gateway

什么情况下选择源码

代价

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

安装后的检查

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

第一步：看端口

ss -tlnp | grep 18789

看到LISTEN说明Gateway在运行。

第二步：看Web界面

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

第三步：看日志

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

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

常见问题

端口被占用

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

{"port": 18790}

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

Docker挂载目录不能少

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

权限问题

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

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

防火墙不放行

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

# 检查防火墙状态（Ubuntu/Debian）ufw status# 放行端口ufw allow 18789/tcp

FAQ

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

A：三步排查：

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

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

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

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

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

总结

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

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

下一篇预告

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

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

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

📌 觉得有用？点个「在看」 👇 👨‍💻 关注「敏叔侃技术」，每周更新 OpenClaw 实战干货 ⭐ **收藏这篇文章，作为安装部署参考