OpenClaw 安装完整指南：从零开始搭建你的 AI Agent
OpenClaw 安装完整指南：从零开始搭建你的 AI Agent
想要体验 OpenClaw 的强大功能吗？本文将提供详细的安装指南，帮助你在各种环境下成功部署 OpenClaw。无论你是选择 Docker 部署还是直接安装，都能找到适合你的方案。
环境要求
在开始安装之前，请确保你的系统满足以下要求：
最低配置
- CPU：2 核心
- 内存：4 GB
- 存储：20 GB SSD
- 系统：Ubuntu 20.04+ / Debian 11+ / macOS 12+
推荐配置
- CPU：4 核心或更多
- 内存：8 GB 或更多
- 存储：50 GB SSD
- 系统：Ubuntu 22.04 LTS
安装方式选择
OpenClaw 提供两种主要的安装方式：
- Docker 部署（推荐）：快速、隔离、易于管理
- 直接安装：更灵活，适合高级用户
我们推荐大多数用户使用 Docker 方式部署。
方式一：Docker 部署（推荐）
步骤 1：安装 Docker
首先，安装 Docker 和 Docker Compose：
# 安装 Docker
curl -fsSL https://get.docker.com | sh
# 启动 Docker
sudo systemctl start docker
sudo systemctl enable docker
# 添加当前用户到 docker 组
sudo usermod -aG docker $USER
步骤 2：创建项目目录
mkdir -p ~/openclaw
cd ~/openclaw
步骤 3：创建配置文件
创建 docker-compose.yml：
version: '3.8'
services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw
restart: unless-stopped
ports:
- "3000:3000"
environment:
- NODE_ENV=production
- OPENAI_API_KEY=${OPENAI_API_KEY}
- TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
- DISCORD_BOT_TOKEN=${DISCORD_BOT_TOKEN}
volumes:
- ./config:/app/config
- ./data:/app/data
- ./logs:/app/logs
networks:
- openclaw-network
networks:
openclaw-network:
driver: bridge
创建 .env 文件：
# LLM 配置
OPENAI_API_KEY=your-openai-api-key
# Telegram 配置（可选）
TELEGRAM_BOT_TOKEN=your-telegram-bot-token
# Discord 配置（可选）
DISCORD_BOT_TOKEN=your-discord-bot-token
# 管理员
ADMIN_USER_IDS=your-user-id
步骤 4：启动服务
docker-compose up -d
查看运行状态：
docker-compose logs -f openclaw
方式二：直接安装
如果你更喜欢直接安装，或者需要更多自定义选项，可以按照以下步骤操作。
步骤 1：安装 Node.js
# 安装 Node.js 18.x
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version # 应该显示 v18.x.x
npm --version
步骤 2：克隆项目
git clone https://github.com/openclaw/your-repo.git
cd openclaw
步骤 3：安装依赖
npm install
步骤 4：配置环境
复制并编辑配置文件：
cp config/app.example.yaml config/app.yaml
cp config/.env.example .env
编辑 .env 文件，填入你的配置：
# 必填：LLM API
OPENAI_API_KEY=sk-your-key-here
# 可选：Telegram
TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
# 可选：Discord
DISCORD_BOT_TOKEN=your-discord-bot-token
步骤 5：配置应用
编辑 config/app.yaml：
app:
name: "My OpenClaw"
port: 3000
host: "0.0.0.0"
llm:
provider: "openai"
model: "gpt-4"
plugins:
- telegram
- discord
步骤 6：启动应用
开发模式（带热重载）：
npm run dev
生产模式：
npm run build
npm start
Docker 进阶配置
使用自定义配置
创建 config/app.yaml 并挂载到容器：
version: '3.8'
services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw
restart: unless-stopped
ports:
- "3000:3000"
volumes:
- ./config:/app/config:ro
- ./data:/app/data
- ./logs:/app/logs
env_file:
- .env
使用 GPU 加速
如果你的 LLM 需要 GPU 加速：
version: '3.8'
services:
openclaw:
image: openclaw/openclaw:latest
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: 1
capabilities: [gpu]
数据持久化
确保重要数据持久化：
volumes:
- ./data/memory:/app/data/memory
- ./data/skills:/app/data/skills
- ./config:/app/config:ro
安装后配置
连接通讯平台
Telegram 配置
- 在 Telegram 中搜索 @BotFather
- 创建新机器人并获取 Token
- 获取你的 Telegram ID（@userinfobot）
- 在配置中添加工具和用户白名单
Discord 配置
- 访问 Discord Developer Portal
- 创建应用和 Bot
- 开启所需 Intent
- 邀请 Bot 到你的服务器
测试安装
使用健康检查端点：
curl http://localhost:3000/health
响应应该类似：
{
"status": "ok",
"version": "1.0.0",
"uptime": 3600
}
常见问题排查
问题 1：端口被占用
如果端口 3000 被占用：
# 查看端口占用
sudo lsof -i :3000
# 修改配置使用其他端口
# 在 app.yaml 中添加：
app:
port: 3001
问题 2：Docker 权限错误
# 修复 Docker 权限
sudo chmod 666 /var/run/docker.sock
问题 3：LLM API 调用失败
检查： - API Key 是否正确 - 网络能否访问 API 端点 - 账户是否有足够余额
问题 4：容器无法启动
查看日志：
docker-compose logs openclaw
常见错误： - 配置文件格式错误 - 环境变量缺失 - 端口映射冲突
更新 OpenClaw
Docker 方式更新
# 拉取最新镜像
docker-compose pull
# 重启服务
docker-compose up -d
直接安装更新
# 拉取最新代码
git pull
# 更新依赖
npm install
# 重新构建
npm run build
卸载
Docker 方式卸载
# 停止并删除容器
docker-compose down
# 删除数据（可选）
rm -rf ./data ./logs
直接安装卸载
# 停止服务
npm stop
# 删除目录
cd ..
rm -rf openclaw
总结
按照本指南，你应该已经成功安装了 OpenClaw。无论选择 Docker 还是直接安装方式，关键是正确配置环境变量和配置文件。
安装完成后，建议： 1. 测试各个平台的连接 2. 创建第一个自定义技能 3. 配置定时任务 4. 设置监控和告警
如果遇到问题，请查阅官方文档或社区支持资源。祝你在 OpenClaw 的使用过程中收获愉快的体验！
相关阅读： - OpenClaw 配置详解 - OpenClaw 技能开发 - OpenClaw 定时任务