关键词：OpenClaw安装、AI Agent部署、Lighthouse部署、飞书机器人配置、Node.js 22

---

一、三种部署路线对比

在看具体步骤之前，先花 5 分钟选好路线——路线没选对，后面排查问题会很痛苦。

路线	描述	适合场景	成本	难度
本地安装	部署在个人电脑上	首次体验、验证可用性	低（仅 API 费用）	⭐⭐
腾讯云 Lighthouse	部署在云服务器	长期运行、随时在线	中（服务器费用）	⭐⭐⭐⭐
字节 ArkClaw	托管服务，开箱即用	不想运维、快速上手	中（按量付费）	⭐⭐

路线	吃灰用法	真香用法
本地安装	跑通就不管了，等需要时才开电脑	本地长期保持运行，配好飞书 WebSocket 随时随地发消息干活
Lighthouse	装好不配自启，重启就断，靠手动恢复	systemd 管理进程 + Nginx HTTPS，稳定在线，手机可用
ArkClaw	开通了就以为全配好，不管模型和权限	开通后配好模型+渠道+权限，当成零运维方案用

推荐路线：第一次使用优先选本地安装，验证可用后再考虑迁云。

---

二、路线一：本地安装

2.1 环境要求

依赖	版本要求	检查命令
Node.js	22+	node -v
操作系统	macOS / Linux / Windows 10+	—
大模型 API Key	任意支持厂商	—

升级 Node.js（版本不足时）：

# 使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22

# 验证
node -v   # 应显示 v22.x.x

2.2 安装 OpenClaw

macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（管理员 PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后验证：

openclaw --version

2.3 初始化配置

# 交互式向导，配置模型 API Key 和基本设置
openclaw onboard

向导会引导你配置：

• 大模型提供商和 API Key
• 消息渠道（飞书/企业微信等）
• 基本用户信息

2.4 启动服务

# 启动 Gateway
openclaw gateway start

# 验证服务状态
openclaw gateway status

访问 http://127.0.0.1:18789 确认界面正常加载。

2.5 接入飞书（推荐新手）

飞书支持 WebSocket 长连接，本地部署无需配置公网回调地址，比企业微信少一半配置量。

飞书开放平台配置步骤：

1. 登录 飞书开放平台
2. 创建企业自建应用
3. 记录 App ID 和 App Secret
4. 开启 Bot 能力
5. 事件订阅 → 添加 im.message.receive_v1 事件
6. 连接配置选择 长连接（WebSocket）

OpenClaw 侧配置：

# 新装用户直接通过向导添加
openclaw onboard

# 已安装的用户追加渠道
openclaw channels add
# 在列表中选择 Feishu，填入 App ID 和 App Secret

如果出现配对码提示：

openclaw pairing approve feishu <CODE>

2.6 常用运维命令

# 实时查看日志
openclaw logs --follow

# 重启 Gateway
openclaw gateway restart

# 检查状态
openclaw gateway status

# 查看已安装的渠道
openclaw channels list

2.7 关键文件路径

~/.openclaw/
├── openclaw.json       # 主配置文件
├── workspace/
│   ├── IDENTITY.md     # Agent 身份
│   ├── SOUL.md         # 行为准则
│   ├── USER.md         # 用户画像
│   ├── MEMORY.md       # 长期记忆
│   └── memory/         # 每日记忆日志
├── skills/             # 已安装的技能
└── logs/               # 运行日志

---

三、路线二：腾讯云 Lighthouse 部署

3.1 部署前准备

实例规格建议：

配置	推荐值	说明
CPU	2核+	1核在并发场景下会有明显卡顿
内存	4GB+	低于4G容易OOM
系统	Ubuntu 22.04	最稳定，文档最多
带宽	5Mbps+	主要影响响应延迟

3.2 部署顺序（必须按此顺序）

很多人先急着配渠道（填回调地址），结果发现服务连不上，排查了 2 小时才发现是端口没放通。

1. 创建实例（选 OpenClaw 应用模板，或 Ubuntu 22.04）
          ↓
2. 配置安全组（先放通端口，这一步最容易被跳过）
          ↓
3. SSH 登录，安装 OpenClaw
          ↓
4. 配置模型 API（openclaw onboard）
          ↓
