哪种安装方式最适合新手？

一键脚本（curl -fsSL https://openclaw.sh | bash）是最快速、最简单的选择。它会自动检测系统、安装依赖并引导您完成配置。在全新 VPS 上整个流程约需 5 分钟。

可以用 Docker 运行 OpenClaw 吗？

可以。OpenClaw 提供官方 Docker 镜像。请使用上文方法三中的 docker-compose.yml 模板。Docker 非常适合隔离环境、便捷回滚和一致部署。请务必将 data/ 目录挂载为卷，以免丢失记忆和对话历史。

必须要有域名才能运行 OpenClaw 吗？

不需要。OpenClaw 默认通过服务器 IP 运行。但如果您希望通过 Let's Encrypt 获取 SSL 证书，并为 WhatsApp、Telegram 等消息渠道使用更简洁的 webhook URL，我们仍建议准备一个域名。

安装后如何更新 OpenClaw？

一键脚本和 npm 安装用户请运行 openclaw update；Docker 用户请运行 docker compose pull && docker compose up -d；源码安装用户请运行 git pull && pnpm install && pnpm build。更新前请务必备份 .env 和 data/ 目录。

2026 年 OpenClaw 安装教程（VPS、Docker、Mac 分步指南）

希望由专家代劳？

无需接触终端。我们的团队为您完成 OpenClaw 的安装、加固和配置。方案低至 $169 起。

查看方案

前置条件

安装 OpenClaw 前，请确认您的服务器满足最低配置要求。低于这些规格会导致响应缓慢、进程崩溃以及用户体验不佳。

CPU

至少 2 核 vCPU。多渠道部署建议 4 核 vCPU。

内存

至少 4 GB。通过 Ollama 运行本地 LLM 建议 8 GB。

存储

至少 20 GB SSD。记忆数据库和日志会随时间增长，长期使用请预留 50 GB。

操作系统

Ubuntu 22.04+、Debian 12+ 或任何支持 Docker 的 Linux 发行版。macOS 和 Windows（WSL2）同样可用。

您还需要

SSH 访问权限 用于登录您的服务器。只要能执行 ssh root@your-server-ip 即可。
AI 模型 API 密钥 来自 Anthropic、OpenAI、Google，或通过 Ollama 使用本地模型。请提前准备好。
域名（可选）。非必需，但推荐用于 SSL 配置和简洁的 webhook URL。

需要 VPS？推荐 Hetzner（CX22 约 $4.50/月）或 DigitalOcean（基础 Droplet $6/月），两者均超出最低要求。

1.一键脚本（推荐）

最快速的 OpenClaw 安装方式。一条命令搞定一切：依赖检查、下载、配置向导和服务部署。支持 Ubuntu、Debian、CentOS、Fedora、Arch 和 macOS。

curl -fsSL https://openclaw.sh | bash

安装脚本的工作内容

检测操作系统与包管理器

若未安装则自动安装 Node.js 20 LTS

全局安装 pnpm 以加快依赖解析

下载最新稳定版 OpenClaw

运行交互式配置向导

创建 systemd 服务（Linux）或 launchd 守护进程（macOS）

启动 OpenClaw 并确认运行状态

预期输出

[info] Detecting OS... Ubuntu 22.04 (x86_64)
[info] Node.js v20.18.1 found
[info] Installing pnpm...
[info] Downloading OpenClaw v2026.3.8...
[info] Running configuration wizard...
   → AI Provider: anthropic
   → Model: claude-sonnet-4-5
   → Port: 3100
[ok]   OpenClaw is running at http://localhost:3100
       Dashboard: http://localhost:3100/dashboard

安装脚本仅使用必需的最低权限。运行前请审阅脚本源码——我们建议所有通过管道执行的脚本都这样做。

自定义参数

通过参数跳过交互式向导，自定义安装流程。

# Skip the wizard with pre-set values
curl -fsSL https://openclaw.sh | bash -s -- \
  --provider anthropic \
  --model claude-sonnet-4-5 \
  --port 3100 \
  --no-systemd

2.npm / pnpm

适合希望完全掌控流程的开发者，每一步都清晰可见。

步骤 1 — 安装 Node.js 20+

OpenClaw 需要 Node.js 20 或更高版本。请先检查当前版本。

node --version
# If below v20, install via nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

步骤 2 — 安装 pnpm

npm install -g pnpm

步骤 3 — 全局安装 OpenClaw

pnpm install -g openclaw
# Or with npm:
npm install -g openclaw

步骤 4 — 初始化配置

init 命令会在当前目录创建 .env 文件和 data/ 目录。

mkdir ~/openclaw && cd ~/openclaw
openclaw init

步骤 5 — 编辑 .env 文件

.envenv

# ~/openclaw/.env
OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
# Or for OpenAI:
# AI_PROVIDER=openai
# AI_MODEL=gpt-5
# OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

