OpenClaw 搭建教程 – 搭建你自己的 AI 智能体助手-殇恋社区

想自己搭一个能真正干活的 AI 助手，OpenClaw 是目前很值得试的一套方案。

它不只是聊天机器人，而是一个可以接工具、跑自动化、收发消息、操作文件和浏览器的开源 AI 智能体网关。对想折腾个人助理、自动化工作流，或者搭一个自己可控的 AI 系统的人来说，OpenClaw 的可玩性很高。

这篇教程尽量按”新手能直接照着做”的思路来写：先看环境要求，再选本地安装或云端部署，最后补上初始化配置和常见问题。

一、环境要求

开始之前，先确认你的环境是否满足以下条件：

操作系统：Windows 10+、macOS 12+、Linux（推荐 Ubuntu 20.04+）
Node.js：建议 22.0.0 及以上，版本过低会直接报错
内存：至少 2GB，想跑得更稳建议 4GB 以上
基础工具：Git、pnpm、curl
可选组件：FFmpeg（处理音视频时需要）、Playwright（浏览器自动化需要）

如果你只是想先跑起来体验，基础环境满足以后，优先走一键安装最省心；如果你本身就熟悉 Node.js 生态，再考虑 pnpm 手动安装或源码编译。

⚠️ 安全提示：一键安装脚本是从远程服务器下载并执行代码。虽然本文引用的镜像源是社区维护的，但任何 curl ... | bash 或 iwr ... | iex 操作都存在安全风险——你无法完全确认脚本中是否包含恶意代码。建议在执行前先查看脚本内容，或者选择手动安装方式。本教程提供多种安装方式，你可以根据自己对安全性的要求来选择。

二、本地部署：先把服务跑起来

本地部署适合自己先测试、先熟悉功能，也方便后续慢慢扩展技能和自动化能力。

方式 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.js 环境，并且平时也习惯用 pnpm，这种方式更灵活，也避免了远程脚本的风险。

# 设置国内镜像源（加速下载）
pnpm config set registry https://registry.npmmirror.com/

# 全局安装 OpenClaw
pnpm install -g openclaw@latest

# 运行初始化配置向导
openclaw onboard

这里的核心是最后一条 openclaw onboard，它会带你走一轮初始化配置向导。

方式 3：源码编译（适合开发者）

适合想自己从源码完整构建、或准备做二次开发的用户。

# 克隆源码（使用 Gitee 国内镜像）
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 这一步。它会引导你完成以下配置：

接受风险提示，输入 Yes 确认
选择启动模式，通常选 QuickStart 更省事
选择模型服务商，比如 DeepSeek、智谱 GLM、Kimi、Claude、OpenAI 等
填写对应的 API Key（请提前在模型服务商平台申请）
选择需要接入的消息渠道，如飞书、Telegram、企业微信等
设置 Gateway 端口，默认常见是 18789
启用需要的技能（Skills）
完成后访问 Web 控制台检查是否正常启动

初始化完成后，在浏览器中访问：

http://localhost:18789

如果页面能打开，模型能回复消息，说明整体链路已经基本通了。

四、云端部署：适合长期在线运行

如果你希望 OpenClaw 24 小时在线，或者不想依赖本地电脑一直开机，那就直接上云服务器。

4.1 准备云服务器

推荐配置：至少 2 核 CPU、2GB 内存、40GB 硬盘。系统建议 Ubuntu 20.04 或 22.04。阿里云、腾讯云、华为云均可。

4.2 连接到服务器并安装 Node.js

# SSH 登录
ssh root@你的服务器IP

# 安装 Node.js 22.x
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node -v
npm -v

4.3 安装 OpenClaw

# 安装 pnpm
npm install -g pnpm

# 设置国内镜像源
pnpm config set registry https://registry.npmmirror.com/

# 全局安装 OpenClaw
pnpm install -g openclaw@latest

# 运行初始化向导
openclaw onboard

初始化过程中，按提示填写模型 API Key 和消息渠道配置。

4.4 放行防火墙端口

OpenClaw 默认使用 18789 端口。需要在云服务商安全组中放行此端口：

协议：TCP
端口：18789
来源：0.0.0.0/0（或限制为你的 IP）

同时检查服务器系统防火墙：

# Ubuntu/Debian
sudo ufw allow 18789/tcp

4.5 设置后台运行

直接用 openclaw 命令启动的话，关闭终端后服务就会停止。推荐使用 PM2 或 systemd 来管理进程：

# 使用 PM2（推荐）
npm install -g pm2
pm2 start openclaw --name openclaw
pm2 save
pm2 startup

# 使用 nohup（简单但不推荐长期使用）
nohup openclaw > openclaw.log 2>&1 &

4.6 访问云端控制台

浏览器访问 http://你的服务器IP:18789，如果能打开控制台页面，说明部署成功。

安全建议：如果要从公网访问，建议配置 HTTPS 和访问密码。你可以使用 Nginx 反向代理 + Let’s Encrypt 免费 SSL 证书来实现。

五、常见问题与排错

问题	原因	解决方法
Node 版本过低	OpenClaw 要求 Node.js 22+	升级到 Node.js 22 或更高版本
依赖下载太慢	npm/pnpm 默认从国外源下载	切换国内镜像源（见安装步骤）
端口被占用	18789 被其他服务占用	修改端口，或关闭冲突进程
模型 API 调不通	Key 填错、账户欠费、模型不可用	检查 Key、余额、模型状态
某些功能不可用	技能未启用，或缺少依赖	启用对应技能，安装 FFmpeg/Playwright