希望由专家代劳？
无需接触终端。我们的团队为您完成 OpenClaw 的安装、加固和配置。方案低至 $169 起。
前置条件
安装 OpenClaw 前，请确认您的服务器满足最低配置要求。低于这些规格会导致响应缓慢、进程崩溃以及用户体验不佳。
至少 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。
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-systemd2.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 文件
# ~/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 --daemon3.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
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 文件
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 -d4.源码编译
当您想修改核心行为、向上游贡献代码或使用预发布分支时，从源码构建。此方式需要开发经验。
步骤 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安装后配置
OpenClaw 已成功运行。接下来配置 AI 模型、接入消息渠道并验证一切正常。
配置 AI 模型
OpenClaw 支持多家 AI 服务商。可在 .env 文件或控制台中设置您偏好的模型。
| 服务商 | 模型 | 每条消息成本 |
|---|---|---|
| Anthropic | Claude Opus 4.8, Sonnet 5, Haiku 4.5 | $0.001 – $0.05 |
| OpenAI | GPT-5.6 Terra, GPT-5.6 Luna | $0.002 – $0.03 |
| Gemini 3 Pro, Gemini 3.5 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 |
# Example: Switch to Claude Opus 4.8
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配置第一个渠道（以 WhatsApp 为例）
OpenClaw 支持 191+ 项集成。WhatsApp 是最常见的起点，接入方式如下。
创建 Meta 商业应用
访问 developers.facebook.com，创建新的商业应用，启用 WhatsApp 产品。
获取手机号 ID 和访问令牌
在 WhatsApp API 设置中，复制 Phone Number ID 并生成永久访问令牌。
将凭据写入 .env
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=3200Error: 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 higherError: 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 dockerError: 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-runError: 内存不足 / 进程被终止
当服务器内存耗尽时，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-5AI 模型本身通过 API 远程运行。内存问题来自 OpenClaw 的记忆数据库和 Node.js 进程，而非模型本身。实际最低要求为 4 GB 内存。
安装后安全加固
一个没有安全防护、正在运行的 OpenClaw 实例就是一项隐患。安全研究（Maor Dayan，并经 CSO Online 佐证）发现约有 42,665 个实例暴露在开放互联网上，其中约 93% 存在认证绕过隐患，而 ClawBleed（CVE-2026-25253）正被积极利用。请勿沦为这组数字中的一员。
安全清单（精简版）
- 在 .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