5. 配置消息渠道
          ↓
6. 配置 HTTPS 和反向代理（推荐做）

3.3 安全组配置

必须放通的端口：

端口	用途	协议
22	SSH 管理	TCP
18789	OpenClaw Web UI（默认）	TCP
18790	OpenClaw API（默认）	TCP
443	HTTPS（配反向代理后）	TCP
80	HTTP（重定向到 HTTPS）	TCP

⚠️ 安全提醒：18789/18790 不建议直接对公网开放。推荐配置 Nginx 反向代理 + HTTPS + 访问认证。

3.4 云服务器安装命令

# SSH 登录后
ssh root@your-server-ip

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

# 安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 初始化
openclaw onboard
openclaw gateway start

3.5 配置开机自启（必做）

cat > /etc/systemd/system/openclaw.service << EOF
[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root
ExecStart=/usr/local/bin/openclaw gateway start
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable openclaw
systemctl start openclaw

# 验证
systemctl status openclaw

3.6 Nginx 反向代理配置（推荐）

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:18789;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

---

四、路线三：ArkClaw 托管服务

4.1 ArkClaw 的本质

ArkClaw 不是"在云服务器上手动安装 OpenClaw"，而是直接在火山引擎控制台开通托管实例，平台帮你管机器。

区别：

• 路线二（Lighthouse）：你租服务器，自己装环境，自己运维
• 路线三（ArkClaw）：平台提供完整服务，你只需配置参数

4.2 适用性判断

选 ArkClaw 的条件：

• ✅ 不需要底层服务器控制权
• ✅ 不需要自定义部署环境
• ✅ 可以接受平台的使用约束
• ✅ 优先考虑运维成本而非灵活性

不适合 ArkClaw 的情况：

• ❌ 需要安装自定义 Skill
• ❌ 需要访问特定的内网资源
• ❌ 对数据存储位置有严格要求

---

五、三种路线的验收标准

不管选哪条路，部署完成后都要做三项验收：

验收1：Web UI 可访问

本地：http://127.0.0.1:18789
云上：https://your-domain.com 或 http://server-ip:18789

验收2：发一个执行型指令

不要只发"你是谁"，要发一个具体任务：

帮我总结一下这段话的重点：
[粘贴一段文字]

确认能正常回复，且回复质量合理。

验收3：渠道消息收发正常

在飞书/企业微信给机器人发消息，确认能正常收到并回复。

---

六、常见问题排查

Q1：安装完打不开 http://127.0.0.1:18789

# 检查服务是否在运行
openclaw gateway status

# 检查端口是否被占用
lsof -i :18789

# 查看错误日志
openclaw logs --follow

Q2：飞书机器人不回复消息

排查顺序：

1. openclaw logs --follow 看有没有收到消息
2. 检查飞书开放平台的事件订阅是否配置 im.message.receive_v1
3. 确认选择的是 WebSocket 长连接而不是 HTTP 回调
4. 企业网络环境下尝试切换到手机热点

Q3：API Key 配置后模型不回复

# 重新跑向导检查配置
openclaw onboard

# 查看日志中的 API 错误
openclaw logs --follow | grep -i error

Q4：云上部署后服务偶尔断线

• 确认配置了 systemd 开机自启（见 3.5）
• 检查服务器内存是否充足：free -h
• 查看系统日志：journalctl -u openclaw -f

---

七、装好之后：下一步是什么

安装是起点，不是终点。装好 OpenClaw 之后，体验好不好主要取决于：

1. Skill 技能配置（第3篇）：决定龙虾能干什么
2. Memory 记忆调教（第4篇）：决定它懂不懂你
3. 安全加固（第5篇）：决定用得安不安心

建议按顺序阅读系列后续文章。

---

⚠️ 版本说明：安装命令、端口号、控制台界面等可能随版本更新。遇到与文档不符的情况，优先参考 docs.openclaw.ai 的最新说明。

---

系列导航：

• 第1篇：认识 OpenClaw
• 第2篇：安装路线选择（本篇）
• 第3篇：Skill 技能系统
• 第4篇：Memory 记忆调教
• 第5篇：安全加固
• 第6篇：Token 省钱手册
• 第7篇：小红书全流程
• 第8篇：数据分析实战