OpenClaw 部署指南：一行命令到完整的多渠道 AI 助手

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

本文将详细介绍如何在你的机器或 VPS 上部署 OpenClaw，从最快的一键安装脚本到 Docker 容器化部署，覆盖 macOS、Linux 和 Windows（WSL2）三大平台，并完成第一次成功对话。

条件说明 Node.js ≥ 22.16（推荐 Node 24） 操作系统 macOS / Linux / Windows（推荐 WSL2）网络能访问 AI 服务商 API（OpenAI/Claude 等）及目标消息平台内存至少 512 MB 可用 RAM

Windows 用户注意： 强烈推荐在 WSL2 中运行 OpenClaw，原生 Windows 支持有一定限制。

OpenClaw 本身不提供 AI 模型，你需要至少准备一个 API Key：

OpenAI：从创建
Anthropic（Claude）：从获取
或其他支持的模型提供商

这是最简单的方式，脚本会自动检测、安装 Node.js 并完成初始化引导。

macOS / Linux / WSL2：

GPT plus 代充 只需 145curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）：

GPT plus 代充 只需 145iwr -useb https://openclaw.ai/install.ps1 | iex

脚本执行完毕后会自动启动交互式 onboarding 引导程序，按提示填写 API Key 和选择渠道即可。

GPT plus 代充 只需 145# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s – –no-onboard

# Windows PowerShell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

如果你已经有 Node.js 环境，可以直接用包管理器安装：

1
2

GPT plus 代充 只需 145npm install -g openclaw@latest
openclaw onboard –install-daemon

macOS 上遇到 sharp 构建错误？ 尝试：
1
GPT plus 代充 只需 145SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

1
2
3

GPT plus 代充 只需 145pnpm add -g openclaw@latest
pnpm approve-builds -g # 批准含 build script 的包（首次必须执行）
openclaw onboard –install-daemon

–install-daemon 参数会把 Gateway 注册为后台系统服务：

macOS：注册为 launchd 用户服务（自动随登录启动）
Linux：注册为 systemd 用户服务
Windows：创建计划任务

这样 Gateway 无需每次手动启动，后台持续运行。

Docker 方式适合部署在无桌面的 Linux VPS 上，完全隔离，易于更新。

确保已安装 Docker 和 Docker Compose。

GPT plus 代充 只需 145# 克隆仓库（或只下载 docker-compose.yml）
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 复制环境变量模板
cp .env.example .env
# 编辑 .env 填入你的 API Key
nano .env

# 启动服务
docker compose up -d

.env 文件关键变量：

GPT plus 代充 只需 145# AI 模型配置（至少填一个）
OPENAI_API_KEY=sk-your-openai-key-here

# Gateway 设置
OPENCLAW_STATE_DIR=/data/openclaw # 数据持久化目录

GPT plus 代充 只需 145docker compose logs -f openclaw

1
2

GPT plus 代充 只需 145docker compose pull
docker compose up -d

适合想参与贡献或调试的开发者：

GPT plus 代充 只需 145git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖（必须用 pnpm）
pnpm install

# 构建 Web UI（首次必须）
pnpm ui:build

# 构建项目
pnpm build

# 全局链接 CLI
pnpm link –global

# 执行引导
openclaw onboard –install-daemon

开发时使用热重载模式：

GPT plus 代充 只需 145pnpm gateway:watch # 修改源码后自动重载

安装完成后，用以下命令验证 Gateway 是否正常运行：

GPT plus 代充 只需 145# 检查配置和连接状态
openclaw doctor

# 查看 Gateway 状态
openclaw status

# 打开 Web 控制台（在浏览器中查看仪表盘）
openclaw dashboard

openclaw doctor 输出示例：

GPT plus 代充 只需 145✅ Node.js 24.0.0 — OK
✅ Gateway service installed — OK
✅ Gateway running at ws://127.0.0.1:18789 — OK
✅ OpenAI API key — OK
⚠️ No channel connected — Add a channel to start chatting

打开 Telegram，搜索并与 @BotFather 对话
发送 /newbot，按提示输入 Bot 名称
获得 Bot Token，格式如：:AABBccDD…

编辑配置文件（通常在 ~/.openclaw/config.json）：

GPT plus 代充 只需 145{
 "channels": {
 "telegram": {
 "token": ":AABBccDD…",
 "dmPolicy": "pairing"
 }
 }
}

或通过 openclaw onboard 引导程序交互式配置。

GPT plus 代充 只需 145openclaw gateway restart

在 Telegram 中找到你的 Bot，发送第一条消息。首次消息会收到配对码提示，用 CLI 审批：

GPT plus 代充 只需 145openclaw pairing approve telegram 
          
      
            <收到的配对码>

审批后即可正常对话！

全局 npm 包路径没在 \(PATH 里。执行：

1
2

GPT plus 代充 只需 145export PATH="\)(npm prefix -g)/bin:\(PATH"
echo 'export PATH="\)(npm prefix -g)/bin:$PATH"‘ >> ~/.zshrc

GPT plus 代充 只需 145# 查看占用端口的进程
lsof -i :18789

# 或在配置文件中改端口
# ~/.openclaw/config.json
{
 "gateway": { "port": 18790 }
}

GPT plus 代充 只需 145# 稳定版
openclaw update --channel stable

# 最新预发布版
openclaw update --channel beta

方式适合人群难度守护进程一键脚本完全新手 ⭐ ✅ 自动 npm 安装有 Node 基础 ⭐⭐ ✅ onboard Docker VPS / 服务器 ⭐⭐⭐ ✅ compose 源码构建开发者 ⭐⭐⭐⭐ 手动

参考资料：

安装文档:
Docker 部署:
渠道配置:

OpenClaw 部署指南：一行命令到完整的多渠道 AI 助手

相关推荐