步骤 6 — 启动 OpenClaw

openclaw start
# Or run in background:
openclaw start --daemon

使用 openclaw logs 查看实时输出。加 --follow 参数可持续跟踪新日志。

3.Docker

Docker 将 OpenClaw 与主机系统隔离。更新只需拉取新镜像并重启，非常适合生产服务器和团队使用。

步骤 1 — 安装 Docker

# Ubuntu / Debian
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Log out and back in for group changes to take effect

步骤 2 — 创建 docker-compose.yml

docker-compose.ymlyaml

version: "3.8"

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3100:3100"
    volumes:
      - ./data:/app/data        # Persistent memory & databases
      - ./config:/app/config    # Configuration files
      - ./.env:/app/.env        # Environment variables
    environment:
      - NODE_ENV=production
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3100/health"]
      interval: 30s
      timeout: 10s
      retries: 3

步骤 3 — 创建 .env 文件

.envenv

OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Optional: Enable persistent memory
MEMORY_ENABLED=true
MEMORY_PROVIDER=sqlite

# Optional: WhatsApp channel
WHATSAPP_ENABLED=false
WHATSAPP_PHONE_ID=
WHATSAPP_TOKEN=

步骤 4 — 启动容器

docker compose up -d

# Check the logs
docker compose logs -f openclaw

使用 Docker 更新

docker compose pull
docker compose up -d

请务必挂载 data/ 目录。若缺少卷挂载，容器重启后所有记忆和对话历史都将丢失。

4.源码编译

当您想修改核心行为、向上游贡献代码或使用预发布分支时，从源码构建。此方式需要开发经验。

步骤 1 — 克隆仓库

git clone https://github.com/openclaw/openclaw.git
cd openclaw

步骤 2 — 安装依赖

# Requires Node.js 20+ and pnpm
pnpm install

步骤 3 — 复制并编辑环境变量文件

cp .env.example .env
nano .env
# Set your AI_PROVIDER, API keys, and port

步骤 4 — 编译并启动

pnpm build
pnpm start

# For development with hot reload:
pnpm dev

源码更新

git pull origin main
pnpm install
pnpm build
# Restart your OpenClaw process or service

从源码编译时会将 TypeScript 编译为 JavaScript。视硬件性能而定，编译耗时约 30 至 90 秒，后续得益于缓存会更快。

安装后配置

OpenClaw 已成功运行。接下来配置 AI 模型、接入消息渠道并验证一切正常。

配置 AI 模型

OpenClaw 支持多家 AI 服务商。可在 .env 文件或控制台中设置您偏好的模型。

服务商	模型	每条消息成本
Anthropic	Claude Opus 4.6, Sonnet 4.5, Haiku 4.5	$0.001 – $0.05
OpenAI	GPT-5, GPT-5 mini	$0.002 – $0.03
Google	Gemini 3 Pro, Gemini 3 Flash	$0.001 – $0.02
DeepSeek	DeepSeek V3	~$0.005
Mistral	Mistral Large	~$0.01
Ollama (local)	Llama 4, Qwen 3, Mistral, and any GGUF model	Free

.envenv

# Example: Switch to Claude Opus 4.6
AI_PROVIDER=anthropic
AI_MODEL=claude-opus-4-6
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Example: Use a local model via Ollama
AI_PROVIDER=ollama
AI_MODEL=llama4:8b
OLLAMA_HOST=http://localhost:11434

测试阶段先使用 Haiku 4.5 或 Gemini 3 Flash 等性价比更高的模型，待渠道和记忆配置完毕后再切换至更强大的模型。

配置第一个渠道（以 WhatsApp 为例）

OpenClaw 支持 191+ 项集成。WhatsApp 是最常见的起点，接入方式如下。

创建 Meta 商业应用

访问 developers.facebook.com，创建新的商业应用，启用 WhatsApp 产品。

获取手机号 ID 和访问令牌

在 WhatsApp API 设置中，复制 Phone Number ID 并生成永久访问令牌。

将凭据写入 .env

.envenv

WHATSAPP_ENABLED=true
WHATSAPP_PHONE_ID=123456789012345
WHATSAPP_TOKEN=EAAxxxxxxxxxxxxxxxx
WHATSAPP_VERIFY_TOKEN=your-random-verify-string

设置 webhook URL

在 Meta 控制台中，将 webhook URL 设为 https://your-domain.com/api/webhook/whatsapp，并使用步骤 3 中的校验令牌。

重启 OpenClaw 并发送测试消息

openclaw restart
# Or with Docker:
docker compose restart openclaw

发送第一条消息

打开 WhatsApp，向已连接的号码发送 "Hello"。您应在 2 至 5 秒内收到回复。若尚未配置 WhatsApp，可通过控制台进行测试。

# Quick test via CLI
curl -X POST http://localhost:3100/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, what can you do?"}'

