OpenClaw 安装教程

系统要求

Node.js 18+
Linux / macOS / Windows (WSL)
PostgreSQL 14+
域名（可选，用于外网访问）

第一步：安装 Node.js

建议使用 nvm 管理 Node.js 版本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22

第二步：安装 PostgreSQL

sudo apt update
sudo apt install postgresql postgresql-contrib

sudo systemctl start postgresql
sudo systemctl enable postgresql

第三步：创建数据库和用户

sudo -u postgres psql
CREATE DATABASE openclaw;
CREATE USER openclaw_user WITH ENCRYPTED PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE openclaw TO openclaw_user;
\q

第四步：安装 OpenClaw CLI

npm install -g openclaw
openclaw init my-assistant
cd my-assistant

第五步：配置环境变量

编辑 .env 文件：

DATABASE_URL=postgres://openclaw_user:your_password@localhost:5432/openclaw
PAYLOAD_SECRET=your-random-secret-key-here
PORT=3000
CMS_URL=http://localhost:3000

第六步：启动服务

openclaw start
# 或开发模式
openclaw dev

访问 http://localhost:3000/admin 即可进入管理界面。

常见问题

数据库连接失败

检查 PostgreSQL 是否运行：

sudo systemctl status postgresql

端口被占用

修改 .env 中的 PORT 值，或停掉占用端口的进程：

lsof -i :3000
kill -9 <PID>

外网无法访问

使用 Nginx 反向代理 + Let's Encrypt SSL 证书。

下一步

配置你的第一个 Channel（Discord / Telegram / WhatsApp），开始使用你的 AI 助手！

OpenClaw 安装教程：一步步搭建你的 AI 个人助手