【AI Agent实战】 安装 OpenClaw 之前,先别急着敲命令

64 阅读5分钟

安装 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

飞书开放平台侧需要:

  1. 创建企业自建应用,拿到 App IDApp Secret
  2. 启用 Bot 能力
  3. 事件订阅里添加 im.message.receive_v1
  4. 连接方式选 WebSocket / long connection(不需要公网回调)

如果机器人回了一个配对码:

openclaw pairing approve feishu <CODE>

验收三步

  1. http://127.0.0.1:18789 能打开
  2. 给机器人发一句话,它能回复
  3. 发一个具体指令("帮我总结这段文字"),而不只是"你是谁"

⚠️ 默认假设你的网络没有严格限制 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】公众号

qrcode_for_gh_cf428a5f23ea_258.jpg