OpenClaw 完整安装指南：5种方式从入门到精通

OpenClaw 是一个开源的 AI 助手网关，让你能够在 Telegram、Discord、微信、飞书等各种聊天应用中接入 AI 能力。本文介绍 5 种安装方式，从简单到进阶，总有一款适合你。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 系统要求

最低要求： • 操作系统：Linux / macOS / Windows • Node.js：18.x 以上 • 内存：512MB • 磁盘：100MB • 网络：可访问外网

推荐配置： • 操作系统：Ubuntu 22.04 LTS • Node.js：20.x LTS • 内存：1GB 以上 • 磁盘：500MB 以上 • 网络：稳定的外网连接

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

方式一：npm 全局安装（最简单 ★推荐新手）

适合人群：快速体验，不想折腾的用户

1. 安装 Node.js

Ubuntu/Debian 系统： curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs

macOS 系统： brew install node@20

验证安装： node -v （应显示 v20.x.x） npm -v （应显示 10.x.x）

2. 安装 OpenClaw

sudo npm install -g openclaw

验证： openclaw --version

3. 初始化配置

mkdir -p ~/.openclaw cd ~/.openclaw openclaw init

4. 编辑配置文件

nano ~/.openclaw/config.yaml

基础配置示例：

gateway: port: 8080 host: "0.0.0.0"

providers: openai: api_key: "sk-your-openai-api-key" model: "gpt-4o"

moonshot: api_key: "your-moonshot-key" model: "moonshot-v1-8k"

channels: telegram: enabled: true bot_token: "your-telegram-bot-token"

discord: enabled: false token: "your-discord-bot-token"

logging: level: info file: ~/.openclaw/logs/openclaw.log

5. 启动服务

前台运行（测试用）： openclaw gateway start

后台运行（生产用）： openclaw gateway start --daemon

查看状态： openclaw gateway status

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

方式二：Docker 安装（推荐生产环境 ★）

适合人群：需要稳定运行、便于管理的用户

1. 安装 Docker

curl -fsSL https://get.docker.com | sh sudo usermod -aG docker $USER newgrp docker

验证： docker --version docker-compose --version

2. 创建项目目录

mkdir -p ~/openclaw-docker cd ~/openclaw-docker

3. 创建 docker-compose.yml 文件

version: '3.8'

services: openclaw: image: openclaw/openclaw:latest container_name: openclaw restart: unless-stopped ports: - "8080:8080" volumes: - ./config:/app/config - ./logs:/app/logs - ./data:/app/data environment: - NODE_ENV=production healthcheck: test: ["CMD", "curl", "-f", "http://localhost:8080/health"] interval: 30s timeout: 10s retries: 3

4. 创建配置文件

mkdir -p config logs data

config.yaml 内容：

gateway: port: 8080 host: "0.0.0.0"

providers: openai: api_key: "${OPENAI_API_KEY}" model: "gpt-4o"

channels: telegram: enabled: true bot_token: "${TELEGRAM_BOT_TOKEN}"

logging: level: info

5. 设置环境变量

创建 .env 文件：

OPENAI_API_KEY=sk-your-openai-api-key TELEGRAM_BOT_TOKEN=your-telegram-bot-token

6. 启动容器

启动： docker-compose up -d

查看日志： docker-compose logs -f

停止： docker-compose down

更新镜像： docker-compose pull && docker-compose up -d

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

方式三：源码编译安装（开发者推荐）

适合人群：想二次开发、贡献代码的用户

1. 克隆源码

git clone GitHub - openclaw/openclaw: Your own personal AI assistant. Any OS. Any Platform. The lobster way.
🦞
cd openclaw

2. 安装依赖

使用 pnpm（推荐）： npm install -g pnpm pnpm install

或使用 npm： npm install

3. 开发模式运行

pnpm dev 或 npm run dev

4. 生产构建

pnpm build pnpm start

5. 开发调试

运行测试：pnpm test

代码检查：pnpm lint

格式化：pnpm format

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

方式四：Systemd 服务安装（Linux 服务器）

适合人群：需要开机自启、系统级管理

1. 安装 OpenClaw

sudo npm install -g openclaw

2. 创建 systemd 服务文件

sudo nano /etc/systemd/system/openclaw.service

内容：

[Unit] Description=OpenClaw AI Gateway After=network.target

[Service] Type=simple User=openclaw Group=openclaw WorkingDirectory=/home/openclaw/.openclaw ExecStart=/usr/bin/openclaw gateway start ExecReload=/bin/kill -HUP $MAINPID Restart=always RestartSec=10

[Install] WantedBy=multi-user.target

3. 创建专用用户

sudo useradd -r -s /bin/false openclaw sudo mkdir -p /home/openclaw/.openclaw sudo chown -R openclaw:openclaw /home/openclaw

4. 复制配置

sudo cp ~/.openclaw/config.yaml /home/openclaw/.openclaw/ sudo chown openclaw:openclaw /home/openclaw/.openclaw/config.yaml

5. 启动服务

重载配置： sudo systemctl daemon-reload

开机自启： sudo systemctl enable openclaw

启动： sudo systemctl start openclaw

查看状态：

sudo systemctl status openclaw

查看日志： sudo journalctl -u openclaw -f

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

方式五：Docker Compose 完整栈（高级用户）

适合人群：需要数据库、反向代理的完整部署

1. 创建目录

mkdir -p ~/openclaw-stack cd ~/openclaw-stack

2. docker-compose.yml 完整配置

version: '3.8'

services: openclaw: image: openclaw/openclaw:latest container_name: openclaw restart: unless-stopped ports: - "127.0.0.1:8080:8080" volumes: - ./config:/app/config - ./logs:/app/logs - ./data:/app/data environment: - NODE_ENV=production networks: - openclaw-net depends_on: - redis

redis: image: redis:7-alpine container_name: openclaw-redis restart: unless-stopped volumes: - redis-data:/data networks: - openclaw-net

caddy: image: caddy:2-alpine container_name: openclaw-caddy restart: unless-stopped ports: - "80:80" - "443:443" volumes: - ./Caddyfile:/etc/caddy/Caddyfile - caddy-data:/data - caddy-config:/config networks: - openclaw-net

volumes: redis-data: caddy-data: caddy-config:

networks: openclaw-net: driver: bridge

3. Caddyfile（反向代理 + HTTPS）

your-domain.com { reverse_proxy openclaw:8080 encode gzip }

4. 启动

docker-compose up -d

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔧 常见问题排查

问题1：端口被占用

查看占用： sudo lsof -i :8080

解决：编辑 config.yaml，修改 gateway.port

━━━━━━━━

问题2：权限不足

修复权限： sudo chown -R $USER:$USER ~/.openclaw chmod 600 ~/.openclaw/config.yaml

━━━━━━━━

问题3：无法连接 AI 服务

测试 API： curl https://api.openai.com/v1/models -H "Authorization: Bearer your-api-key"

检查日志： openclaw logs

━━━━━━━━

问题4：更新 OpenClaw

npm 安装： sudo npm update -g openclaw

Docker 安装： docker-compose pull && docker-compose up -d

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎉 验证安装成功

1. 检查服务状态 openclaw status

2. 测试 API curl http://localhost:8080/health

3. 发送测试消息 在 Telegram/Discord 中 @你的机器人，看它是否回复

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📚 相关资源

• 官方文档：https://docs.openclaw.ai

• Discord 社区：https://discord.gg/clawd

• GitHub：GitHub - openclaw/openclaw: Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞

• 主题市场：https://clawhub.com