OpenClaw 各平台安装配置完全指南:5分钟快速上手你的个人AI助手

作为开源AI助手领域的后起之秀，OpenClaw在GitHub上已获得超过100K颗星星，成为最受欢迎的个性化AI助手之一。

与其他AI工具不同，OpenClaw的核心优势在于多平台消息通道的支持。无论你身在何处，都能通过最熟悉的通讯工具与AI助手保持联系。这篇文章将为你提供史上最详细的安装配置指南，保证你按照步骤操作，一定能成功运行OpenClaw！

准备好了吗？让我们开始吧。

一、安装前的准备工作

在开始安装OpenClaw之前，我们需要确认一些基本条件。这就像装修房子前要先打好地基一样，前置工作做好，后面的安装就会顺风顺水。

1.1 系统要求

OpenClaw对运行环境的要求并不苛刻，但为了保证最佳体验，你需要确认以下几点：

操作系统支持：macOS 12.0及以上版本（Monterey及更新版本）、Linux主流发行版（Ubuntu 20.04+、Debian 11+、CentOS 8+）、Windows 10/11（通过WSL2或PowerShell）。

硬件要求：至少2GB可用内存、至少5GB可用磁盘空间、网络连接（用于调用AI API）。

软件要求：Node.js 22.0或更高版本、npm、pnpm或yarn（任选其一）、Git（用于版本控制和更新）。

1.2 账号与API Key准备

OpenClaw需要连接AI服务才能工作，目前支持三种AI Provider：

Anthropic（推荐）：官网地址是 https://www.anthropic.com，产品是Claude系列模型。注册账号后，在Console中创建API Key即可使用。推荐理由是响应速度快，性价比高，编程能力强。

OpenAI：官网地址是 https://platform.openai.com，产品包括GPT-4o、GPT-4等模型。在API Keys页面创建后即可使用。推荐理由是生态成熟，模型选择丰富。

Ollama（本地部署）：官网地址是 https://ollama.com，产品包括Llama 3、Mistral等开源模型。本地安装Ollama并下载模型即可使用。推荐理由是完全免费，隐私保护，无需联网。

对于初学者，我强烈推荐先使用Anthropic。注册流程简单，新用户有免费额度，体验效果最好。

1.3 Node.js版本检查

在终端中输入以下命令检查你的Node.js版本：

node -v

如果显示的版本号低于22.0（比如v20.x或v18.x），你需要升级Node.js。以下是快速升级方法：

使用nvm升级（推荐）：

# 安装nvm（如果没有）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载配置文件
source ~/.zshrc

# 安装Node.js 22 LTS
nvm install 22

# 设为默认版本
nvm alias default 22

使用npm直接升级：

# 清除缓存
npm cache clean -f

# 安装n模块
npm install -g n

# 升级到最新LTS版本
n lts

升级完成后，再次运行node -v确认版本已更新为22.x。

二、macOS系统安装详解

macOS是OpenClaw支持最完善的平台，也是大部分开发者的首选。以下是三种安装方法，你可以根据自己的情况选择。

2.1 方法一：官方安装脚本（推荐）

这是最简单的方式，官方安装脚本会自动检测你的环境并完成所有配置。适合绝大多数用户。

第一步：打开终端。按下Command + 空格键，在Spotlight搜索中输入“终端”或“Terminal”，然后按回车键打开终端应用。

第二步：运行安装命令。将以下命令复制到终端中并按回车：

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

第三步：查看安装过程。安装脚本会自动执行以下操作：检测系统环境、检查Node.js版本（如未安装会提示）、下载OpenClaw核心包、创建必要的配置文件、安装命令行工具。

安装过程中终端会显示类似下面的输出：

 OpenClaw 安装程序
==================
✓ 检测系统: macOS
✓ Node.js版本: v22.10.0
✓ 开始安装OpenClaw...
✓ 下载核心包... 完成
✓ 创建配置目录... 完成
✓ 安装命令行工具... 完成
✓ 安装完成！

第四步：验证安装。安装完成后，输入以下命令验证是否安装成功：

openclaw --version

