OpenClaw LaunchOpenClaw Launch
← 首页

安装教程

OpenClaw（龙虾）安装教程 — 完整指南

OpenClaw 安装、部署和卸载的完整教程。包含一键安装命令、Docker 部署、 Windows/Mac/Linux 本地安装，以及卸载方法。

方式一：免安装部署（推荐）

如果你不想折腾服务器和 Docker，OpenClaw Launch 提供一键托管部署，10秒上线，无需安装任何软件。

  • 无需服务器、Docker 或命令行
  • 可视化配置，点击即部署
  • 自动 SSL、监控、更新
  • 从 $3/月起

立即体验 OpenClaw Launch →

方式二：一键安装命令

在 Linux 或 macOS 上，使用官方安装脚本一键安装 OpenClaw：

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

安装完成后，运行初始化向导配置你的 AI 智能体：

openclaw onboard                    # 交互式配置向导
openclaw onboard --install-daemon   # 同时安装为后台服务

openclaw onboard 会引导你选择 AI 模型、配置聊天平台（Telegram、Discord 等）、 设置 Gateway 认证，一步步完成首次配置。

Windows 安装

Windows 用户需要先安装 WSL2（Windows Subsystem for Linux），然后在 WSL 终端中运行相同的 curl 安装命令。详见 OpenClaw Windows 安装指南。

方式三：Docker 部署

如果你需要更多控制权，可以使用 Docker 手动部署 OpenClaw：

1. 安装 Docker

# Ubuntu/Debian
sudo apt update && sudo apt install docker.io docker-compose-plugin

# macOS — 安装 Docker Desktop

2. 拉取 OpenClaw 镜像

docker pull ghcr.io/openclaw/openclaw:latest

3. 创建配置文件

OpenClaw 的配置文件位于 ~/.openclaw/openclaw.json，需要配置：

  • AI 模型提供商（API Key）
  • 聊天平台（Telegram Token 或 Discord Token）
  • Gateway 认证
  • Agent 设置

4. 启动容器

docker run -d --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/home/node/.openclaw \
  ghcr.io/openclaw/openclaw:latest

5. 配置 HTTPS

Telegram Webhook 需要 HTTPS。安装 Caddy 或 Nginx 作为反向代理，配置 SSL 证书。 Caddy 可以自动处理 SSL。

预计耗时：手动 Docker 部署需要 2-6 小时，取决于经验。 配置文件语法错误、Docker 网络和 SSL 配置是最常见的问题。

常用命令

openclaw --version          # 查看版本
openclaw update             # 更新到最新版本
openclaw gateway run        # 启动 Gateway
openclaw gateway restart    # 重启 Gateway
openclaw dashboard          # 打开控制面板
openclaw doctor             # 诊断问题

如何卸载 OpenClaw

如果需要卸载 OpenClaw，根据安装方式选择对应的卸载方法：

卸载通过 curl 安装的 OpenClaw

# 停止后台服务
openclaw daemon stop

# 删除可执行文件
rm $(which openclaw)

# 删除配置和数据（可选 — 会删除所有设置）
rm -rf ~/.openclaw

卸载 Docker 版本

# 停止并删除容器
docker stop openclaw && docker rm openclaw

# 删除镜像（可选）
docker rmi ghcr.io/openclaw/openclaw:latest

# 删除配置和数据（可选）
rm -rf ~/.openclaw
提示：卸载前建议备份 ~/.openclaw/ 目录， 其中包含你的配置文件、聊天记录和凭证信息。

自建 vs 托管部署对比

自建部署OpenClaw Launch
需要服务器是 — VPS 或 Mac Mini否 — 全托管
Docker 知识需要不需要
配置方式手动编辑 JSON（易出错）可视化编辑器
SSL / HTTPS手动配置自动配置
部署时间2-6 小时10 秒
费用$5-20/月（VPS）+ 时间从 $3/月起

常见问题

OpenClaw 支持哪些系统？

OpenClaw 支持 Linux（Ubuntu、Debian、CentOS 等）、macOS 和 Windows（通过 WSL2）。 推荐使用 Ubuntu 服务器或 macOS。

安装需要多大内存？

OpenClaw 容器需要至少 2GB 内存。推荐 4GB 以上以确保稳定运行。

可以在阿里云/腾讯云上部署吗？

可以。任何支持 Docker 的云服务器都可以部署 OpenClaw，包括 阿里云、腾讯云、华为云等。 详见各平台的部署指南。

相关指南

不想折腾安装？

OpenClaw Launch 免安装部署，10秒上线你的 AI 智能体。

立即部署