OpenClaw搭建教程：本地+云端一键部署，打造专属AI智能体

OpenClaw搭建全攻略：本地+云端一键部署，打造你的AI智能体🦞

OpenClaw（曾用名ClawdBot、Moltbot）是一款开源AI智能体网关，主打本地优先、模型无关、多渠道接入，能让AI直接执行文件操作、浏览器自动化、消息收发等真实任务，数据完全可控 。本文从环境准备到本地/云端部署，再到配置与避坑，带你从零搭建专属AI助手。

一、环境要求（必看）

• 系统：Windows 10+/macOS 12+/Linux（Ubuntu 20.04+）
  ​
• Node.js：≥22.0.0（低于此版本必报错）
  ​
• 内存：≥2GB（推荐4GB+）
  ​
• 工具：Git、pnpm（推荐）、curl
  ​
• 可选依赖：FFmpeg（视频处理）、Playwright（浏览器自动化）

二、本地部署（3种方式，新手首选一键安装）

方式1：国内镜像一键安装（最快）

Windows（PowerShell，管理员权限）

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

macOS/Linux/WSL

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

验证安装

openclaw --version
# 显示版本号即成功

方式2：pnpm手动安装（有Node环境首选）

# 配置国内镜像加速
pnpm config set registry https://registry.npmmirror.com/
# 全局安装
pnpm install -g openclaw@latest
# 初始化配置
openclaw onboard

方式3：源码编译（开发者/二次开发）

# 克隆国内仓库
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn
# 安装pnpm
npm install -g pnpm
# 安装依赖+构建
pnpm install
pnpm ui:build
pnpm build
# 初始化
pnpm openclaw onboard --install-daemon

三、初始化配置（核心步骤）

执行 openclaw onboard 后，按交互式向导操作：

1. 接受风险提示 → 输入 Yes 
​
2. 选择启动模式 → 推荐 QuickStart 
​
3. 选择AI模型（国内推荐DeepSeek、智谱GLM、Kimi；国外选Claude、OpenAI）
​
4. 输入对应模型的API Key
​
5. 选择消息渠道（飞书、Telegram、企业微信等）
​
6. 设置Gateway端口（默认18789）
​
7. 启用所需技能（Skills）
​
8. 配置完成后自动启动，访问 http://localhost:18789 进入Web控制台

四、云端部署（阿里云，7×24小时在线）

适合长期运行，不受本地设备限制：

1. 购买阿里云ECS：选OpenClaw镜像，内存≥2GB，地域选美国弗吉尼亚（国内地域联网搜索受限）
​
2. 获取阿里云百炼API Key（在百炼控制台创建）
​
3. 放行端口：在服务器控制台放行18789端口
​
4. 配置API Key：粘贴密钥并执行命令写入配置
​
5. 生成访问Token，通过 http://公网IP:18789 访问Web界面

五、常见问题与避坑

1. Node版本过低：务必升级到v22+，否则安装失败
​
2. 依赖下载慢：提前配置国内npm/pnpm镜像源
​
3. 端口占用：修改 config.json 中的端口号，或关闭占用18789的进程
​
4. 模型API报错：检查API Key是否正确、是否有余额、是否符合服务商条款
​
5. 功能无法使用：确认对应技能（Skills）已启用，安装FFmpeg/Playwright等依赖

六、OpenClaw核心优势

• 本地部署：数据不离开设备，隐私安全拉满
  ​
• 模型无关：兼容主流大模型，可切换本地/云端模型
  ​
• 多渠道接入：飞书、企微、Telegram等随时指挥AI
  ​
• 主动执行：能操作文件、浏览器、自动化任务，不只是聊天
  ​
• 开源免费：MIT协议，可二次开发定制功能Open Claw官网