前缀、文档修改记录
20260315 初始化编辑此文章 20260316 更新内容 20260317 更新内容 未完待续
章节1、需求描述
就是记录一下openclaw的部署，插件安装，功能使用
官网： https://openclaw.ai
章节2、openclaw的部署过程
2.1、 资源规格
因为是个人需求，我这里，使用的2C 4G 60G SSD的规格的虚拟机，带宽有3Mbps应该足够了，保持24小时开机运行，操作系统选择Ubuntu 24.04 或者 Debian 13 。
本篇教程使用Ubuntu最新版本的 ubuntu-24.04.4-live-server-amd64.iso 系统。
2.2、 官方安装推荐
根据官方最新的安装推荐指南，目前，openclaw支持一键安装，自备水管通github/nodejs的资源才能正常运行哦。
zhangsan@server$ curl -fsSL https://openclaw.ai/install.sh | bash
= = 分割线 = = = = =
= = 分割线 = = = = =
= = 分割线 = = = = =
= = 分割线 = = = = = 教材已根据官网更新
2.2、资源部署（Docker方式，推荐）
Docker方式的部署，对于新手村的人，可能更友好一点，故而优先介绍这个方式的部署。
用Docker方式部署，自然先部署docker容器环境。
部署docker环境，建议根据你实际的操作系统版本，根据官方教材安装，参考 https://docs.docker.com/engine/install/ubuntu/ ，可选官方的一键脚本，或者手工分步执行
一键脚本：
root@server# curl -fsSL https://get.docker.com | sh
分步执行
// 注释 Add Docker's official GPG key:
root@server# apt update
root@server# apt install ca-certificates curl
root@server# install -m 0755 -d /etc/apt/keyrings
root@server# curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
root@server# chmod a+r /etc/apt/keyrings/docker.asc
// 注释 Add the repository to Apt sources:
root@server# tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF
// 注释 再次更新
root@server# apt update
// 注释 安装最新版本docker-ce
root@server# apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
本次测试环境安装到的版本 docker-ce (5:29.3.0-1~ubuntu.24.04~noble) 时间戳202603162208
测试是否安装成功：
root@server# docker version root@server# docker run hello-world
将常用的用户加到用户组里，通过将用户 zhangsan 加入 docker 组，该用户就获得了与 Docker 守护进程通信的同等权限，后续方便用zhangsan用户执行相关docker命令。
root@server# usermod -aG docker zhangsan
参数 -a ：Append（追加）。极其重要！它确保将用户添加到新组时，不会从现有的其他组中移除。 参数 -G ：Groups。后面跟着的是目标用户组的名字。
Docker服务的相关启动/重启/开机自动启动
root@server# systemctl daemon-reload root@server# systemctl restart docker root@server# systemctl enable docker
2.3、 Openclaw部署
创建并进入 Openclaw 工作目录，获取项目文件。为了安全性，建议用普通用户执行。
zhangsan@server$ mkdir openclaw && cd openclaw zhangsan@server$ git clone https://github.com/openclaw/openclaw.git .
获取对应的容器镜像
root@server# docker pull alpine/openclaw:latest
环境变量的配置
cp .env.example .env
必须配置的关键项： API_KEY: 您的 LLM 提供商密钥（如 元宝，豆包，Claude，OpenAI）。 BASE_URL: 如果使用代理（如 OpenRouter 或国内中转），请在此填写。 ADMIN_PASSWORD: 进入 Web 管理面板的初始密码。
启动openclaw，使用 Docker Compose 启动，创建或检查目录下的 docker-compose.yml 文件。一个典型的配置如下
services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw
ports:
- "3000:3000"
volumes:
- ./data:/app/data
- .env:/app/.env
restart: always
执行启动
docker compose up -d
如果需要检查执行日志
docker logs -f openclaw
访问面板： 在浏览器中输入 http://服务器IP:3000
安全提示： 如果无法访问，请检查云服务器的 安全组/防火墙 是否已放行 3000 端口。
权限问题： 如果挂载的 ./data 文件夹无法写入，请执行 chmod -R 777 ./data。
数据库重置： 如果遇到数据库版本冲突，通常可以通过删除 ./data/db.sqlite 并重启容器解决。
浏览器组件： 如果您使用了需要自动化 UI 的插件，确保镜像版本包含 playwright 驱动，否则会出现“Browser not found”错误。
2.3、资源部署（物理系统方式）
附录1、视频操作演示
附录2、@Dasmz
博客内，所有教程为手打原创教程，如果技术教程对您有所帮助，欢迎打赏作者。技术层面，闻道有先后，如有疏漏、错误，欢迎指正。技术博客的内容，一般具有一定的环境依赖，具有一定的年代依赖，酌情参考其中的内容，请勿完全照搬照抄。
对于博客内已提及的专业知识，如果需要技术指导，欢迎联系我，仅需支付工时费
Twitter: Dasmz
Youtube: @DasmzStudio
Telegram: @Dasmz
附录3、其他信息
如果要限定安装某个特定版本的docker-ce，则如下执行：
// 注释 安装某个特定版本docker-ce root@server# apt list --all-versions docker-ce docker-ce/noble 5:29.2.1-1~ubuntu.24.04~noble <arch> docker-ce/noble 5:29.2.0-1~ubuntu.24.04~noble <arch> root@server# VERSION_STRING=5:29.2.1-1~ubuntu.24.04~noble root@server# apt install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin
