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

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

OpenClaw 是一款开源的本地 AI 助手，本篇 OpenClaw 安装教程将手把手教你在 Linux 系统下部署最新版 OpenClaw，并完成飞书机器人对接。OpenClaw 支持在你自己的服务器上运行，通过飞书、WhatsApp、Telegram 等聊天工具交互。与云端 SaaS 服务不同，OpenClaw 让你完全掌控数据隐私，可以执行系统命令、浏览网页、管理文件，甚至编写代码——是你的专属开源 AI 助手。

注意：本教程在 Linux 系统下进行

OpenClaw 是什么？

OpenClaw(原名 Clawdbot,后更名为 Moltbot,现正式命名为 OpenClaw)是一个运行在你本地环境的高权限 AI 智能体。它的核心特性包括：

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

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

OpenClaw 安装前的准备工作

安装 OpenClaw 需要满足以下环境要求：

安装 OpenClaw 依赖环境

如果你不想手动安装依赖、配置环境，可以直接使用 阿里云 OpenClaw 一键部署，几分钟即可完成 OpenClaw 服务器搭建。

如果你选择手动安装，继续往下看。

第一步安装 Git

# 安装 Gitsudoapt update sudoaptinstallgit -y 

第二步安装 Node.js

# 安装 NVM# 国内使用 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 22 nvm install22# 查看 nodejs 版本node -v # 输出 v22 即可，版本只要 22 就行

安装 OpenClaw 开源 AI 助手

# 使用官方脚本安装curl -fsSL https://openclaw.bot/install.sh |bash

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

其他平台安装方式请参考OpenClaw 安装文档 (原 Clawdbot)

你会看到如下

 🦞 OpenClaw Installer Siri's competent cousin. ✓ Detected: linux ✓ Node.js v22.22.0 found ✓ Git already installed → Installing OpenClaw 2026.2.6-3... ✓ OpenClaw installed 🦞 OpenClaw installed successfully (2026.2.6-3)! Home sweet home. Don't worry, I won't rearrange the furniture. Starting setup... 🦞 OpenClaw 2026.2.6-3 (85ed6c7) — curlfor conversations. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██ ██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██ ██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ 🦞 OPENCLAW 🦞 ┌ OpenClaw onboarding 

如果首次安装，时间会很长，需要耐心等待。
如果最后输出如下内容：

→ npminstall failed; cleaning up and retrying... 

新的脚本服务器内存要求变高了，据我使用下来 2G 内存，肯定会 OOM，如果出错的话，建议使用 swap 把硬盘空间当作交互内存使用。

成功之后会输出会看到下面的输出

┌ OpenClaw onboarding │ ◇ Security ──────────────────────────────────────────────────────────────────────────────╮ │ │ │ Security warning — please read. │ │ │ │ OpenClaw is a hobby project and still in beta. Expect sharp edges. │ │ This bot can read files and run actions if tools are enabled. │ │ A bad prompt can trick it into doing unsafe things. │ │ │ │ If you're not comfortable with basic security and access control, don't run OpenClaw. │ │ Ask someone experienced to help before enabling tools or exposing it to the internet. │ │ │ │ Recommended baseline: │ │ - Pairing/allowlists + mention gating. │ │ - Sandbox + least-privilege tools. │ │ - Keep secrets out of the agent's reachable filesystem. │ │ - Use the strongest available model for any bot with tools or untrusted inboxes. │ │ │ │ Run regularly: │ │ openclaw security audit --deep │ │ openclaw security audit --fix │ │ │ │ Must read: https://docs.openclaw.ai/gateway/security │ │ │ ├─────────────────────────────────────────────────────────────────────────────────────────╯ │ ◆ I understand this is powerful and inherently risky. Continue? │ ● Yes / ○ No └ 

第一个选项就是询问你是否知道风险的，需要选择 yes, 然后回车。
第二步选择 QuickStart

◆ Onboarding mode │ ● QuickStart (Configure details later via openclaw configure.) │ ○ Manual └ 

第三步选择模型服务商，这里选择 Qwen，免费额度充足，适合入门快速使用

◆ Model/auth provider │ ○ OpenAI │ ○ Anthropic │ ○ MiniMax │ ○ Moonshot AI (Kimi K2.5) │ ○ Google │ ○ xAI (Grok) │ ○ OpenRouter │ ● Qwen (OAuth) │ ○ Z.AI (GLM 4.7) │ ○ Qianfan │ ○ Copilot │ ○ Vercel AI Gateway │ ○ OpenCode Zen │ ○ Xiaomi │ ○ Synthetic │ ○ Venice AI │ ○ Cloudflare AI Gateway │ ○ Skip for now └ 

选择千问模型后，选择 Qwen OAuth 之后 会提供一个链接，复制并在浏览器中打开

 Qwen auth method │ ● Qwen OAuth │ ○ Back └ 

 Starting Qwen OAuth… ◇ Qwen OAuth ─────────────────────────────────────────────────────────────────────────╮ │ │ │ Open https://chat.qwen.ai/authorize?user_code=-AYWBJHL&client=qwen-code to approve │ │ access. │ │ If prompted, enter the code -AYWBJHL. │ │ │ ├──────────────────────────────────────────────────────────────────────────────────────╯ ◓ Waiting for Qwen OAuth approval…... 

复制链接后，打开浏览器，会看到如下界面。由于我已登录过，所以显示账户信息；如果尚未登录，按照提示完成登录即可。

登录完成后，会出现以下选项，提示选择对应的千问模型，如下图

◇ Qwen OAuth complete │ ◇ Model configured ─────────────────────────────╮ │ │ │ Default model set to qwen-portal/coder-model │ │ │ ├────────────────────────────────────────────────╯ │ ◇ Provider notes ──────────────────────────────────────────────────────────────────────╮ │ │ │ Qwen OAuth tokens auto-refresh. Re-run login if refresh fails or access is revoked. │ │ Base URL defaults to https://portal.qwen.ai/v1. Override │ │ models.providers.qwen-portal.baseUrl if needed. │ │ │ ├───────────────────────────────────────────────────────────────────────────────────────╯ │ ◆ Default model │ ● Keep current (qwen-portal/coder-model) │ ○ Enter model manually │ ○ qwen-portal/coder-model │ ○ qwen-portal/vision-model └ 

选择默认模型 Keep current (qwen-portal/coder-model) 即可。接下来会提示选择 channel，这里先跳过，后续再添加。之前飞书都没有内置的，现在新版本飞书已经内置了

 Select channel (QuickStart) │ ○ Telegram (Bot API)(not configured) │ ○ WhatsApp (QR link) │ ○ Discord (Bot API) │ ○ Google Chat (Chat API) │ ○ Slack (Socket Mode) │ ○ Signal (signal-cli) │ ○ iMessage (imsg) │ ○ Feishu/Lark (飞书) │ ○ Nostr (NIP-04 DMs) │ ○ Microsoft Teams (Bot Framework) │ ○ Mattermost (plugin) │ ○ Nextcloud Talk (self-hosted) │ ○ Matrix (plugin) │ ○ BlueBubbles (macOS app) │ ○ LINE (Messaging API) │ ○ Zalo (Bot API) │ ○ Zalo (Personal Account) │ ○ Tlon (Urbit) │ ● Skip for now └ 

继续下面选择 skills，也是选择 No

 Skills status ────────────╮ │ │ │ Eligible: 6 │ │ Missing requirements: 43 │ │ Blocked by allowlist: 0 │ │ │ ├────────────────────────────╯ │ ◆ Configure skills now? (recommended) │ ○ Yes / ● No └ 

然后等待安装完成，最后会出现以下选项，这里选择 TUI

◆ How do you want to hatch your bot? │ ● Hatch in TUI (recommended) │ ○ Open the Web UI │ ○ Do this later └ 

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

然后直接使用 ctrl+c 先关闭，后面我们再来设置

查看 OpenClaw 服务状态

可以使用下面的命令来查看

 openclaw status 

会看到如下图的结果就说明服务启动了

🦞 OpenClaw 2026.2.6-3 (85ed6c7) — I read logs so you can keep pretending you don't have to. │ ◇ │ ◇ OpenClaw status Overview ┌─────────────────┬─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │ Item │ Value │ ├─────────────────┼─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ Dashboard │ http://127.0.0.1:18789/ │ │ OS │ linux 6.8.0-71-generic (x64) · node22.22.0 │ │ Tailscale │ off │ │ Channel │ stable (default) │ │ Update │ pnpm · npm latest 2026.2.6-3 │ │ Gateway │ local · ws://127.0.0.1:18789 (local loopback) · reachable 42ms · auth token · VM-16-7-ubuntu (10.0.16.7) app unknown linux 6.8.0-71-generic │ │ Gateway service │ systemd installed · enabled · running (pid 327748, state active) │ │ Node service │ systemd not installed │ │ Agents │ 1 · 1 bootstrapping · sessions 1 · default main active 1m ago │ │ Memory │ enabled (plugin memory-core) · unavailable │ │ Probes │ skipped (use --deep) │ │ Events │ none │ │ Heartbeat │ 30m (main) │ │ Sessions │ 1 active · default coder-model (128k ctx) · ~/.openclaw/agents/main/sessions/sessions.json │ └─────────────────┴─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ 

访问 OpenClaw Web UI 管理面板

如何访问面板？服务监听在 http://127.0.0.1:18789/ 端口上，我们现在通过 ssh 隧道来访问，输入下面的命令

ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP # 回车之后 用户名@服务器IP's password: # 输入密码

然后在浏览器打开 http://127.0.0.1:18789/, 你会看到 Dashboard 了，如下图

图中显示的是未授权状态，回到服务器，输入以下命令

clawdbot dashboard 

会看到下面的面板数据，有这个 Dashboard URL

openclaw dashboard 🦞 OpenClaw 2026.2.6-3 (85ed6c7) — Works on Android. Crazy concept, we know. Dashboard URL: http://127.0.0.1:18789/#token=e8e5cd1573123ae9b11111111111111e2b94b8b7b4ccd Copy to clipboard unavailable. No GUI detected. Open from your computer: ssh -N -L 18789:127.0.0.1:18789 ubuntu@222222 Then open: http://localhost:18789/ http://localhost:18789/#token=e8e5cd1573123ae9b11111111111111e2b94b8b7b4ccd Docs: https://docs.openclaw.ai/gateway/remote https://docs.openclaw.ai/web/control-ui 

复制对应的 Dashboard URL 到浏览器打开，即可正常查看聊天记录。

至此 OpenClaw 开源 AI 助手已安装完成，可以正常访问了。接下来在聊天框首次输入 Hello，OpenClaw 会询问你它应该叫什么、应该叫你什么。你需要给这个 AI 助手设置一个名字，以及它对你的称呼。可以在聊天框这么输入

Name: OpenClaw My Name: Boss 

OpenClaw 对接飞书机器人教程

下面是本篇 OpenClaw 飞书教程的核心部分。回到刚才添加 channels 的配置，选择飞书添加。如有遗漏，可以看官方文档OpenClaw 飞书对接

◆ Select a channel │ ○ Telegram (Bot API) │ ○ WhatsApp (QR link) │ ○ Discord (Bot API) │ ○ Google Chat (Chat API) │ ○ Slack (Socket Mode) │ ○ Signal (signal-cli) │ ○ iMessage (imsg) │ ○ Feishu/Lark (飞书) │ ○ Nostr (NIP-04 DMs) │ ○ Microsoft Teams (Bot Framework) │ ○ Mattermost (plugin) │ ○ Nextcloud Talk (self-hosted) │ ○ Matrix (plugin) │ ○ BlueBubbles (macOS app) │ ○ LINE (Messaging API) │ ○ Zalo (Bot API) │ ○ Zalo (Personal Account) │ ○ Tlon (Urbit) │ ● Finished └ 

选择之后会安装对应的扩展，回车就行了

◆ Install Feishu plugin? │ ● Download from npm(@openclaw/feishu) │ ○ Skip for now └ 

如果出现下面的错误，一般都是由于你之前安装过了，需要删除扩展

[plugins] feishu failed to load from /home/ubuntu/.openclaw/extensions/feishu/index.ts: Error: Cannot find module 'zod' Require stack: - /home/ubuntu/.openclaw/extensions/feishu/src/config-schema.ts 

先退出安装飞书，先安装 zod，输入

npminstall -g zod # 删除飞书扩展，一般都是由于你之前安装过了rm -rf ~/.openclaw/extensions/feishu 

如果没有错误的话，选择飞书通道之后，应该是下面的输出

 Select a channel │ Feishu/Lark (飞书) │ ◇ Feishu credentials ──────────────────────────────────────────────────────────────╮ │ │ │ 1) Go to Feishu Open Platform (open.feishu.cn) │ │ 2) Create a self-built app │ │ 3) Get App ID and App Secret from Credentials page │ │ 4) Enable required permissions: im:message, im:chat, contact:user.base:readonly │ │ 5) Publish the app or add it to a test group │ │ Tip: you can also set FEISHU_APP_ID / FEISHU_APP_SECRET env vars. │ │ Docs: feishu │ │ │ ├───────────────────────────────────────────────────────────────────────────────────╯ │ ◆ Enter Feishu App ID │ _ # 输入 App ID └ 

先不着急输出，我们先登录飞书开放平台 https://open.feishu.cn，点击「开发者后台 -> 创建企业自建应用」，如下图

然后点击创建应用，如下

创建完成后，首先到凭据管理中获取 App ID 和 App Secret，注意保存，后续配置需要使用。

然后添加机器人，如下操作

首先配置个名字

配置 OpenClaw 飞书参数

拿到 App ID 和 App Secret 之后，在刚才的上面的输入填入 APP ID 和 App Secret，最后

◇ Enter Feishu App ID │ cli_a9xxxxxxxf85cb2 # 填入你自己的 App ID │ ◇ Enter Feishu App Secret │ WmO1Hj1qkxxxxxxxxxxxihYL5NxXyTDt # 填入你自己的 App Secret[info]: ['client ready'] │ ◇ Feishu connection test ───────────────────────────╮ │ │ │ Connected as ou_3ef555cb1axxxxxxxxeb6203805ba9ee │ │ │ ├────────────────────────────────────────────────────╯ │ ◆ Which Feishu domain? │ ● Feishu (feishu.cn) - China # 选择国内 │ ○ Lark (larksuite.com) - International ◆ Group chat policy │ ○ Allowlist - only respond in specific groups# 允许列表 需要配置 │ ● Open - respond in all groups(requires mention)# 这里全部放开就行了 │ ○ Disabled - don't respond ingroups ◆ Select a channel │ ○ Telegram (Bot API) │ ○ WhatsApp (QR link) │ ○ Discord (Bot API) │ ○ Google Chat (Chat API) │ ○ Slack (Socket Mode) │ ○ Signal (signal-cli) │ ○ iMessage (imsg) │ ○ Feishu/Lark (飞书) │ ○ Nostr (NIP-04 DMs) │ ○ Microsoft Teams (Bot Framework) │ ○ Mattermost (plugin) │ ○ Nextcloud Talk (self-hosted) │ ○ Matrix (plugin) │ ○ BlueBubbles (macOS app) │ ○ LINE (Messaging API) │ ○ Zalo (Bot API) │ ○ Zalo (Personal Account) │ ○ Tlon (Urbit) │ ● Finished (Done)# 选择完成

完成之后会继续让你选择访问策略

◇ Configure DM access policies now? (default: pairing)# │ Yes │ ◇ Feishu DM access ─────────────────────────────────────────────────────────────────────────╮ │ │ │ Default: pairing (unknown DMs get a pairing code). │ │ Approve: openclaw pairing approve feishu <code> │ │ Allowlist DMs: channels.feishu.dmPolicy="allowlist" + channels.feishu.allowFrom entries. │ │ Public DMs: channels.feishu.dmPolicy="open" + channels.feishu.allowFrom includes "*". │ │ Multi-user DMs: set session.dmScope="per-channel-peer"(or "per-account-channel-peer" │ │ for multi-account channels) to isolate sessions. │ │ Docs: start/pairing │ │ │ ├────────────────────────────────────────────────────────────────────────────────────────────╯ │ ◇ Feishu DM policy │ Open (public inbound DMs)# 公开 │ ◇ Add display names for these accounts? (optional) │ No # 不需要 │ └ Channels updated. 

你可以通过 ~/.openclaw/openclaw.json 查看对应的 channel 配置，最后配置如下

