OpenClaw Linux 本地部署与飞书机器人对接指南

配置虚拟内存 (2GB 内存服务器必做)
防止安装过程中因内存不足 (OOM) 导致失败，这一步很关键：

# 创建 2G 交换文件
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# 设置开机自动挂载
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
# 验证
free -h

2. 安装 OpenClaw

执行官方一键安装脚本：

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

注意：首次安装耗时约 5-10 分钟，请勿中断。若提示 npm install failed，请检查虚拟内存是否生效。

3. 初始化配置向导

安装完成后会自动进入向导 (openclaw onboard)，按以下步骤操作：

1. 安全确认：输入 Yes 确认知晓风险。
2. 模式选择：选择 QuickStart (快速配置)。
3. 模型选择：选择 Qwen (OAuth) (通义千问)。
4. 授权登录：终端会显示 URL 和验证码，在本地浏览器打开该 URL，登录通义千问账号并授权，成功后终端会自动继续。
5. 模型确认：选择 Keep current 保持默认模型。
6. 通道配置：选择 Skip for now (稍后单独配置飞书)。
7. 技能配置：选择 No (稍后安装)。
8. 启动方式：选择 Hatch in TUI 进入终端聊天测试。输入 Hello 测试响应，按 Ctrl + C 退出终端界面。

4. 访问 Web 管理面板

OpenClaw 默认监听本地端口 18789，需通过 SSH 隧道访问：

获取带 Token 的链接 (在服务器终端执行)：

openclaw dashboard

本地终端执行 (替换为您的用户名和 IP)：

ssh -N -L 18789:127.0.0.1:18789 用户名@服务器公网IP

核心步骤：对接飞书机器人

1. 飞书开放平台配置

1. 创建应用：登录飞书开放平台，进入'开发者后台' -> '创建企业自建应用'，填写名称并上传图标。
2. 获取凭证：在'凭证与基础信息'中，复制 App ID 和 App Secret。
3. 添加机器人能力：点击'应用能力' -> 添加'机器人'。
4. 开通权限 (关键)：进入'权限管理'，搜索并开通以下权限：
   • contact:user.base:readonly (获取用户信息)
   • im:message (发送接收消息，勾选全部子项)
   • im:chat (获取群组信息)
5. 配置事件订阅：进入'事件与回调' -> '事件配置'，订阅方式选'使用长连接'，添加事件 im.message.receive.v1 (接收消息)。
6. 发布应用：进入'应用发布'，创建版本并发布（个人版自动通过）。

2. OpenClaw 配置飞书通道

• 在通道列表中选择 Feishu/Lark (飞书)，选择 Download from npm 安装插件。
• 填入飞书 App ID 和 App Secret。
• 配置策略：域名选择 Feishu (feishu.cn)，群聊与私聊策略均设为 Open。

重启服务：配置完成后，务必重启网关使配置生效：

openclaw gateway restart

报错处理：若提示 Cannot find module 'zod'，请重新进入配置向导：

openclaw onboard

(依次确认安全风险、QuickStart 模式、模型配置，直到通道选择页)

3. 验证

在飞书中搜索机器人名称，发送 Hello，若收到回复即表示对接成功。

常用运维命令速查

常见问题排查

Q1: 安装时提示 npm install failed 或卡住？

• 原因：内存不足。
• 解决：检查是否已配置 2GB 虚拟内存 (free -h 查看 Swap 行)。若未配置，请按上文步骤配置后重试。

Q2: 飞书机器人无响应？

• 检查清单：
  1. 飞书应用是否已发布（版本状态为'已上线'）？
  2. im:message 等权限是否已开通？
  3. App ID 和 Secret 是否填写正确？
  4. 是否执行了 openclaw gateway restart？

查看日志：

# 查看技能运行日志
docker exec -it openclaw-2026 tail -f /opt/openclaw/logs/skills/run.log
# 或者查看系统日志
journalctl -u openclaw-gateway -f

Q3: Web 面板无法访问？

• 原因：SSH 隧道断开或 Token 失效。
• 解决：确保本地终端的 SSH 隧道命令正在运行，或在服务器执行 openclaw dashboard 获取最新带 Token 的链接。

Q4: openclaw 命令提示 command not found？

• 解决：执行 source ~/.bashrc 刷新环境变量，或关闭终端重开。