如果成功，你会看到类似OpenClaw v1.2.3的输出（具体版本号可能不同）。

2.2 方法二：npm安装

如果你已经熟悉npm包管理，或者想要更精细的控制，可以选择npm安装方式。这种方法允许你指定特定版本或使用自定义配置。

第一步：检查Node.js和npm。在终端中分别运行以下命令：

node -v
npm -v

确保Node.js版本在22.0以上，npm版本在8.0以上。

第二步：全局安装OpenClaw：

npm install -g openclaw@latest

这个命令会将OpenClaw安装为全局可用的命令行工具。安装过程会显示进度条，等待安装完成。

第三步：安装守护进程。OpenClaw需要在后台持续运行才能接收消息，因此需要安装守护进程（Daemon）。运行以下命令：

openclaw onboard --install-daemon

这个命令会：创建LaunchDaemon配置（用于macOS后台服务管理）、设置开机自启动、立即启动守护进程。

终端会显示类似下面的输出：

✓ 创建LaunchDaemon配置
✓ 启动守护进程
✓ 守护进程已安装并运行

2.3 方法三：pnpm安装

如果你更习惯使用pnpm（一个更高效的包管理器），可以按照以下步骤安装。

第一步：安装pnpm（如果没有）：

npm install -g pnpm

第二步：全局安装OpenClaw：

pnpm add -g openclaw@latest

第三步：批准全局二进制文件。pnpm默认不自动创建全局二进制链接，需要手动批准：

pnpm approve-builds -g openclaw

第四步：安装守护进程：

openclaw onboard --install-daemon

三、Linux系统安装详解

Linux是服务器环境的首选，也是很多开发者的日常操作系统。OpenClaw对Linux的支持同样完善。

3.1 官方安装脚本

第一步：打开终端。在Linux中打开终端的方式取决于你的桌面环境。常见的快捷键是Ctrl + Alt + T。

第二步：运行安装命令：

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

安装脚本会自动检测你的Linux发行版并安装对应的依赖。

第三步：配置环境变量。脚本可能会提示你将OpenClaw添加到PATH。编辑你的.bashrc或.zshrc文件：

# 打开配置文件
nano ~/.bashrc

# 添加以下行（如果脚本没有自动添加）
export PATH="$PATH:$HOME/.openclaw/bin"

保存后重新加载配置：

source ~/.bashrc

3.2 npm安装

如果你更倾向于使用npm：

# 检查Node.js版本
node -v

# 如果版本低于22，先升级
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装OpenClaw
npm install -g openclaw@latest

# 安装守护进程
openclaw onboard --install-daemon

3.3 systemd服务配置（可选）

对于需要更精细控制的Linux用户，可以将OpenClaw配置为systemd服务。这样你可以使用标准的系统命令管理OpenClaw。

创建服务文件：

sudo nano /etc/systemd/system/openclaw.service

添加以下内容：

[Unit]
Description=OpenClaw AI Assistant
After=network.target

[Service]
Type=simple
User=你的用户名
WorkingDirectory=/home/你的用户名
ExecStart=/home/你的用户名/.nvm/versions/node/v22.10.0/bin/openclaw start
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

# 检查状态
sudo systemctl status openclaw

四、Windows系统安装详解

Windows用户有几种不同的安装方式可选。考虑到Windows环境的复杂性，我推荐使用WSL2，这能获得最接近Linux的体验。

4.1 WSL2安装（推荐）

WSL2（Windows Subsystem for Linux 2）是微软提供的Linux子系统，运行效率接近原生Linux，是运行OpenClaw的最佳选择。

第一步：启用WSL2。以管理员身份打开PowerShell（右键点击开始菜单，选择”Windows PowerShell（管理员）”），运行：

wsl --install

这个命令会：启用所需的Windows功能、下载并安装Linux内核更新包、安装Ubuntu作为默认发行版。安装过程中可能需要重启电脑。

第二步：设置Ubuntu。重启后会自动打开Ubuntu终端，要求你创建用户名和密码。注意：这个密码是Ubuntu的sudo密码，与Windows密码独立。

第三步：在Ubuntu中安装OpenClaw。现在你在Ubuntu环境中，可以按照Linux安装步骤进行：

# 更新软件源
sudo apt update && sudo apt upgrade -y

# 安装curl（如果没有）
sudo apt install curl

# 安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 验证安装
openclaw --version

第四步：从Windows访问OpenClaw。安装完成后，你可以在Windows的PowerShell或命令提示符中通过以下命令访问WSL中的OpenClaw：

wsl openclaw --version

4.2 PowerShell原生安装（有限功能）

如果不想使用WSL，OpenClaw也支持直接在Windows上运行，但功能会有所限制。

第一步：安装Node.js。打开 https://nodejs.org 下载LTS版本（22.x），运行安装程序，注意勾选”Add to PATH”选项。

第二步：打开PowerShell。按Win + X，选择”Windows PowerShell”。

第三步：安装OpenClaw：

npm install -g openclaw@latest

第四步：安装守护进程：

openclaw onboard --install-daemon

注意事项：PowerShell原生安装可能在某些Windows版本上遇到兼容性问题，如遇到问题建议使用WSL2方案。

4.3 Docker安装

对于熟悉Docker的Windows用户，这也是一个不错的选择。

第一步：安装Docker Desktop。从 https://www.docker.com/products/docker-desktop 下载并安装Docker Desktop。

第二步：拉取镜像：

docker pull openclaw/openclaw:latest

第三步：运行容器：

docker run -d --name openclaw -p 3000:3000 -v $env:USERPROFILE/.openclaw:/root/.openclaw openclaw/openclaw

五、Docker安装（跨平台通用）

Docker的最大优势是一次构建，到处运行。无论你使用macOS、Linux还是Windows，只要安装了Docker，就能以相同的方式运行OpenClaw。

5.1 安装Docker

macOS：

# 使用Homebrew安装
brew install --cask docker

# 或者从官网下载：https://www.docker.com/products/docker-desktop

Linux：

# Ubuntu/Debian
sudo apt install docker.io

# 启动Docker服务
sudo systemctl start docker
sudo systemctl enable docker

Windows：从 https://www.docker.com/products/docker-desktop 下载Docker Desktop并安装。

5.2 拉取OpenClaw镜像

docker pull openclaw/openclaw:latest

这个命令会从Docker Hub下载最新的OpenClaw镜像。首次下载可能需要几分钟，取决于你的网络速度。

5.3 运行OpenClaw容器

基础运行命令：

docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw

参数说明：-d表示后台运行，--name openclaw是容器名称，-p 3000:3000是端口映射（主机端口:容器端口），-v ~/.openclaw:/root/.openclaw是数据持久化（配置文件存储在本地）。

查看运行状态：

docker ps

如果看到openclaw容器正在运行，说明安装成功。

5.4 配置数据持久化

为了保护你的配置和数据，建议将配置目录挂载到本地。创建配置目录：

mkdir -p ~/openclaw-data

运行容器时指定数据目录：

docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/openclaw-data:/root/.openclaw \
  openclaw/openclaw

这样，你的所有配置都会保存在~/openclaw-data目录中，即使删除容器也不会丢失数据。

六、Web与桌面界面安装

除了命令行，OpenClaw还提供了图形界面，让你更直观地管理AI助手。

6.1 macOS桌面应用

下载桌面应用：打开 https://openclawlab.com/downloads，选择macOS版本的.dmg文件，下载完成后双击打开。

安装步骤：将OpenClaw图标拖拽到”应用程序”文件夹，打开”应用程序”文件夹，双击OpenClaw图标启动。

首次启动配置。首次打开时，应用会引导你完成初始配置：选择AI Provider（Anthropic/OpenAI/Ollama）、输入API Key、选择要连接的消息通道、设置工作目录。

6.2 Web模式

如果不想安装桌面应用，你也可以通过浏览器访问OpenClaw的Web界面。

启动Web服务。在终端中运行：

openclaw web

这个命令会启动一个本地Web服务器，默认端口是3000。

访问Web界面。打开浏览器，访问 http://localhost:3000

