OpenClaw

主题

安装部署 ​

本指南详细介绍 OpenClaw 的各种安装和部署方式。

系统要求 ​

最低配置 ​

  • CPU: ≥2核
  • 内存: ≥4GB
  • 磁盘: ≥10GB 可用空间

必备工具 ​

  • Node.js: ≥22（推荐 v24）
  • Git: 用于克隆仓库
  • Docker: 可选，推荐用于沙箱隔离

本地部署 ​

方式一：新手引导向导（推荐） ​

这是在 macOS、Linux 或 Windows（通过 WSL2）上设置 OpenClaw 的推荐方式。

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

# Windows PowerShell（管理员模式）
iwr -useb https://openclaw.ai/install.ps1 | iex

按照引导流程配置：

  • 本地 Gateway 或远程 Gateway 连接
  • 渠道配置
  • Skills 设置
  • 工作区默认值

方式二：npm 全局安装 ​

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

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

安装完成后：

bash
# 启动引导配置
openclaw onboard

# 或打开控制界面（无需设置渠道）
openclaw dashboard

方式三：Git 源码安装 ​

适合开发者：

bash
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
pnpm install

# 构建 UI
pnpm ui:build

# 启动
pnpm start

方式四：Docker 部署 ​

bash
# 拉取镜像
docker pull openclaw/openclaw:latest

# 创建专用用户（推荐）
sudo useradd -m node
sudo usermod -aG docker node

# 运行容器
docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.openclaw:/home/node/.openclaw \
  openclaw/openclaw:latest

Slim Docker：2026.3.8 版本新增多阶段构建，减少容器体积。

快速开始 ​

最快开始聊天的方式 ​

无需设置渠道，直接打开控制界面：

bash
openclaw dashboard

然后在浏览器中访问 http://localhost:3000 进行聊天。

推荐设置 Brave Search API 密钥，以便智能体可以使用 web_search：

bash
openclaw configure --section web

这会存储 tools.web.search.apiKey。

云端部署 ​

腾讯云部署（推荐国内用户） ​

腾讯云是国内首个提供 OpenClaw 应用模板的云平台，提供一键秒级部署服务。

方式一：轻量应用服务器（推荐新手） ​

步骤一：购买服务器

访问 腾讯云 OpenClaw 部署专题，点击【立即部署我的 AI 助理】。

配置推荐：

  • 入门级：2核2G，适合个人体验
  • 推荐配置：2核4G，适合日常使用
  • 高性能：4核8G，适合团队协作

地域选择：

  • 国内用户：选择国内地域（广州、上海、北京等）
  • 海外用户：选择香港或新加坡

步骤二：选择应用模板

在购买页面选择：

  1. 应用创建方式：应用模板
  2. 应用类型：AI 智能体
  3. 应用名称：OpenClaw (Clawdbot)

步骤三：配置 OpenClaw

在轻量应用服务器控制台：

  1. 进入【应用管理】页签
  2. 配置模型（选择混元、Kimi、GPT 等）
  3. 配置通道（企业微信、QQ、钉钉、飞书等）

步骤四：启动使用

bash
# SSH 连接服务器
ssh root@your-server-ip

# 查看状态
openclaw status

# 启动服务
openclaw start

方式二：智能体开发平台（企业用户） ​

访问 腾讯云智能体开发平台，提供：

  • 企业级权限管理
  • 安全审核机制
  • 渠道集成
  • 运维管理

💡 详细教程请查看 腾讯云部署专题

腾讯云部署快速链接 ​

百度云部署 ​

访问 百度智能云文档。

GPU 云服务器部署 ​

适合需要运行本地大模型的用户：

  1. 选择 GPU 配置（如 A100 40G）
  2. 选择 windows_OpenClaw 专属镜像
  3. 远程连接服务器
  4. 运行本地模型脚本
  5. 启动 OpenClaw

配置文件 ​

主配置文件 ​

位置：~/.openclaw/openclaw.json

json
{
  "accessControlList": {
    "allowFrom": ["+1234567890"]
  },
  "groupRules": {
    "requireMention": true
  }
}

访问控制 ​

json
{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890"]
    }
  }
}

安全第一

  • 始终设置 channels.whatsapp.allowFrom
  • 永远不要在你的个人 Mac 上对全世界开放
  • 为助手使用专用的 WhatsApp 号码

配对渠道 ​

WhatsApp ​

bash
# 配对 WhatsApp
openclaw pair whatsapp

# 或让机器人所有者批准
# ask the bot owner to approve with: openclaw pairing <code>

Telegram ​

bash
# 配对 Telegram
openclaw pair telegram

Discord ​

bash
# 配对 Discord
openclaw pair discord

后续配置 ​

重新配置 ​

bash
openclaw configure

查看状态 ​

bash
openclaw status

查看日志 ​

bash
openclaw logs

验证安装 ​

bash
# 运行诊断
openclaw doctor

# 检查配置
openclaw config list

# 测试连接
openclaw test

常见问题 ​

Node.js 版本问题 ​

使用 nvm 管理 Node 版本：

bash
# 安装 nvm-windows
curl -o nvm-setup.exe https://github.com/coreybutler/nvm-windows/releases/download/1.1.12/nvm-setup.exe

# 安装 Node 24
nvm install 24
nvm use 24

权限问题 ​

在 Windows 上，确保使用管理员模式打开 PowerShell。

端口占用 ​

检查端口占用：

bash
# macOS/Linux
lsof -i :3000

# Windows
netstat -ano | findstr :3000

下一步 ​

基于 MIT 许可发布

Copyright © 2026 OpenClaw 知识库