OpenClaw 本地 AI 助手部署与飞书对接指南

如果看到 TUI 聊天界面，说明安装成功，可以尝试输入 Hello 进行测试。

查看服务状态

openclaw status

访问 Web UI 管理面板

服务监听在 http://127.0.0.1:18789/ 端口上，通过 SSH 隧道访问：

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

然后在浏览器打开 http://127.0.0.1:18789/。首次访问可能需要获取 Token，可在服务器输入 openclaw dashboard 获取 Dashboard URL。

对接飞书机器人

回到刚才的配置向导，选择 Feishu/Lark (飞书) 添加通道。

1. 选择 Download from npm(@openclaw/feishu) 安装扩展。
2. 登录飞书开放平台 https://open.feishu.cn，创建企业自建应用。
3. 在凭据管理中获取 App ID 和 App Secret。
4. 添加机器人能力并配置名称。
5. 在 OpenClaw 配置中输入 App ID 和 App Secret。
6. 选择域名为 Feishu (feishu.cn)，群组策略选择 Open。
7. DM 策略选择 Open。
8. 完成配置后重启服务：openclaw gateway restart。

飞书后台配置

1. 回到飞书开发者后台，找到「事件和回调」，选择长连接模式。
2. 添加事件，选择「接收消息」。
3. 开通权限：contact:user.base:readonly 和 im:message。
4. 发布应用版本。

发布完成后，回到飞书客户端，点击打开应用，向机器人发送 Hello 即可收到回复。

常用命令速查

常见问题 FAQ

OpenClaw 和 Clawdbot、Moltbot 是什么关系？

OpenClaw 是该项目的最新正式名称。项目最初叫 Clawdbot，后因商标问题更名为 Moltbot，最终定名为 OpenClaw。三者是同一个项目的不同阶段命名。

为什么安装时提示 npm install failed？

这通常是服务器内存不足导致的。新版本脚本对内存要求较高，2G 内存可能会出现 OOM。建议配置 swap 交换空间。

飞书机器人配置后无法收到消息怎么办？

请检查以下几点：

1. 确认飞书通道已正确安装。
2. 检查 App ID 和 App Secret 配置是否正确。
3. 确认已开通「接收消息」事件权限。
4. 检查长连接模式是否配置成功。
5. 确保应用版本已发布。
6. 使用 openclaw gateway restart 重启服务后再试。

如何配置 swap 解决内存不足？

如果服务器内存不足 2GB，可以配置 swap 交换空间：

# 创建 2G 的 swap 文件
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

端口 18789 被占用怎么办？

使用其他端口启动服务：

openclaw gateway --port 18790

提示 openclaw 命令找不到怎么办？

这通常是环境变量未加载导致的。尝试以下步骤：

1. 关闭当前终端窗口，重新打开。
2. 执行 source ~/.bashrc 重新加载环境变量。
3. 如果还不行，执行 openclaw doctor 检查问题。
4. 实在无法解决，尝试重启服务器。