安装指南 | OpenClaw

准备工作

系统要求

📦

Node.js

Node.js v22 或更高版本

下载 Node.js →

💻

操作系统

macOS、Linux 或 Windows（推荐 WSL2）

🔑

API Key

Anthropic API Key（用于 Claude 模型）

获取 API Key →

安装步骤

3 步完成安装

1

安装 CLI

选择你喜欢的包管理器全局安装 OpenClaw。

                                    
方式一：使用 npm

                                npm install -g openclaw@latest

                                    
方式二：使用 pnpm

                                pnpm add -g openclaw@latest

                                    
方式三：使用 curl (macOS/Linux)

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

2

运行引导向导

向导将引导你完成模型配置、网关设置和通道配置。

                                    
Terminal

                                openclaw onboard --install-daemon

🔐

模型配置

输入你的 Anthropic API Key

⚙️

网关设置

配置后台服务选项

📱

通道配置

选择要连接的消息平台

3

启动网关

网关服务确保 OpenClaw 在后台 24/7 持续运行。

                                    
Terminal

                                openclaw gateway install

4

连接通道

配对并连接你喜欢的聊天平台，如 WhatsApp、Telegram 或 Discord。

💚 WhatsApp

✈️ Telegram

🎮 Discord

💼 Slack

平台支持

多平台兼容

平台	支持状态	备注
🍎 macOS	✓ 完全支持	推荐平台，所有功能可用
🐧 Linux	✓ 完全支持	服务器部署首选
🪟 Windows	✓ 支持	强烈推荐使用 WSL2
🐳 Docker	✓ 支持	容器化部署方案

高级选项

Docker 部署

对于需要更高隔离性和安全性的用户，推荐使用 Docker 容器部署 OpenClaw。

🔒

安全隔离

在容器中运行，保护宿主系统
🔄

易于更新

一键拉取新版本镜像
📦

环境一致

避免依赖冲突问题

                            
                            
                            
                        
docker-compose.yml

                        version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
    volumes:
      - ./data:/app/data
      - ./config:/app/config
    ports:
      - "3000:3000"
            
                    

小贴士

安装建议

⚠️

设置消费限制

在 Anthropic 控制台设置 API 消费限制，避免因意外循环导致高额账单。

🔐

权限控制

使用 Docker 时，设置只读权限保护重要文件目录。

💾

定期备份

定期备份 config 和 data 目录，防止数据丢失。

遇到问题？

查看常见问题或访问官方文档获取更多帮助。

❓ 查看常见问题 📖 官方文档