OpenClaw 全平台安装指南：一份教程，覆盖所有设备与方法

​

OpenClaw 是一个开源的、可自行托管的 AI 助手平台，它可以连接到 LLM 提供商（如 OpenAI、Claude、Gemini），也可以通过 Ollama 在本地运行。安装过程通常只需约 5 分钟，适用于 macOS、Linux 和 Windows（通过 WSL2）。

本指南将带你了解从系统要求到安装和配置的全过程。

系统要求

在安装 OpenClaw 之前，请确保你的环境满足以下要求：

• Node.js 22+
• NPM（Node 包管理器）
• Git
• 操作系统
  • macOS
  • Linux（Ubuntu、Debian 等）
  • 带有 WSL2 的 Windows

安装过程中还需要稳定的互联网连接。

步骤 1：如何安装 OpenClaw —— 多种方法

方法 1：通过安装脚本安装（推荐）

最简单的安装方法是使用一键安装脚本。运行以下安装命令：

Mac/Linux 终端：

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

Windows 的 PowerShell 或 WSL2 终端：

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

该安装程序会自动完成以下操作：

• 检查 Node.js 是否已安装
• 安装缺失的依赖项
• 下载最新版本的 OpenClaw
• 构建项目
• 创建默认配置文件

安装通常在 5 分钟内完成。

方法 2：通过 npm 安装

npm install -g openclaw@latest

这将在你的系统上全局安装 OpenClaw。然后运行以下命令启动配置向导：

openclaw onboard

方法 3：从源代码安装

这种方法让你完全控制安装过程。

克隆仓库：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

安装依赖项：

npm install

构建项目：

npm run build

然后正常启动 OpenClaw。

方法 4：通过 Docker 安装

适用于容器化环境：

git clone https://github.com/openclaw/openclaw
cd openclaw
docker-compose up -d

Docker 安装适用于：

• VPS 部署
• 云服务器
• 隔离环境

步骤 2：验证安装

安装完成后，验证 OpenClaw 是否正常工作。运行：

openclaw --version

如果安装成功，终端将显示已安装的版本号。如果出现“command not found”，请重启终端或检查 Node.js 是否在系统 PATH 中。

步骤 3：运行初始设置向导

安装 OpenClaw 后，运行引导向导：

openclaw onboard

设置向导将引导你完成以下步骤：

• 选择 AI 模型提供商
• 输入 API 密钥
• 配置网关
• 选择默认工具和插件（AI 模型为必选项）

这个交互式配置会自动生成所需的配置文件。

步骤 4：启动 OpenClaw 仪表板

引导完成后，启动 Web 界面：

openclaw dashboard

打开浏览器访问：

http://127.0.0.1:18789

现在你可以通过仪表板与你的 OpenClaw 助手进行交互。

可选工具和插件连接

1. 连接消息通道

OpenClaw 可以与消息平台集成，作为聊天机器人运行。支持的通道包括：

• Telegram
• WhatsApp
• Discord
• Slack

例如，连接 Telegram 的步骤：

• 通过 BotFather 在 Telegram 中创建一个机器人
• 获取机器人令牌
• 运行：

  openclaw channels login telegram
 

• 出现提示时粘贴令牌

设置完成后，发送给机器人的消息将由 OpenClaw 处理。

2. 选择 AI 模型提供商

OpenClaw 需要一个后端 AI 模型。你可以选择云 API 或本地模型。

云 API 提供商：

• OpenAI（GPT 模型）
• Anthropic Claude
• Google Gemini

这些需要 API 密钥。

本地模型（可选）： 你可以使用 Ollama 在本地运行模型，实现完全离线的 AI 体验。

其他模型包括：

• Llama
• Mistral
• Kimi

使用本地模型可以避免 API 费用，但需要更强的硬件配置。

3. 集成 ComPDF 技能，实现 PDF 处理

为了增强 OpenClaw 的文档处理能力，你可以集成文档处理的Skills，实现自动化的 PDF 处理。

• PDF 转换（PDF/图片转 Word、Excel、PowerPoint、图片、RTF、CSV、JSON、HTML 等）
• 文档合并、拆分、旋转、压缩、添加水印等

结语

安装 OpenClaw 非常简单，通常只需几分钟。最简单的方法是使用一键安装脚本，它会自动安装依赖项并配置环境。安装完成后，你可以运行引导向导、启动仪表板，并连接 AI 模型或消息平台，构建一个强大的私有化 AI 助手。

​