Ubuntu 服务器一键部署 OpenClaw 完整教程

Ubuntu 服务器一键部署 OpenClaw 完整教程

引言

在 AI Agent 蓬勃发展的今天，OpenClaw 作为一款开源的 AI 代理框架，正在被越来越多的开发者关注。它能帮助我们快速构建智能代理应用，但很多新手在部署时会遇到各种环境问题。本文将手把手教你如何在 Ubuntu 服务器上完成 OpenClaw 的一键部署，30 分钟即可上线运行。

一、环境准备

首先登录你的 Ubuntu 服务器（建议 Ubuntu 20.04 或更高版本），执行以下命令更新系统并安装依赖：

# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装 Docker（OpenClaw 采用容器化部署）
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

# 安装 Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/v2.23.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

如果服务器在国内，建议配置 Docker 镜像加速。在 /etc/docker/daemon.json 中添加：

{
  "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}

然后重启 Docker 服务：

sudo systemctl daemon-reload
sudo systemctl restart docker

二、安装配置 OpenClaw

环境准备好后，克隆 OpenClaw 项目并进入目录：

git clone https://github.com/easyon-the-claw/openclaw.git
cd openclaw

复制配置文件并修改必要的参数：

cp config.example.yaml config.yaml
nano config.yaml

配置文件中最关键的是模型接入部分。以 OpenAI 为例，配置如下：

model:
  provider: openai
  api_key: your-api-key-here
  base_url: https://api.openai.com/v1
  model: gpt-4-turbo

server:
  host: 0.0.0.0
  port: 8080

如果你使用的是国内模型（如通义千问、文心一言），只需修改 provider 和 base_url 参数即可。OpenClaw 对国内模型有良好的兼容性。

三、反向代理与开机自启

为了让外部访问更加便捷，我们使用 Nginx 做反向代理。首先安装 Nginx：

sudo apt install nginx -y

创建 Nginx 配置文件：

sudo nano /etc/nginx/sites-available/openclaw

添加以下内容：

server {
    listen 80;
    server_name your-server-ip;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

启用配置并重启 Nginx：

sudo ln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

最后，设置 Docker 容器开机自启。修改 docker-compose.yml 文件，在服务配置中添加 restart: always：

services:
  openclaw:
    image: openclaw:latest
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - ./config.yaml:/app/config.yaml

现在启动服务：

docker-compose up -d

检查运行状态：

docker-compose ps
docker-compose logs -f

如果一切正常，访问 http://你的服务器IP 即可看到 OpenClaw 的 Web 界面。

总结

本文详细介绍了在 Ubuntu 服务器上部署 OpenClaw 的完整流程，包括环境准备、Docker 安装、配置文件修改、Nginx 反向代理以及开机自启设置。整个过程不需要复杂的操作，按照步骤执行即可。

部署完成后，你拥有了一个运行在服务器上的 AI Agent 基础框架。但要让它真正具备自主决策和任务闭环能力，还需要为它配备一个强大的"大脑"——ClawBrain。这是专为 OpenClaw 打造的智能决策引擎，能够实现任务规划、错误自愈和自主学习，让你的龙虾不再只是执行单一命令的工具，而是能够独立思考、完成复杂任务的智能助手。