OpenClaw 搭建教程：本地与云端部署全流程，小白也能快速上手

想自己搭一个能真正干活的 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 手动安装或源码编译。

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

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

方式 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/
pnpm install -g openclaw@latest
openclaw onboard

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

方式 3：源码编译

适合开发者、二次开发玩家，或者你就是想自己从源码完整构建一遍。

git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn
npm install -g pnpm
pnpm install
pnpm ui:build
pnpm build
pnpm openclaw onboard --install-daemon

如果只是普通用户，其实不一定非走源码，除非你后面准备自己改功能或做深度定制。

三、初始化配置：决定你能不能顺利跑起来

安装完成后，重点就是 openclaw onboard 这一段。常见流程大概是这样：

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

一般来说，本地访问地址会是：

http://localhost:18789

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

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

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

比较常见的思路是准备一台轻量云主机或 ECS，至少给到 2GB 内存，再把端口、模型配置和远程访问一起搞定。

大致流程可以按下面来：

1. 准备云服务器，配置不要太低，2GB 内存起步更稳
2. 安装 OpenClaw 或直接使用现成镜像
3. 准备模型 API Key，并写入配置
4. 在服务器安全组里放行控制台端口（常见是 18789）
5. 生成访问 Token，确保外部能安全访问管理界面

如果你主要在国内网络环境下使用，镜像源、依赖下载速度和模型供应商可用性，都会直接影响部署体验，这块建议提前准备好。

五、常见坑位，提前绕开会省很多时间

1. Node 版本过低：这是最常见的报错源，直接升到 22+ 基本能少掉一半问题
2. 依赖下载太慢：提前切国内 npm / pnpm 镜像源，安装会顺很多
3. 端口被占用：如果 18789 被别的服务占了，就换端口，或者先把冲突进程关掉
4. 模型 API 调不通：重点检查 Key 是否填对、账户是否有余额、对应模型是否可用
5. 某些功能不可用：大概率是技能没启用，或者 FFmpeg、Playwright 这类依赖没装全

六、为什么值得折腾 OpenClaw

简单说，它的核心优势不在“能聊天”，而在“能执行”。

1. 本地优先：数据更可控，隐私压力更小
2. 模型无关：可以根据预算和需求切换不同模型服务
3. 渠道接入灵活：能接飞书、Telegram、企业微信等
4. 自动化能力强：能动文件、动浏览器、跑任务，不只是陪聊
5. 开源可改：如果你有开发能力，可以继续往下深挖

如果你现在想找一个既能自己掌控、又能真正落地干活的 AI 助手框架，OpenClaw 确实是一个值得认真试试的方向。

总结一下：如果你是第一次接触 OpenClaw，推荐先本地一键安装，确认模型和控制台都能跑通以后，再考虑迁移到云端长期运行。这样路径最顺，也最不容易劝退。