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

安装 OpenClaw 开源 AI 助手

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

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

其他平台安装方式请参考 OpenClaw 安装文档

你会看到如下输出：

 🦞 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 

如果首次安装，时间会很长，需要耐心等待。

如果最后输出如下内容：

→ npm install 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，输入：

npm install -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 元。

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
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# 设置开机自动启用
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab