OpenClaw 安装与部署完整指南

本文将详细介绍如何在你的设备上安装和部署 OpenClaw，从环境准备到完成第一个对话，带你快速体验这个强大的个人 AI 助手。

系统要求

运行环境

OpenClaw 需要 Node.js 22+ 运行时环境：

• 推荐：Node.js 24 LTS
• 最低：Node.js 22.16+（兼容性支持）

检查你的 Node 版本：

$ node --version

操作系统支持

OpenClaw 支持以下操作系统：

• macOS：原生支持
• Linux：原生支持
• Windows：通过 WSL2（强烈推荐）

安装方法

方法一：使用安装脚本（推荐）

macOS / Linux

使用官方安装脚本，一键安装：

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

Windows（PowerShell）

使用 PowerShell 安装：

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

方法二：使用包管理器

如果你使用 npm 或 pnpm：

# 使用 npm
$ npm install -g openclaw@latest

# 使用 pnpm
$ pnpm add -g openclaw@latest

方法三：从源码编译（开发环境）

如果你想从源码编译安装：

$ 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 onboard --install-daemon

向导会引导你完成以下配置：

1. 模型提供商认证

选择一个模型提供商并配置 API 密钥：

• OpenAI：需要 API Key
• Anthropic：需要 API Key
• Google：需要 OAuth 或 API Key
• 本地模型：配置 Ollama 或其他本地推理引擎

2. 网关设置

配置网关的基本参数：

• 端口：默认 18789
• 工作目录：配置文件和状态文件存储位置

3. 渠道配置（可选）

选择要连接的聊天平台：

• Telegram：配置最简单，需要 Bot Token
• WhatsApp：需要 QR 扫码配对
• Discord：需要 Bot Token
• Slack：需要 App 凭证
• Feishu：需要单独安装插件

启动网关

方法一：作为服务运行（推荐）

配置向导会自动安装服务，检查服务状态：

$ openclaw gateway status

如果服务正在运行，你会看到类似输出：

✓ Gateway is running (PID: 12345)
  Port: 18789

方法二：前台运行

用于快速测试或调试：

$ openclaw gateway --port 18789 --verbose

打开控制界面

启动网关后，打开控制界面：

$ openclaw dashboard

或者直接访问：http://127.0.0.1:18789/

发送第一条消息

通过控制界面

在浏览器中打开 http://127.0.0.1:18789/，在聊天框中输入消息：

Hello from OpenClaw

通过命令行

如果你已经配置了聊天渠道，可以通过命令行发送测试消息：

# 发送消息到 Telegram
$ openclaw message send --target +15555550123 --message "Hello from OpenClaw"

通过 AI Agent

直接与 AI Agent 对话：

$ openclaw agent --message "Ship checklist" --thinking high

验证安装

运行诊断工具检查安装状态：

$ openclaw doctor

诊断工具会检查：

• Node.js 版本是否满足要求
• 网关服务是否正常运行
• 配置文件是否有效
• 模型提供商认证是否正确
• 渠道配置是否有效
• 安全策略是否合理

环境变量

OpenClaw 支持以下环境变量自定义配置：

更新 OpenClaw

更新到最新版本

使用以下命令更新：

# 使用安装脚本更新（推荐）
$ curl -fsSL https://openclaw.ai/install.sh | bash

# 或使用 npm/pnpm 更新
$ npm update -g openclaw@latest
$ pnpm update -g openclaw@latest

切换开发渠道

OpenClaw 提供多个开发渠道：

• stable：稳定版本，推荐生产使用
• beta：测试版本，包含新功能
• dev：开发版本，最新功能但可能不稳定

# 切换到 beta 渠道
$ openclaw update --channel beta

常见问题

Q: 安装脚本提示权限错误？

A: 确保有 sudo 权限，或手动安装 npm 包。

Q: 网关无法启动？

A: 运行 openclaw doctor 诊断问题，常见原因包括端口占用、配置文件错误等。

Q: 模型提供商认证失败？

A: 检查 API Key 是否正确，确保网络可以访问提供商的 API 端点。

Q: Windows 上如何运行？

A: 强烈推荐使用 WSL2，因为 OpenClaw 原生支持 Linux，Windows 上可能会有兼容性问题。

下一步

安装完成后，你可以：

• 配置更多聊天渠道
• 了解工具系统
• 配置多 Agent 路由

相关资源

• 官方快速入门文档
• 更新指南
• 常见问题解答

cnbugsai

打赏 海报 链接