OpenClaw LaunchOpenClaw Launch
← 首页

教程

OpenClaw 安装部署完整教程

从零开始部署 OpenClaw AI智能体 — 对比传统自建和一键托管两种方案，选择最适合你的方式。

什么是 OpenClaw（龙虾）？

OpenClaw（社区昵称"龙虾"）是一个开源AI智能体框架，GitHub 270,000+ Star，MIT许可证。它可以将主流AI模型（GPT、Claude、Gemini、DeepSeek、Kimi等）变成你的私人AI助手，运行在Telegram、Discord或浏览器上。

OpenClaw 拥有3,200+社区 Skills，可以执行网页搜索、管理文件、发邮件、操控智能家居等各种任务。

安装 OpenClaw 有两种方式：传统自建（Docker + 命令行）或使用 OpenClaw Launch 一键托管。

OpenClaw 架构原理

OpenClaw 的核心架构包含以下组件：

  • Gateway（网关） — 处理所有外部连接（Telegram、Discord、浏览器），统一消息格式
  • Agent（智能体） — 核心AI引擎，处理用户消息，调用AI模型生成回复
  • Models（模型层） — 对接各AI提供商API（OpenAI、Anthropic、Google等），统一调用接口
  • Plugins（插件） — 管理渠道插件（Telegram、Discord等）和Skills 插件
  • Skills（Skills） — 社区贡献的功能扩展，赋予AI更多能力

所有配置存储在 openclaw.json 文件中，包括模型配置、渠道配置、插件启用和智能体设置。

方案A：传统自建安装（Docker + 命令行）

传统安装需要服务器、Docker、命令行操作和手动配置JSON文件。以下是详细步骤：

1. 准备服务器

你需要一台24小时运行的机器。大多数人选择租用云服务器（阿里云、腾讯云、Hetzner、DigitalOcean，$5-20/月），或者买一台Mac Mini（$500+），也可以用Windows电脑+WSL2。服务器至少需要1GB内存和公网IP。

2. 安装 Docker

OpenClaw 运行在Docker容器中。Ubuntu/Debian 系统执行：sudo apt update && sudo apt install docker.io docker-compose-plugin。macOS 安装 Docker Desktop。Windows 需要先启用 WSL2，再安装 Docker Desktop。

3. 拉取 OpenClaw 镜像

执行命令：docker pull ghcr.io/openclaw/openclaw:latest — 下载最新版 OpenClaw 镜像，大约500MB。国内用户可能需要配置Docker镜像加速器（阿里云、腾讯云等均提供免费加速服务）。

4. 创建配置文件

OpenClaw 从 ~/.openclaw/openclaw.json 读取配置。你需要手动创建这个JSON文件，配置AI模型提供商（API密钥）、聊天平台（Telegram Token或Discord Token）、网关认证和智能体设置。JSON格式包含models、channels、plugins、agents、gateway等嵌套对象。一个逗号或括号写错就会导致启动失败。

5. 启动容器

执行：docker run -d --name openclaw -p 18789:18789 -v ~/.openclaw:/home/node/.openclaw ghcr.io/openclaw/openclaw:latest。需要挂载配置目录和暴露网关端口。注意文件权限 — 容器以 uid 1000 运行。

6. 配置 HTTPS（SSL证书）

Telegram Webhook 和安全的浏览器访问需要HTTPS。安装反向代理（推荐Caddy或Nginx），将域名指向服务器，配置SSL证书。Caddy自动处理证书，Nginx需要手动配置 Let's Encrypt。

7. 配置防火墙和监控

开放443端口（HTTPS）。设置进程管理器（PM2或systemd）确保OpenClaw崩溃后自动重启。可选配置日志轮转和健康检查脚本。

预计耗时：2-6小时，取决于你的经验。最常见的卡点是配置文件语法错误、Docker网络问题和SSL证书配置。

常见安装问题

  • 配置文件语法错误 — JSON中一个多余的逗号或缺少的括号就会导致启动失败，错误信息往往不够清晰
  • Docker权限问题 — 容器以 node 用户（uid 1000）运行，挂载目录需要正确的权限设置
  • 网关认证格式 — gateway.auth 必须是对象格式（{ token: "..." }），不能是字符串，很多教程写错了
  • 插件配置遗漏 — 渠道配置和插件条目都必须启用，Telegram/Discord才能正常工作。仅配置渠道是不够的
  • 国内网络问题 — Docker镜像拉取慢，需要配置加速器。API调用可能需要代理

云服务器推荐（国内用户）

如果你选择自建，以下云服务器适合运行 OpenClaw：

  • 阿里云 ECS — 轻量应用服务器，2核2G起步，约30-50元/月
  • 腾讯云 CVM — 轻量应用服务器，2核2G起步，约30-50元/月
  • Hetzner — 德国云服务商，性价比高，2核2G约$5/月（需要能访问外网）

注意：OpenClaw 需要调用AI模型API（OpenAI、Anthropic等），国内服务器可能需要配置网络代理。

方案B：OpenClaw Launch 一键部署（推荐）

OpenClaw Launch 是 OpenClaw 的官方托管平台。无需Docker、无需配置文件、无需SSL — 可视化编辑器配置，一键部署。

传统自建OpenClaw Launch
服务器需要 — Mac Mini 或云服务器不需要 — 全托管
Docker知识必须不需要
配置方式手写JSON文件（容易出错）可视化编辑器
SSL / HTTPS手动配置自动处理
部署时间2-6小时10秒
监控自己写脚本内置仪表盘
费用$5-20/月（云服务器）+ 时间$3/月起
支付方式—支持支付宝、微信支付

OpenClaw Launch 部署流程

  1. 配置 — 在可视化界面选择AI模型（Claude、GPT、Gemini、Kimi、DeepSeek等）和聊天平台（Telegram、Discord或浏览器）。无需编辑配置文件。
  2. 部署 — 点击一个按钮，OpenClaw实例在10秒内启动。Docker、网络和SSL全部自动处理。
  3. 使用 — AI智能体即刻上线。在Telegram、Discord或内置Web UI中对话。通过仪表盘监控一切。

常用 OpenClaw 命令

如果你选择自建，以下是常用的管理命令：

  • docker pull ghcr.io/openclaw/openclaw:latest — 拉取/升级最新版
  • docker logs openclaw -f — 查看实时日志
  • docker restart openclaw — 重启容器
  • docker stop openclaw && docker rm openclaw — 停止并删除容器（卸载）
  • docker exec -it openclaw sh — 进入容器内部

如何升级 OpenClaw

自建用户升级步骤：

  1. 拉取最新镜像：docker pull ghcr.io/openclaw/openclaw:latest
  2. 停止旧容器：docker stop openclaw && docker rm openclaw
  3. 用相同参数重新启动：docker run -d --name openclaw ...（使用你原来的启动命令）

OpenClaw Launch 用户无需手动升级 — 平台自动更新到最新版本。

如何选择？

选择自建 — 如果你想完全掌控服务器、已有Docker经验、并且不介意花几小时安装和持续维护。

选择 OpenClaw Launch — 如果你想立刻用上AI智能体、不想管服务器、或者是OpenClaw新手。$3/月起，零基础设施设置。支持支付宝和微信支付。

立即部署

跳过2-6小时的安装。10秒部署你的 OpenClaw AI智能体。

开始部署