乐于分享
好东西不私藏

OpenClaw 安装详解:三种方式,从零到一

OpenClaw 安装详解:三种方式,从零到一

一个命令,五分钟,你就能拥有一个跨平台的个人 AI 助手——支持 WhatsApp、Telegram、Discord、iMessage 等二十多个渠道。问题在于:选哪种安装方式?

为什么选择 OpenClaw

OpenClaw 是一个自托管的 AI 网关。它运行在你自己的机器上,连接你常用的聊天应用,让 AI 助手通过这些渠道为你服务。

自托管:数据在你手上,规则你说了算

多渠道:一个网关同时服务 WhatsApp、Telegram、Discord 等

Agent 原生:为 AI 编程助手设计,支持工具调用、会话、记忆

但第一步——安装——很多人卡住了。

方式一:一键脚本(推荐)

这是最快的方式,适合 macOS、Linux 和 Windows(通过 WSL2)。

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

# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会自动检测 Node.js 版本(需要 Node 24 或 22.16+)、安装 OpenClaw CLI、引导完成初始化配置。

安装完成后,运行向导:

openclaw onboard --install-daemon

这个命令会配置 AI 模型的认证、设置网关参数、安装系统服务。完成后打开控制面板:

openclaw dashboard

浏览器会自动打开 http://127.0.0.1:18789/,你可以直接在网页上与 AI 对话。

适用场景:个人电脑、开发环境、快速体验。

方式二:Docker 部署

适合服务器、VPS、或需要隔离环境的场景。

前置要求:Docker Desktop 或 Docker Engine、Docker Compose v2、至少 2GB 内存。

快速启动

git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh

脚本会构建镜像、运行配置向导、启动网关服务、生成访问令牌。

使用预构建镜像(跳过本地构建):

export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./docker-setup.sh

适用场景:云服务器、团队共享、需要沙箱隔离。

方式三:从源码构建

适合开发者,需要定制或贡献代码。

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm openclaw onboard --install-daemon

# 开发模式(自动重载)
pnpm gateway:watch

适用场景:二次开发、调试、贡献代码。

三种方式对比

方式 难度 适用场景 更新方式
一键脚本 个人电脑、快速体验 openclaw update
Docker ⭐⭐ 服务器、隔离环境 重新构建镜像
源码构建 ⭐⭐⭐ 开发、定制 git pull && pnpm build

配置文件在哪里

无论哪种安装方式,配置文件都在:

~/.openclaw/openclaw.json

最小配置示例:

{
  agent: {
    model: "anthropic/claude-opus-4-6"
  }
}

写在最后

OpenClaw 的安装设计得足够简单——一键脚本、Docker、源码构建,三条路径覆盖了从新手到开发者的全部需求。

选择适合你的那条,五分钟内,你就能在自己的机器上跑起来。

安装完成后,你可以:打开 Control UI 开始对话、连接 WhatsApp / Telegram / Discord 等渠道、配置 AI 模型的 API Key、探索 Skills 技能系统。


参考资料:

  1. OpenClaw 官方文档 - https://docs.openclaw.ai
  2. OpenClaw GitHub 仓库 - https://github.com/openclaw/openclaw
  3. OpenClaw Discord 社区 - https://discord.com/invite/clawd
  4. ClawHub 技能市场 - https://clawhub.com

配图来源:Unsplash