安装 OpenClaw 之前,先别急着敲命令
系列:养虾实战 · 第2篇 | 阅读时间:约6分钟
有读者私信我,说按着教程装 OpenClaw,卡在飞书回调那一步,卡了 3 小时没搞定,最后放弃了。
我问他选的哪条路,他说"就是看网上有什么教程,跟着敲"。
问题不是命令错了,是路线压根没选对。
01 🗺️ 先看结论:三条路各有什么盘
| 路线 | 适合谁 | 代价 |
|---|---|---|
| 本地安装 | 第一次接触,想低成本试跑 | 电脑要开着,离线断联 |
| 腾讯云 Lighthouse | 想长期在线,绑定域名 | 要买服务器,处理端口和安全组 |
| 字节 ArkClaw | 不想运维,只想快速开始 | 灵活度受限,平台约束多 |
第一次养虾?先选本地。 把模型、网关、消息渠道在本地跑通,再决定要不要上云。
02 🏠 路线一:本地安装 + 飞书(推荐新手起手式)
最适合第一次养虾的起点——先跑通,再迁云。
第一步:检查 Node.js 版本
OpenClaw 需要 Node.js 22+。很多人跳过这步,结果报各种奇怪错误。
node -v # 确认版本是 22 或以上
# 版本不对,用 nvm 升级
nvm install 22
nvm use 22
第二步:安装
macOS / Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows(管理员 PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
第三步:初始化 + 启动
# 按向导配置模型 API Key、基本设置
openclaw onboard
# 启动 Gateway
openclaw gateway start
打开浏览器访问 http://127.0.0.1:18789,能看到界面说明本地服务起来了。
为什么推荐飞书而不是企业微信?
飞书支持 WebSocket 长连接,本地接入不需要公网回调地址。企业微信需要配置回调 URL + 可信 IP + Token + AES Key,参数多一倍,新手容易在这里翻车。
# 新装用户,直接用向导添加飞书
openclaw onboard
# 已装好的用户,追加渠道
openclaw channels add
# 在交互列表里选 Feishu
飞书开放平台侧需要:
- 创建企业自建应用,拿到
App ID和App Secret - 启用 Bot 能力
- 事件订阅里添加
im.message.receive_v1 - 连接方式选 WebSocket / long connection(不需要公网回调)
如果机器人回了一个配对码:
openclaw pairing approve feishu <CODE>
验收三步
http://127.0.0.1:18789能打开- 给机器人发一句话,它能回复
- 发一个具体指令("帮我总结这段文字"),而不只是"你是谁"
⚠️ 默认假设你的网络没有严格限制 WebSocket 出站。企业网络死活连不上的,先试手机热点排查。
03 ☁️ 路线二:腾讯云 Lighthouse(长期在线)
目标是随时能用、手机能连、不依赖本地电脑开机——可以考虑 Lighthouse。
部署顺序,别搞反
1. 选实例(优先找 OpenClaw 应用模板,没有就选 Ubuntu 22.04)
2. 选规格(最低 2核4G,别为省几块钱把配置压太低)
3. 先放通端口(22 + Web 端口,默认 18789/18790)
4. 配模型 API(openclaw onboard)
5. 最后接渠道
为什么顺序很重要? 最常见的翻车方式:端口没放通就先配渠道,回调一直超时,但你以为是配置写错了。一个端口问题,花了 3 小时怀疑人生。
云上必须额外做的三件事
| 事项 | 吃灰用法 | 真香用法 |
|---|---|---|
| 开机自启 | 不配,服务器重启后手动上去重启 | 配好 systemd,重启自动恢复 |
| 日志监控 | 出问题才去翻,翻半天找不到 | openclaw logs --follow 随时可看 |
| HTTPS | 直接用 IP:端口访问 | 域名 + Nginx + HTTPS,专业且安全 |
# 查看实时日志
openclaw logs --follow
# 检查 Gateway 状态
openclaw gateway status
04 🚀 路线三:ArkClaw(最省事,但要搞清楚它是什么)
这里有个常见误解:很多人把 ArkClaw 当成"手动安装的云版本"。
不对。 ArkClaw 是直接去火山引擎控制台开通托管服务实例,不是你 SSH 上去装环境。平台帮你管机器,你只负责配置参数。
适合谁:不想碰服务器、不想理解安全组和反向代理、只想尽快把工具跑起来、本来就在字节体系内。
边界在哪:灵活度不如自建,某些高级配置受平台约束,底层控制权有限。
05 🔧 不管哪条路,都绕不开这四类配置
模型配置
三条路线都需要先接模型:
openclaw onboard # 按向导填入 API Key
常见可选:通义千问、腾讯混元、DeepSeek、Claude、GPT-4o。
渠道配置
- 本地:飞书优先走 WebSocket
- 云上企业微信:需要回调地址 + 可信 IP + Token + AES Key
- ArkClaw:省了运维,但权限和协作配置依然需要自己处理
网关与端口
# 本地:确认 Gateway 在 127.0.0.1:18789
# 云上:确认安全组放通了对应端口
openclaw gateway status
端口不通,其他配再好都没用。 云上排错第一步永远是检查端口。
关键文件路径
~/.openclaw/openclaw.json # 主配置文件
~/.openclaw/memory/ # 记忆目录
~/.openclaw/skills/ # 技能目录
~/.openclaw/logs/ # 日志目录
06 ❓ 几个常见问题
Q:飞书和企业微信,新手选哪个? 飞书。WebSocket 长连接不需要公网回调,少一半配置量。企业微信留到熟练了再搞。
Q:Lighthouse 装完就稳定了吗? 装完只是开始。至少还要:安全组检查、日志路径确认、自动重启配置、HTTPS。很多服务不是装坏的,是装完没人看,半夜掉线第二天才发现。
Q:装好了,但感觉跟直接用 ChatGPT 差不多? 正常。安装只是搭好了舞台,演出还没开始。真正影响体验的是后面的 Skill 配置和记忆调教,而不是安装步骤本身。
Q:ArkClaw 是不是完全不用配了? 不是。它省掉的是"装机器"这件事,但模型、权限、协作流程这些还需要自己处理。
下一篇
第3篇:Skill 不是插件——装完 OpenClaw 感觉没比 ChatGPT 强多少,问题出在这
装好之后大概率会发现"好像也没什么用"。这不是系统的错,而是安装只搭好了舞台,真正的演出还没开始。下篇讲 Skill。
系列导航:[第1篇 认识龙虾] → [第2篇 安装路线](本篇)→ [第3篇 Skill技能] → [第4篇 Memory记忆] → [第5篇 安全加固] → [第6篇 省钱指南] → [第7篇 小红书实战] → [第8篇 数据分析]
更多内容,关注【一深思AI】公众号