你会看到OpenClaw的Web界面，可以在这里：管理AI助手配置、查看对话历史、管理消息通道、设置个人偏好。

后台运行Web服务。如果想让Web服务持续运行，可以使用：

openclaw web &

或者使用pm2等进程管理工具：

npm install -g pm2
pm2 start "openclaw web" --name openclaw-web

# 查看状态
pm2 status

# 停止
pm2 stop openclaw-web

七、初始配置：onboard向导

安装完成后，我们需要通过onboard向导完成初始配置。这个过程会引导你设置AI Provider、消息通道和工作目录。

7.1 启动onboard向导

在终端中运行：

openclaw onboard --install-daemon

这个命令会启动交互式配置向导。终端会显示类似下面的界面：

╔═══════════════════════════════════════════╗
║         OpenClaw 初始配置向导              ║
╚═══════════════════════════════════════════╝

欢迎使用OpenClaw！让我们开始配置你的AI助手。

请选择你要使用的AI Provider：
1. Anthropic (推荐)
2. OpenAI
3. Ollama (本地部署)
4. 跳过稍后配置

7.2 配置AI Provider

选择Anthropic（推荐）。输入1然后按回车。系统会提示：

请输入你的Anthropic API Key：

在这里粘贴你的API Key（可以在 https://console.anthropic.com 获取）。

输入后按回车，系统会验证Key是否有效。如果有效，会显示：

✓ API Key验证成功
✓ 已保存配置

选择OpenAI。输入2然后按回车，同样需要输入API Key。

选择Ollama。输入3然后按回车。系统会提示：

请输入Ollama的地址（默认：http://localhost:11434）

直接按回车使用默认地址，或者输入自定义地址。

7.3 配置消息通道

配置完AI Provider后，向导会继续询问消息通道：

你想配置哪些消息通道？（可多选，用逗号分隔）
1. Telegram
2. Discord
3. WhatsApp
4. 邮件
5. 跳过稍后配置

配置Telegram通道。输入1后按回车，系统会提示：

请输入你的Telegram Bot Token：

这个Token需要通过@BotFather创建（详见常见问题章节）。

配置Discord通道。输入2后按回车，需要提供Discord Bot Token和服务器ID。

配置WhatsApp。输入3后按回车，会生成一个QR码，用WhatsApp扫描即可绑定。

7.4 配置工作目录

最后，向导会询问工作目录：

请输入你的工作目录路径（用于存储配置和数据）：

默认路径是~/.openclaw，可以直接按回车使用默认路径，或者输入自定义路径。

7.5 完成配置

配置完成后，系统会显示：

╔═══════════════════════════════════════════╗
║           配置完成！                        ║
╚═══════════════════════════════════════════╝

你的OpenClaw AI助手已经准备就绪！

启动命令：openclaw start
查看状态：openclaw status
帮助文档：openclaw --help

现在可以开始使用了。祝使用愉快！

八、验证安装成功

安装和配置完成后，我们需要验证一切是否正常工作。

8.1 检查版本

openclaw --version

预期输出类似：

OpenClaw v1.2.3

8.2 检查健康状态

openclaw health

这个命令会检查：AI Provider连接状态、消息通道连接状态、守护进程运行状态、配置文件完整性。

正常情况下会显示：

✓ AI Provider: 已连接 (Anthropic)
✓ 消息通道: 已连接 (Telegram)
✓ 守护进程: 运行中
✓ 配置文件: 完整
所有检查通过！

8.3 查看详细状态

openclaw status

这个命令会显示更详细的信息，包括：当前运行的版本、已配置的消息通道、AI模型信息、资源使用情况、最近的活动日志。

8.4 测试AI响应

你可以直接通过命令行测试AI是否正常工作：

openclaw chat "你好，请介绍一下你自己"

如果一切正常，你会收到AI的回复。

九、常见问题与解决方案

在安装和配置过程中，你可能会遇到一些问题。以下是常见问题及其解决方案。

9.1 Node.js版本问题

问题：安装时提示Node.js版本过低。

解决步骤：

# 查看当前版本
node -v

# 如果低于22，使用nvm升级
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc
nvm install 22
nvm use 22

9.2 权限问题

问题：安装时提示权限被拒绝（Permission denied）。

解决步骤：

macOS/Linux：

# 方法1：使用sudo（临时提权）
sudo npm install -g openclaw@latest

# 方法2：创建npm全局目录（推荐）
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# 然后将 ~/.npm-global/bin 添加到PATH
echo'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

9.3 守护进程问题

问题：守护进程无法启动或持续崩溃。

诊断步骤：

# 查看守护进程日志
openclaw logs

# 检查进程状态
ps aux | grep openclaw

# 手动启动守护进程（调试模式）
openclaw daemon --debug

常见原因：配置文件损坏（删除~/.openclaw/config.yaml重新配置）、端口被占用（检查3000端口是否被其他程序占用）、内存不足（检查系统内存使用情况）。

9.4 API Key配置问题

问题：AI Provider显示未连接。

解决步骤：

# 检查当前配置
openclaw config show

# 重新配置API Key
openclaw config set anthropic.key YOUR_API_KEY

# 验证连接
openclaw health

9.5 Telegram Bot创建问题

问题：不知道如何创建Telegram Bot。

解决步骤：在Telegram中搜索@BotFather，发送命令/newbot创建新机器人，按照提示设置机器人名称和用户名，BotFather会返回一个Token（复制这个Token用于OpenClaw配置），使用/start命令激活你的机器人。

9.6 Discord Bot创建问题

问题：不知道如何创建Discord Bot。

解决步骤：打开 https://discord.com/developers/applications，点击”New Application”创建应用，在”Bot”页面点击”Reset Token”获取Token，在”Privileged Intents”中启用MESSAGE CONTENT INTENT，使用OAuth2生成邀请链接，将机器人添加到你的服务器。

9.7 Docker容器问题

问题：Docker容器无法启动或立即退出。

解决步骤：

# 查看容器日志
docker logs openclaw

# 检查端口占用
lsof -i :3000

# 重新创建容器（保留数据）
docker rm -f openclaw
docker run -d --name openclaw -p 3000:3000 -v ~/openclaw-data:/root/.openclaw openclaw/openclaw

十、快速开始：你的第一条消息

完成所有配置后，让我们来发送第一条消息，体验OpenClaw的魅力。

10.1 通过Telegram发送消息

打开Telegram，找到你创建的机器人，发送/start激活机器人，然后发送任何问题，比如”帮我写一个Python的Hello World程序”。

10.2 通过Discord发送消息

进入配置好的Discord服务器，在文本频道中@你的机器人，发送问题，比如”解释一下什么是REST API”。

10.3 通过命令行测试

如果你还没有配置消息通道，也可以通过命令行测试：

openclaw chat "用JavaScript写一个计算器函数"

AI会返回一个完整的计算器实现代码。

总结

恭喜你！按照这篇文章的步骤，你已经成功完成了OpenClaw在所有主流平台上的安装和配置。无论你使用的是macOS、Linux、Windows，还是通过Docker部署，现在都可以开始使用你的个人AI助手了。

OpenClaw的核心优势在于多平台支持和高度可定制。你可以根据自己的需求选择合适的AI Provider（Anthropic、OpenAI或Ollama），配置一个或多个消息通道（Telegram、Discord、WhatsApp），甚至部署到服务器上实现7×24小时在线。

如果你在安装过程中遇到任何问题，可以参考本文的”常见问题与解决”章节，或者访问OpenClaw官方文档获取更多帮助。现在，是时候开始你的AI助手之旅了！开始提问，开始探索，让OpenClaw成为你工作和生活的得力助手吧！

欢迎关注我们，获取更多AI工具使用技巧和技术教程 有问题或想法？欢迎在评论区交流讨论

参考来源

• OpenClaw官网：https://openclawlab.com
• OpenClaw GitHub仓库：https://github.com/openclaw/openclaw
• OpenClaw官方安装文档：https://docs.openclaw.ai/getting-started
• Anthropic API文档：https://docs.anthropic.com
• Node.js官方下载：https://nodejs.org
• Docker官方文档：https://docs.docker.com