🌟 新手友好版：补全Windows部署、高清步骤截图、术语白话解释，400+人验证的避坑指南

同样是装 OpenClaw，为什么有人 5 分钟搞定，有人装了 3 次还没跑通？不是安装难，是你选错了路。

OpenClaw 有三种部署方式，每种适合的人完全不同。选对了，20 分钟跑通；选错了，折腾一晚上还是一头雾水。这篇文章只做一件事：帮你选对方案，然后手把手带你跑通（含Windows/ Mac/Linux全平台）。

---

一、先选路：3种部署方案，哪个适合你

📌 读表结论： 第一次接触选 A，想长期稳定用选 B，重视数据安全选 C。无高下之分，只看适配阶段！

方案	难度	时间	费用	适合谁
A：飞书妙搭一键部署	⭐	5 分钟	免费	完全不懂技术的新手
B：腾讯云 VPS + 飞书打通	⭐⭐	20 分钟	免费/50元/月	想全天候在线的实战派
C：本地部署（Win/Mac/Linux）	⭐⭐⭐	10-20 分钟	完全免费	有技术基础、重视数据隐私

💡 被低估的本地部署：为什么值得试？很多人看到"⭐⭐⭐"就跳过，其实这是新手最低成本试错方案：

• ✅ 数据完全自控：对话记录、Memory 文件、API Key（模型调用计量单位，1000 Token≈750个中文字符，复杂任务消耗更快）全在自己机器上，无第三方泄露风险；

• ✅ 零成本：不用付服务器费，不用抢免费资源，装好就能用；

• ✅ 调试方便：日志实时看，报错直接排查，不用SSH连服务器；

• ❌ 唯一缺点：关机就断线，出门无法访问。

固定设备办公/学习阶段，优先选本地部署；熟悉后再迁VPS，成本最低、风险最小。

---

二、方案 A：飞书妙搭一键部署（5 分钟版）

✅ 结论：门槛最低，零技术背景，点几下就能跑！

飞书官方适配的「飞书妙搭 + OpenClaw」，自动完成服务器启动、安装、飞书连接全流程，新手闭眼冲。

操作步骤（全程5分钟）

1. 打开领取页面：手机/电脑访问 → https://miaoda.feishu.cn/bot

2. 创建AI助手：填名称、设头像→点击「创建」，系统自动完成：云端服务器启动→OpenClaw安装→飞书连接（【截图位置】：飞书妙搭创建Agent页面，标注「创建」按钮+名称输入框）；

3. 开始对话：部署完成后点击「去飞书对话」，直接和机器人聊天。

⚠️ 注意事项

• 飞书妙搭赠送的 Token 消耗快，复杂任务多轮思考会快速用完；

• 长期用建议接入自己的API Key（智谱AI新用户赠2000万 Token，性价比最高）；

• 数据存在飞书云端，隐私敏感用户建议选方案C。

---

三、方案 B：腾讯云 VPS + 飞书打通（推荐，20 分钟版）

✅ 结论：400+人验证的稳定方案，全天候在线，新手也能跑通！

第一阶段：领取/购买腾讯云服务器

方式1：免费领取（新用户专属）

1. 打开活动地址：https://www.codebuddy.cn/promotion/；

2. 微信扫码登录→绑定手机号→点击「立即领奖」→下载CodeBuddy客户端；

3. 客户端登录后返回活动页→「立即领取」→选「轻量应用服务器」2核2G→地域选就近城市→确认支付（0元）。

方式2：活动领不到？直接购买（约50元/月）

1. 腾讯云官网：https://cloud.tencent.com/product/lighthouse；

2. 选「轻量应用服务器」→2核2G配置→地域选就近城市→操作系统选「应用模板-OpenClaw」；

3. 支付后按后续步骤配置即可。

⚠️ 免费服务器资源有限，需在工作日10点/15点抢，领不到直接选方式2！

第二阶段：重装OpenClaw镜像（【截图位置】：腾讯云服务器实例页，标注「重装系统」按钮+「应用模板」选择框）

1. 进入腾讯云控制台→找到服务器实例；

2. 右上角「...」→「重装系统」；

3. 选「使用应用模板」→勾选「OpenClaw」；

4. 设置服务器密码（务必记！）→确认重装；

5. 等待2分钟，状态变为「运行中」后，点击实例页「概览/监控」右侧的「应用管理」标签。

第三阶段：配置模型（优先选智谱AI，中文最优）

1. 注册智谱开放平台：https://www.bigmodel.cn→领取2000万Token体验包→复制API Key；

2. 回到腾讯云「应用管理」面板→填入：模型厂商选智谱AI，模型名称填GLM-4.5-Air；

3. 点击「添加并应用」，右上角提示「模型添加应用成功」即完成。

第四阶段：接入飞书（【截图位置】：飞书开发者后台，标注「企业自建应用」入口+「权限管理」搜索框）

1. 飞书开发者后台：https://open.feishu.cn→左侧导航栏「企业自建应用」→「创建应用」→填名称（如OpenClaw机器人）→类型选「机器人」→创建；

2. 复制「App ID」「App Secret」（后续要用）；

3. 「添加应用能力」→「机器人」→「添加」；

4. 「权限管理」→搜索im:→勾选右上角「批量开通」→确认开通所有即时通讯权限；

5. 「版本管理与发布」→「创建版本」→填版本号→确认发布；

6. 腾讯云「Channel配置」→选飞书→填入App ID/Secret→「添加并应用」。

第五阶段：配置事件与联调（关键！漏一步必报错）