{"channels":{"feishu":{"enabled":true,"appId":"xxxxxxxxxxxxxxxxxxxxxxxxxxx","appSecret":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","domain":"feishu","groupPolicy":"open","dmPolicy":"open","allowFrom":["*"]}}}

配置完成之后，重启

openclaw gateway restart 

重启完成后回到飞书，找到「事件和回调」，选择长连接模式，如下图

如果配置成功，说明连接已建立。继续下面的配置，添加事件，选择「接收消息」事件

事件添加完成之后，还需要开通权限，有以下权限全部勾选

如下图

以上步骤全部完成后，即可与机器人对话。但在此之前需要先创建一个版本

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

发布完成后，回到飞书客户端，可以看到应用已上线，点击打开应用

向机器人发送 Hello，即可收到 Moltbot 的回复

OpenClaw 常用命令速查

安装完成后，以下是日常使用中最常用的 OpenClaw 命令：

OpenClaw 成本说明与免费模型推荐

OpenClaw 本身完全免费开源，主要成本来自两个方面：

服务器成本：一台最低配置的云服务器即可，月费约 30-50 元。如果使用 阿里云 OpenClaw 一键部署，可以省去环境配置的时间。

AI 模型 API 调用费用：各模型服务商的免费额度和计费模式不同，以下是常见选择：

对于刚接触 OpenClaw 的用户，建议先用通义千问的免费额度体验，熟练后再根据实际需求选择其他模型。

总结

本篇 OpenClaw 安装教程从环境准备、OpenClaw 部署、飞书机器人对接到权限配置，完整走完了一个最新版 OpenClaw 开源 AI 助手的搭建流程。如果你按照这篇 OpenClaw 飞书教程完成了所有步骤，现在应该已经可以在飞书中和你的 OpenClaw 助手正常对话了。

OpenClaw 常见问题 FAQ

OpenClaw 和 Clawdbot、Moltbot 是什么关系？

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

OpenClaw 支持哪些 AI 模型？

OpenClaw 支持多种 AI 模型服务商，包括 Anthropic Claude、OpenAI GPT、通义千问（Qwen）、KIMI、小米 MiMo 等。本教程使用通义千问是因为其免费额度充足，适合入门学习。

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

这通常是服务器内存不足导致的。新版本脚本对内存要求较高，2G 内存可能会出现 OOM（内存溢出）。建议配置 swap 交换空间，将硬盘空间作为虚拟内存使用。

OpenClaw 可以在 Windows 或 macOS 上运行吗？

可以。OpenClaw 支持 Mac、Windows 和 Linux 系统。本教程以 Linux 为例，其他系统的安装方式可参考官方文档。

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

请检查以下几点：

1. 确认飞书通道已正确安装（新版 OpenClaw 已内置飞书支持，安装时选择 Feishu/Lark 即可）
2. 检查 App ID 和 App Secret 配置是否正确
3. 确认已开通「接收消息」事件权限
4. 检查长连接模式是否配置成功
5. 确保应用版本已发布
6. 使用 openclaw gateway restart 重启服务后再试

OpenClaw 数据安全吗？

OpenClaw 运行在你自己的服务器上，所有数据都在本地存储，不会上传到第三方云端。但由于它具有系统级权限，建议在独立的服务器上部署，避免在生产环境或重要数据的机器上运行。

除了飞书，OpenClaw 还支持哪些平台？

OpenClaw 支持多个聊天平台，包括 WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Twitch 等。每个平台需要安装对应的插件。

OpenClaw 可以做什么？

OpenClaw 不只是一个聊天机器人，它能真正在你的服务器上执行操作。以下是一些典型使用场景：

• 文件整理：“帮我把上周下载的文件按类型分类”，它会直接操作文件系统完成分类
• 网页摘要：发一个 URL 给它，它能自动打开网页、提取内容并生成摘要
• 代码编写：“写一个 Python 脚本批量重命名文件”，它能写完代码还能直接在服务器上运行
• 数据查询：连接本地数据库查询数据，并把结果发回飞书
• 日程管理：定时提醒、晴间简报、邮件自动回复
• 系统运维：执行 Shell 命令、监控服务器状态、自动化脚本

简单说，OpenClaw 是一个 7×24 小时在线的 AI 助手，你睡觉时它还能继续干活。

如何更新 OpenClaw 到最新版本？

使用以下命令更新：

openclaw update 

OpenClaw 命令和 clawdbot 命令有什么区别？

OpenClaw 更名后，官方推荐使用 openclaw 命令，但为了兼容性，clawdbot 命令仍然可用。两者功能完全相同，建议新用户直接使用 openclaw 命令。

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

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

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

OpenClaw 安装卡住不动怎么办？

1. 按 Ctrl + C 中断当前操作
2. 执行 openclaw doctor 检查问题
3. 如提示网络问题，检查服务器网络是否能访问 GitHub 和 npm
4. 尝试重新运行 openclaw onboard

端口 18789 被占用怎么办？

使用其他端口启动服务：

openclaw gateway --port 18790

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

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

# 创建 2G 的 swap 文件sudo fallocate -l 2G /swapfile sudochmod600 /swapfile sudomkswap /swapfile sudoswapon /swapfile # 设置开机自动启用echo'/swapfile none swap sw 0 0'|sudotee -a /etc/fstab