前缀、文档修改记录

20260315 初始化编辑此文章

章节1、需求描述

就是记录一下openclaw的部署，插件安装，功能使用

章节2、openclaw的部署

2.1、 资源规格

因为是个人需求，我这里，使用的2C 4G 60G SSD的规格的虚拟机，带宽有3Mbps应该足够了，保持24小时开机运行，操作系统选择Ubuntu 24.04 或者 Debian 13 。

本篇教程使用Debian最新版本的 ubuntu-24.04.4-live-server-amd64.iso 系统。

2.2、资源部署（Docker方式，推荐）

Docker方式的部署，对于新手村的人，可能更友好一点，故而优先介绍这个方式的部署。

用Docker方式部署，自然先部署docker容器环境。

部署docker环境

root@server#  curl -fsSL https://get.docker.com | sh

创建并进入 Openclaw 工作目录，获取项目文件。为了安全性，建议用普通用户执行。

user@server$  mkdir openclaw && cd openclaw
user@server$  git clone https://github.com/openclaw/openclaw.git .

环境变量的配置

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