1. 飞书后台→「事件与回调」→「事件配置」→「使用长链接（飞书机器人接收消息的方式，无需配置公网IP/回调地址，新手优先选）」→保存；

2. 「添加事件」→搜索「接收消息」→勾选保存；

3. 「回调配置」→「使用长链接」→保存；

4. ❗重新创建版本并发布（每次改配置都要发，90%新手栽在这步）；

5. 飞书搜机器人名字→发「你好」→收到回复=成功✅。

---

四、方案 C：本地部署（Win/Mac/Linux，进阶版）

✅ 结论：完全免费，数据最安全，关机断线是唯一缺点！

1. Mac 用户（10分钟）

# Step 1：安装 Homebrew（无则执行）/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# Step 2：安装 Node.jsbrew install nodenode -v  # 预期输出 v22.x.x 或更高# Step 3：安装并启动 OpenClawnpm install -g openclawopenclaw -v  # 输出版本号=安装成功openclaw init   # 按提示填模型/API Keyopenclaw gateway start

2. Linux/VPS 用户（20分钟）

# 用nvm管理Node.js，避免90%权限报错curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bashsource ~/.bashrc  # zsh终端替换为 source ~/.zshrc# 安装Node.js 22并设为默认nvm install 22 && nvm use 22 && nvm alias default 22# 安装OpenClawnpm install -g openclawopenclaw initopenclaw gateway start# VPS用户额外配置：后台持续运行（pm2=Node.js进程管理工具，关机重启自动恢复）npm install -g pm2pm2 startup && pm2 save

3. Windows 用户（新增！15分钟）

# Step 1：下载nvm-windows（Node.js版本管理工具）# 下载地址：https://github.com/coreybutler/nvm-windows/releases# Step 2：安装后【管理员身份运行CMD】nvm install 22nvm use 22# Step 3：安装并启动OpenClawnpm install -g openclawopenclaw init   # 按提示填模型和API Keyopenclaw gateway start

---

五、装完必做：验收清单 + 升级版报错排查

📌 验收清单：5项全绿，才算真跑通！

检查项	命令	预期结果	排查建议
Node.js 版本	node -v	v22+	用nvm/ nvm-windows重装
OpenClaw 版本	openclaw -v	最新版本号	重新执行 npm install -g openclaw
Gateway 状态	openclaw gateway status	Running	检查端口是否被占用
模型连通性	openclaw chat "你好"	正常回复	核对API Key/模型厂商是否匹配
配置自检	openclaw doctor	无报错	按提示修复配置文件

4类高频报错速查（补充漏检场景）

1. command not found: openclaw原因：npm全局路径未加入PATH 解决：

   npm config get prefixecho 'export PATH="$PATH:/你的输出路径/bin"' >> ~/.bashrc && source ~/.bashrc

2. EACCES permission denied原因：Linux/macOS npm权限不足 解决：用nvm重新装Node.js，无需sudo，自动解决权限问题。

3. port in use原因：3000端口被占用 解决：

   lsof -i :3000  # 查看占用进程openclaw config set gateway.port 3001  # 改端口为3001

4. API Key invalid原因：① Key填错/带空格 ② 模型厂商选错 ③ Key过期/额度用尽 解决：重新运行openclaw init核对厂商+Key，或登录智谱平台查额度。

💡 配置备份提醒：执行openclaw config show查看配置文件路径，备份后重装可直接复用，不用重复填Key！

---

结尾：选对方案，让AI真正帮你干活

三种方案无好坏，只看适配阶段：

• 🆕 新手第一次：选A（5分钟跑通，先体验）；

• 📌 想长期用：选B（全天候在线，400+人验证）；

• 🔒 重视隐私：选C（全平台支持，数据不出门）。

装好只是第一步，下一篇我们讲「Claude Code + OpenClaw + 飞书全打通」——把三个工具连成线，让AI帮你自动写代码、处理任务！

💬 互动福利

装的过程中卡在哪一步了？是「API Key无效」「端口占用」还是「飞书权限配置」？评论区留具体问题，我1对1解答，还会把高频坑补充到报错清单里～

想解锁OpenClaw高阶用法（多轮记忆、批量处理）？关注公众号【XXX】，回复「OpenClaw进阶」领400+人验证的实战手册，加入交流群避坑！

---

关键词标签：#OpenClaw #AI Agent #快速入门 #安装教程 #飞书 #腾讯云 #Windows部署 #本地部署 #新手避坑

---

📌 本文为「OpenClaw 实操指南」系列第 06 篇 上一篇：[05｜Claude Code 快速入门实战：30分钟跑通全流程] 下一篇：[07｜Claude Code + OpenClaw + 飞书全打通实战]

---

来源参考：

• OpenClaw 官方文档：https://docs.openclaw.ai/zh-CN

• 飞书妙搭官方：https://miaoda.feishu.cn/bot

• 智谱 AI 开放平台：https://www.bigmodel.cn

相关阅读：

OpenClaw 实操指南 05｜Claude Code本地部署零基础实操教程-新人也可以拥有自己的AI模型

OpenClaw实操指南 04｜主流AI编程模型权威对比：Claude Code/Codex/Gemini+国产，你的模型选对了吗？

OpenClaw实操指南03｜OpenClaw vs Coze/Dify/n8n 帮你10分钟内选对合适的AI

OpenClaw实操指南02｜OpenClaw到底是什么：从"聊天AI"到"数字员工"的认知升级

OpenClaw实操指南01｜发刊词：为什么要做一套能落地的OpenClaw实操系列