成功响应会返回包含 AI 回复的 JSON。如果报错，请查阅下方故障排查章节。

常见错误与解决方案

大多数安装问题可归为五类，以下是各类问题的解决方案。

Error: 端口 3100 已被占用

其他进程正占用 OpenClaw 默认端口。

# Find what is using port 3100
sudo lsof -i :3100

# Option A: Kill the process
sudo kill -9 <PID>

# Option B: Change OpenClaw's port
# In .env, set:
OPENCLAW_PORT=3200

Error: Node 版本不匹配

OpenClaw 需要 Node.js 20 或更高版本。较旧版本启动时会出现语法错误。

# Check your current version
node --version

# If below v20, upgrade with nvm:
nvm install 20
nvm alias default 20
nvm use 20

# Verify
node --version  # Should show v20.x.x or higher

Error: Docker 权限被拒绝

您会看到 "permission denied while trying to connect to the Docker daemon socket" 报错。

# Add your user to the docker group
sudo usermod -aG docker $USER

# Log out and back in, then verify:
docker ps
# If you still get errors, restart the Docker service:
sudo systemctl restart docker

Error: SSL 证书问题

Meta 等 webhook 服务商会拒绝 HTTP 接口，必须使用 HTTPS。

# Install Certbot and get a free Let's Encrypt certificate
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-domain.com

# Auto-renewal is configured automatically
# Test renewal:
sudo certbot renew --dry-run

如果使用 Cloudflare，请将 SSL 模式设为 "完全（严格）"，并使用 Cloudflare 源站证书而非 Let's Encrypt。

Error: 内存不足 / 进程被终止

当服务器内存耗尽时，Linux OOM killer 会终止 OpenClaw 进程。

# Check available memory
free -h

# Option A: Add swap space (quick fix)
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Option B: Upgrade your VPS to 4+ GB RAM

# Option C: Use a lighter AI model
# In .env, switch from Opus to Haiku:
AI_MODEL=claude-haiku-4-5

AI 模型本身通过 API 远程运行。内存问题来自 OpenClaw 的记忆数据库和 Node.js 进程，而非模型本身。实际最低要求为 4 GB 内存。

安装后安全加固

未加固的 OpenClaw 实例是巨大的安全隐患。研究表明，93.4% 的公开实例未启用基础认证，42,665 个实例裸露在公网上。请勿成为其中一员。

安全清单（精简版）

在 .env 中启用认证：设置 AUTH_ENABLED=true，AUTH_SECRET 使用 32 位随机字符串
配置 UFW 防火墙：仅放行 22（SSH）、80（HTTP）和 443（HTTPS）端口
使用 Let's Encrypt 或 Cloudflare 源站证书配置 SSL/TLS
在生产环境禁用控制台，或将其置于认证保护之后
保持 OpenClaw 更新：每周运行 openclaw update 或 docker compose pull
在 OpenClaw 前部署反向代理（Nginx 或 Caddy）
切勿将端口 3100 直接暴露到公网

# Quick firewall setup (Ubuntu/Debian)
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp    # SSH
sudo ufw allow 80/tcp    # HTTP
sudo ufw allow 443/tcp   # HTTPS
sudo ufw enable

# Verify
sudo ufw status

以上为精简版。如需查看我们为每位客户实施的完整 12 项安全审计，请阅读我们的安全指南 & 安全清单.

常见问题

需要帮助？

我们的团队为您在服务器上完成 OpenClaw 的安装、加固和配置，包含持久化记忆、多渠道部署和 12 项安全审计。

查看方案向我们提问

2026 年如何安装 OpenClaw

希望由专家代劳？

前置条件

您还需要

1.一键脚本（推荐）

安装脚本的工作内容

预期输出

自定义参数

2.npm / pnpm

步骤 1 — 安装 Node.js 20+

步骤 2 — 安装 pnpm

步骤 3 — 全局安装 OpenClaw

步骤 4 — 初始化配置

步骤 5 — 编辑 .env 文件

步骤 6 — 启动 OpenClaw

3.Docker

步骤 1 — 安装 Docker

步骤 2 — 创建 docker-compose.yml

步骤 3 — 创建 .env 文件

步骤 4 — 启动容器

使用 Docker 更新

4.源码编译

步骤 1 — 克隆仓库

步骤 2 — 安装依赖

步骤 3 — 复制并编辑环境变量文件

步骤 4 — 编译并启动

源码更新

安装后配置

配置 AI 模型

配置第一个渠道（以 WhatsApp 为例）

发送第一条消息

常见错误与解决方案

Error: 端口 3100 已被占用

Error: Node 版本不匹配

Error: Docker 权限被拒绝

Error: SSL 证书问题

Error: 内存不足 / 进程被终止

安装后安全加固

安全清单（精简版）

常见问题

需要帮助？