OpenClaw 最新保姆级飞书对接指南教程 搭建属于你的 AI 助手

OpenClaw（曾用名 Clawdbot、Moltbot）是一个运行在你本地环境的高权限 AI 智能体。它的核心特性包括：

• • 本地部署：运行在你的服务器或电脑上，数据完全自主可控
• • 多平台支持：支持飞书、WhatsApp、Telegram、Discord、Slack 等主流聊天工具
• • 浏览器控制：可以浏览网页、填写表单、提取数据
• • 系统访问：读写文件、执行 Shell 命令、运行脚本
• • 持久化记忆：记住你的偏好和上下文，成为真正属于你的 AI
• • 插件扩展：支持社区技能插件，甚至可以自己编写插件

无论是邮件管理、日程安排、数据查询还是代码编写，OpenClaw 都能成为你的得力助手。

安装前准备工作

不想手动安装？可以点击阿里云一键部署，几分钟即可完成服务器搭建。

安装 OpenClaw 依赖环境

第一步：安装 Git

sudo apt updatesudo apt install git -y

第二步：安装 Node.js

# 国内使用 gitee 镜像curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash# 国外使用curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash# 重新加载环境变量source ~/.bashrc# 安装 Node.js 22nvm install 22# 验证node -v  # 输出 v22 即可

第三步：安装 OpenClaw

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

服务器在国内如果安装失败，需要解决网络问题。

安装成功后会自动进入引导配置，依次选择：

① 确认安全风险 → 选择「Yes」

② 选择 QuickStart → 快速配置模式

③ 选择模型服务商 → 推荐选择 Qwen（OAuth），免费额度充足，入门首选

④ 完成 OAuth 授权 → 复制链接到浏览器打开，登录后返回确认

⑤ 选择默认模型 → 保持默认（qwen-portal/coder-model）即可

⑥ 跳过 Channel 配置 → 后续单独配置飞书

⑦ 跳过 Skills 配置

⑧ 选择启动方式 → Hatch in TUI（推荐）

看到 TUI 聊天界面即安装成功，输入 Hello 测试，然后按 Ctrl+C 关闭。

查看服务状态

openclaw status

服务正常运行时会显示 Dashboard 地址：http://127.0.0.1:18789/

访问 OpenClaw Web UI 管理面板

服务监听在 18789 端口，通过 SSH 隧道访问：

ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP# 输入密码后，在浏览器打开 http://127.0.0.1:18789/

首次访问显示未授权状态，回到服务器执行：

openclaw dashboard

复制输出的 Dashboard URL（含 Token），粘贴到浏览器即可正常访问。

对接飞书机器人

第一步：重新进入配置向导

openclaw configure

选择 Feishu/Lark（飞书） → 确认下载安装飞书扩展

遇到 zod 模块报错？ 先退出，安装 zod 后删除旧扩展重试：

npm install -g zodrm -rf ~/.openclaw/extensions/feishuopenclaw configure  # 重新进入

第二步：飞书开放平台创建应用

1. 1. 登录 飞书开放平台
2. 2. 创建企业自建应用 → 获取 App ID 和 App Secret
3. 3. 添加机器人功能

第三步：填入 App ID 和 App Secret

回到终端，输入第一步获取的 App ID 和 App Secret，连接成功后：

• • 选择飞书域名：Feishu（feishu.cn）
• • 群组策略：选择 Open（全部放开）
• • DM 策略：选择 Open（public）

第四步：重启服务

openclaw gateway restart

第五步：配置事件订阅

在飞书开放平台，找到「事件和回调」→ 选择长连接模式 → 添加「接收消息」事件。

第六步：开通权限

需要开通以下权限：

第七步：发布版本

每次修改配置后都需要重新发布版本，建议全部配置完成后再统一发布。

发布完成后，向机器人发送 Hello，即可收到回复。

常用命令速查

成本说明与免费模型推荐

OpenClaw 本身完全免费开源，主要成本来自服务器和 AI 模型 API 调用：

建议先用通义千问免费额度体验，熟练后再根据需求选择。

常见问题 FAQ

Q：安装时提示 npm install failed？

通常是服务器内存不足（2G 内存容易 OOM）。建议配置 swap：

sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Q：飞书机器人配置后无法收到消息？

检查：飞书通道是否正确安装 → App ID 和 App Secret 是否正确 → 是否开通「接收消息」事件 → 长连接模式是否配置成功 → 应用版本是否已发布 → 重启服务 openclaw gateway restart。

Q：openclaw 命令找不到？

尝试 source ~/.bashrc 重新加载环境变量，或执行 openclaw doctor 检查问题。

Q：端口 18789 被占用？

使用其他端口启动：openclaw gateway --port 18790

总结

本篇教程从环境准备、OpenClaw 部署、飞书机器人对接到权限配置，完整走完了开源 AI 助手 OpenClaw 的搭建流程。配合通义千问的免费额度，零成本就能拥有一个 7×24 小时在线的专属 AI 助手，有问题直接问它，睡觉时它还能继续干活。

参考资料：

• • OpenClaw 官方文档：https://docs.openclaw.ai/
• • OpenClaw GitHub：https://github.com/openclaw/openclaw
• • 飞书开放平台：https://open.feishu.cn