Shell / BashNode.jsAI
OpenClaw 本地 AI 助手部署与飞书对接指南
介绍在 Linux 系统下手动部署开源本地 AI 助手 OpenClaw 并对接飞书机器人的完整流程。涵盖环境准备（Node.js、Git）、依赖安装、模型配置（通义千问）、飞书应用创建及权限设置。通过 TUI 或 Web UI 管理机器人，实现消息收发与指令执行。支持多平台扩展，注重数据隐私与本地化运行。
介绍在 Linux 系统下手动部署开源本地 AI 助手 OpenClaw 并对接飞书机器人的完整流程。涵盖环境准备（Node.js、Git）、依赖安装、模型配置（通义千问）、飞书应用创建及权限设置。通过 TUI 或 Web UI 管理机器人，实现消息收发与指令执行。支持多平台扩展，注重数据隐私与本地化运行。
OpenClaw（原名 Clawdbot，后更名为 Moltbot，现正式命名为 OpenClaw）是一款开源的本地 AI 智能体。它运行在你的服务器或电脑上，数据完全自主可控。支持飞书、WhatsApp、Telegram、Discord、Slack 等主流聊天工具交互。与云端 SaaS 服务不同，OpenClaw 让你完全掌控数据隐私，可以执行系统命令、浏览网页、管理文件，甚至编写代码。
注意：本教程在 Linux 系统下进行
安装 OpenClaw 需要满足以下环境要求：
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux（推荐）/ macOS / Windows (WSL2) |
| Node.js | ≥ 22.x |
| 内存 | ≥ 2GB（建议 4GB，否则需配置 swap） |
| 网络 | 能访问 GitHub、npm 仓库（国内服务器可能需要代理） |
| AI 模型 | 通义千问、OpenAI、Claude、KIMI 等任一 API Key（千问免费额度充足） |
# 安装 Git
sudo apt update
sudo apt install git -y
# 安装 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 install 22
# 查看 nodejs 版本
node -v # 输出 v22 即可，版本只要 22 就行
# 使用官方脚本安装
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.
Starting setup...
🦞 OpenClaw 2026.2.6-3 (85ed6c7) — curlfor conversations.
┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ ◇ 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 │ │ ├───────────────────────────────────────────────────────────────────────────────────────╯ │ ◆ 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 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 │
service systemd installed · enabled · running (pid , state active)
service systemd not installed
· bootstrapping · sessions · main active 1m ago
enabled (plugin memorycore) · unavailable
skipped (use deep)
none
30m (main)
active · codermodel (128k ctx) · .openclawmainsessions.json
如何访问面板？服务监听在 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 了，如下图：
图中显示的是未授权状态，回到服务器，输入以下命令：
openclaw 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 飞书教程的核心部分。回到刚才添加 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，注意保存，后续配置需要使用。
然后添加机器人，如下操作：
首先配置个名字：
拿到 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
重启完成后回到飞书，找到「事件和回调」，选择长连接模式，如下图：
如果配置成功，说明连接已建立。继续下面的配置，添加事件，选择「接收消息」事件：
事件添加完成之后，还需要开通权限，有以下权限全部勾选：
| 权限 | Scope（范围） | Description（说明） |
|---|---|---|
| contact:user.base:readonly | 用户信息 | 获取基础用户信息 |
| im:message | 消息 全部勾选 | 发送和接收消息 |
如下图：
以上步骤全部完成后，即可与机器人对话。但在此之前需要先创建一个版本：
注意：每次修改配置后都需要重新发布版本，建议全部配置完成后再统一发布。
发布完成后，回到飞书客户端，可以看到应用已上线，点击打开应用：
向机器人发送 Hello，即可收到 Moltbot 的回复：
安装完成后，以下是日常使用中最常用的 OpenClaw 命令：
| 命令 | 功能 |
|---|---|
openclaw status | 查看 OpenClaw 运行状态 |
openclaw onboard | 重新进入配置向导 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw gateway restart | 重启服务 |
openclaw update | 更新到最新版本 |
openclaw health | 健康检查 |
openclaw doctor | 诊断问题 |
openclaw dashboard | 获取 Web UI 访问链接 |
openclaw security audit --deep | 安全审计 |
openclaw uninstall | 卸载 OpenClaw |
OpenClaw 本身完全免费开源，主要成本来自两个方面：
服务器成本：一台最低配置的云服务器即可，月费约 30-50 元。
AI 模型 API 调用费用：各模型服务商的免费额度和计费模式不同，以下是常见选择：
| 模型服务商 | 免费额度 | 适合场景 |
|---|---|---|
| 通义千问（Qwen） | 免费额度充足 | 本教程推荐，入门首选 |
| 小米 MiMo | 有免费试用额度 | 成本敏感用户 |
| KIMI (Moonshot) | 有免费额度 | 中文理解能力强 |
| GLM 4.7 (Z.AI) | 有免费额度 | 性价比高 |
| OpenAI GPT | 付费 | 英文场景最佳 |
| Anthropic Claude | 付费 | 代码能力最强 |
对于刚接触 OpenClaw 的用户，建议先用通义千问的免费额度体验，熟练后再根据实际需求选择其他模型。
本篇 OpenClaw 安装教程从环境准备、OpenClaw 部署、飞书机器人对接到权限配置，完整走完了一个最新版 OpenClaw 开源 AI 助手的搭建流程。如果你按照这篇 OpenClaw 飞书教程完成了所有步骤，现在应该已经可以在飞书中和你的 OpenClaw 助手正常对话了。
OpenClaw 是该项目的最新正式名称。项目最初叫 Clawdbot，后因商标问题更名为 Moltbot，最终在 2025 年 1 月正式定名为 OpenClaw。三者是同一个项目的不同阶段命名。
OpenClaw 支持多种 AI 模型服务商，包括 Anthropic Claude、OpenAI GPT、通义千问（Qwen）、KIMI、小米 MiMo 等。本教程使用通义千问是因为其免费额度充足，适合入门学习。
这通常是服务器内存不足导致的。新版本脚本对内存要求较高，2G 内存可能会出现 OOM（内存溢出）。建议配置 swap 交换空间，将硬盘空间作为虚拟内存使用。
可以。OpenClaw 支持 Mac、Windows 和 Linux 系统。本教程以 Linux 为例，其他系统的安装方式可参考 官方文档。
请检查以下几点：
openclaw gateway restart 重启服务后再试OpenClaw 运行在你自己的服务器上，所有数据都在本地存储，不会上传到第三方云端。但由于它具有系统级权限，建议在独立的服务器上部署，避免在生产环境或重要数据的机器上运行。
OpenClaw 支持多个聊天平台，包括 WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Twitch 等。每个平台需要安装对应的插件。
OpenClaw 不只是一个聊天机器人，它能真正在你的服务器上执行操作。以下是一些典型使用场景：
简单说，OpenClaw 是一个 7×24 小时在线的 AI 助手，你睡觉时它还能继续干活。
使用以下命令更新：
openclaw update
OpenClaw 更名后，官方推荐使用 openclaw 命令，但为了兼容性，clawdbot 命令仍然可用。两者功能完全相同，建议新用户直接使用 openclaw 命令。
这通常是环境变量未加载导致的。尝试以下步骤：
source ~/.bashrc 重新加载环境变量openclaw doctor 检查问题Ctrl + C 中断当前操作openclaw doctor 检查问题openclaw onboard使用其他端口启动服务：
openclaw gateway --port 18790
如果服务器内存不足 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
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online