O
OpenClaw
首页博客关于文档社区
O
OpenClaw

OpenClaw - 你的AI助手平台。连接AI能力,让工作更高效,生活更有趣。

导航

  • 首页
  • 博客
  • 关于
  • 文档
  • 社区

资源

  • GitHub
  • Discord
  • 使用文档
© 2026 OpenClaw. All rights reserved.Powered by OpenClaw & Next.js
返回首页
技术

Ubuntu/Debian 系统安装 OpenClaw 完整指南

技
技术老炮
2026年3月19日
|
0 阅读
|
2 分钟阅读
分享:

# Ubuntu/Debian 系统安装 OpenClaw 完整指南


本教程详细介绍如何在 Ubuntu 20.04+ 或 Debian 11+ 系统上安装 OpenClaw AI 助手平台


环境要求


  • Ubuntu 20.04+ 或 Debian 11+
  • 2GB+ RAM
  • 20GB+ 可用磁盘空间
  • Node.js 18+
  • PostgreSQL 14+ (可选,用于生产环境)

第一步:更新系统


bash
sudo apt update && sudo apt upgrade -y

第二步:安装 Node.js


bash
# 安装 Node.js 20.x
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node --version  # 应该显示 v20.x.x
npm --version

第三步:安装 PostgreSQL (可选)


bash
sudo apt install -y postgresql postgresql-contrib
sudo systemctl start postgresql
sudo systemctl enable postgresql

# 创建数据库
sudo -u postgres createuser -s openclaw
sudo -u postgres createdb openclaw
sudo -u postgres psql -c "ALTER USER openclaw WITH PASSWORD 'your_password';"

第四步:克隆并安装 OpenClaw


bash
# 克隆项目
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
npm install

# 复制环境配置
cp .env.example .env

# 编辑配置文件,设置数据库连接等
nano .env

第五步:配置 .env 文件


env
DATABASE_URL=postgresql://openclaw:your_password@localhost:5432/openclaw
JWT_SECRET=your-secret-key-change-this
AI_PROVIDER=openai
OPENAI_API_KEY=your-api-key

第六步:初始化数据库


bash
# 生成 Prisma 客户端
npx prisma generate

# 同步数据库结构
npx prisma db push

# 可选:填充种子数据
npx prisma db seed

第七步:启动服务


bash
# 开发模式
npm run dev

# 或生产模式
npm run build
npm start

第八步:使用 PM2 保持运行 (推荐)


bash
# 安装 PM2
sudo npm install -g pm2

# 启动应用
pm2 start npm --name "openclaw" -- start

# 设置开机自启
pm2 startup
pm2 save

验证安装


浏览器访问 http://your-server-ip:3000 应该能看到 OpenClaw 界面。


常见问题


端口被占用


bash
# 查看端口占用
sudo lsof -i :3000
# 或修改 .env 中的 PORT

数据库连接失败


检查 .env 中的 DATABASE_URL 是否正确,以及 PostgreSQL 服务是否运行。


---


下一篇文章:CentOS/RHEL 系统安装指南

标签

#OpenClaw#Ubuntu#Debian#安装教程#Linux

相关文章

CentOS/RHEL 系统安装 OpenClaw 指南

# CentOS/RHEL 系统安装 OpenClaw 指南 > 本教程详细介绍如何在 CentOS Stream 9 或 RHEL 9 上安装 OpenClaw ## 环境要求 - CentO

2026-03-20

Windows WSL2 安装 OpenClaw 教程

在 Windows 11/10 上通过 WSL2 Ubuntu 安装 OpenClaw 的详细教程,适合开发环境。

2026-03-20

macOS 安装 OpenClaw 指南

# macOS 安装 OpenClaw 指南 > 在 Mac 上安装 OpenClaw AI 助手平台 ## 环境要求 - macOS 12 (Monterey) 或更高版本 - 4GB+ RA

2026-03-20
上一篇

Next.js 15 新特性解析

下一篇

CentOS/RHEL 系统安装 OpenClaw 指南

订阅博客更新

通过 RSS 订阅,及时获取最新文章

RSS 订阅链接
返回文章列表

评论 (0)

发表评论

0/1000