红豆稀饭
0%

🚀 云服务器部署 OpenClaw + MiniMax + 飞书，打造 24 小时智能笔记助手

发表于 分类于 阅读次数：

📌 关联阅读：Obsidian 配置步骤：免费笔记同步解决方案，支持手机和 PC 端无缝同步

📌 官方文档：OpenClaw 飞书插件使用指南

一、痛点引入：为什么需要这个方案？

作为开发者，你是否遇到过这些场景：

  • 📝 突然想到一个好点子，手忙脚乱找笔记软件记录
  • 💻 写代码遇到 bug，想问 AI 但懒得切换窗口
  • 📊 每天忙完想复盘，却坚持不了写日报
  • 🔔 重要信息散落在各处，整理起来耗时耗力

本文能解决什么问题？

通过部署 OpenClaw（2026 年 GitHub 最火 AI Agent 框架），接入 MiniMax 大模型和飞书官方插件，你可以：

  1. 飞书发消息 = 记笔记，自动同步到 Obsidian
  2. 随时问代码问题，MiniMax coding plan 专业解答
  3. 7×24 小时待命，云服务器永不掉线
  4. 成本可控，29 元/月 套餐每 5 小时刷新额度，个人使用完全够用

🦞 飞书插件最新版本：2026.3.15 | 让你的飞书长出龙虾钳

二、方案架构一览

1
2
3
4
5
6
7
8
9
10
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 飞书 │────▶│ OpenClaw │────▶│ MiniMax │
│ (消息入口) │ │ (云服务器) │ │ (AI 能力) │
└─────────────┘ └──────┬──────┘ └─────────────┘
 │
 ▼
 ┌─────────────┐
 │ Gitee │
 │ (笔记存储) │
 └─────────────┘

核心组件说明：

组件 作用
OpenClaw AI Agent 框架，负责消息处理和任务执行
MiniMax 提供大模型能力，擅长代码和中文
飞书官方插件 用户交互入口，支持消息/文档/日历等
云服务器 7×24 小时运行服务
Gitee 笔记 Git 存储，支持版本管理

三、部署步骤（基于官方最新流程）

3.1 准备云服务器

推荐使用 Ubuntu 22.04 LTS，配置建议 2 核 2G 起步：

1
2
3
4
5
# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装基础工具
sudo apt install -y curl git vim wget

3.2 安装 Node.js 环境 ⭐

⚠️ 重要：OpenClaw 需要 Node.js 22+ 版本，请勿安装过低版本！

1
2
3
4
5
6
7
8
9
10
# 安装 Node.js 22.x LTS
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node -v # 应输出 v22.x.x
npm -v

# 安装 pnpm（比 npm 更快）
npm install -g pnpm

3.3 安装 OpenClaw 核心

1
2
3
4
5
# 一键安装 OpenClaw（Linux/MacOS）
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows 用户使用 PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后，打开浏览器访问 OpenClaw Dashboard URL，正常显示管理后台则代表安装成功。

3.4 配置 MiniMax API

💰 省钱技巧：推荐订阅 MiniMax Coding Plan，29 元/月 套餐每 5 小时自动刷新额度，对于个人开发者完全够用。

🎁 专属福利：通过邀请链接订阅可享 9 折优惠 + Builder 权益，邀请人还能拿返利和社区特权：
👉 https://platform.minimaxi.com/subscribe/coding-plan?code=J3Vrn6lW9x&source=link

获取 API Key 步骤：

  1. 访问 MiniMax 开放平台
  2. 注册/登录账号
  3. 进入「用户中心」→「接口密钥」
  4. 创建新密钥并复制保存

在 OpenClaw 管理后台配置 MiniMax 为默认模型。

3.5 安装飞书官方插件 ⭐

⚠️ 重要安全提示：

  • 该插件通过飞书接口连接了你的工作数据（消息、文档、日历、联系人）
  • 强烈建议先用个人账号体验，谨慎用于公司账号
  • AI 可能存在”幻觉”，重要操作请”先预览，再确认”
1
2
# 安装飞书官方插件
npx -y @larksuite/openclaw-lark-tools install

执行过程中可选择：

  • 新建机器人：扫码一键创建飞书机器人
  • 关联已有机器人：手动输入 App ID 和 App Secret

💡 如果 Windows 设备扫码失败，可能是终端分辨率问题，建议更换 Cmder 终端

3.6 飞书开放平台权限配置

登录 飞书开放平台，创建企业自建应用，配置以下权限：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
 "scopes": {
 "tenant": [
 "im:message:readonly",
 "im:message:send_as_bot",
 "docx:document:readonly",
 "docx:document:write_only",
 "calendar:calendar:read",
 "calendar:calendar.event:create",
 "base:record:create",
 "base:record:read",
 "base:record:update"
 ],
 "user": [
 "im:message.p2p_msg:get_as_user",
 "im:message.group_msg:get_as_user",
 "docs:document:read",
 "docs:document:write_only",
 "sheets:spreadsheet:read",
 "sheets:spreadsheet:write_only"
 ]
 }
}

关键权限说明：

权限 用途 是否必需
im:message:send_as_user 以用户身份发消息 部分企业不支持
im:message.group_msg 获取群组所有消息 敏感权限，需申请
docx:document 读写云文档 必需
calendar:calendar 日历管理 可选

3.7 验证安装

在飞书中向机器人发送以下命令：

1
2
3
/feishu start # 验证是否安装成功
/feishu auth # 批量完成用户授权
/feishu doctor # 检查配置是否正常

若 /feishu start 返回版本号信息，则代表安装成功。

四、高级配置

4.1 开启流式输出

1
2
3
4
5
6
7
8
# 开启流式输出（卡片回复更流畅）
openclaw config set channels.feishu.streaming true

# 开启耗时显示
openclaw config set channels.feishu.footer.elapsed true

# 开启状态展示
openclaw config set channels.feishu.footer.status true

4.2 配置回复模式

模式 1：只有 @机器人 才回复（推荐）

1
2
openclaw config set channels.feishu.requireMention true --json
sh /workspace/projects/scripts/restart.sh

模式 2：所有消息都回复（大群慎用）

1
2
openclaw config set channels.feishu.requireMention false --json
sh /workspace/projects/scripts/restart.sh

模式 3：特定群特殊规则

1
2
3
4
5
6
# 默认所有群都不需要 @
openclaw config set channels.feishu.requireMention open --json

# 特定群需要 @（替换为真实群 ID）
openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json
sh /workspace/projects/scripts/restart.sh

4.3 开启话题群独立上下文

1
2
3
4
5
# 开启每个话题独立上下文 + 多任务并行
openclaw config set channels.feishu.threadSession true

# 关闭
openclaw config set channels.feishu.threadSession false

4.4 配置 Obsidian 笔记存储

在 OpenClaw 管理后台配置技能插件：

1
2
3
4
5
6
7
skills:
 - id: file-writer
 enabled: true
 config:
 basePath: "/root/notes"
 autoCommit: true
 gitRemote: "git@gitee.com:username/notes.git"
1
2
3
4
5
6
7
8
9
10
11
# 创建笔记目录
mkdir -p /root/notes
cd /root/notes

# 初始化 Git 仓库
git init
git remote add origin git@gitee.com:username/notes.git

# 配置 SSH 密钥
ssh-keygen -t ed25519 -C "your_email@example.com"
cat ~/.ssh/id_ed25519.pub # 复制公钥添加到 Gitee

📚 详细教程：Obsidian 完整配置步骤（含手机 PC 无缝同步）见关联文章：
Obsidian 配置步骤：免费笔记同步解决方案

五、使用场景演示

场景 1：快速记录想法

1
2
3
4
5
6
7
你在飞书发送：
> 今天学习了 React useEffect，dependency array 决定副作用何时执行

OpenClaw 回复：
> ✅ 已保存到笔记 → 2026-03-17-React 学习.md
> 📁 路径：/notes/2026/03/2026-03-17-React 学习.md
> 🔄 已同步到 Gitee

场景 2：代码问题咨询

1
2
3
4
5
6
7
8
9
10
11
12
你在飞书发送：
> 帮我写一个 React useEffect 清理定时器的例子

OpenClaw 回复：
> ```jsx
> useEffect(() => {
> const timer = setInterval(() => {
> console.log('tick');
> }, 1000);
>
> return () => clearInterval(timer);
> }, []);

💡 注意：清理函数在组件卸载时执行，避免内存泄漏

1
2
3

### 场景 3：定时任务（对话创建）

你在飞书发送：

每天晚上 10 点提醒我写日报

OpenClaw 回复：

✅ 已创建定时任务「每日日报提醒」
⏰ 执行时间：每天 22:00
📍 任务 ID：task_daily_review_001
随时回复「删除日报提醒」可取消

1
2
3

### 场景 4：飞书文档联动

你在飞书发送：

把刚才的代码示例保存到飞书文档「React 学习笔记」

OpenClaw 回复：

✅ 已创建飞书云文档
📄 文档链接：https://xxxx.feishu.cn/docx/xxxxx
📝 内容已写入，支持后续协作编辑

1
2
3

### 场景 5：多维表格管理

你在飞书发送：

创建一个任务追踪表格，包含任务名、负责人、截止日期

OpenClaw 回复：

✅ 已创建多维表格「任务追踪」
📊 表格链接：https://xxxx.feishu.cn/base/xxxxx
📋 已添加字段：任务名、负责人、截止日期

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

---

## 六、常见问题排查

### Q1：插件安装失败？

```bash
# 查看版本信息
npx @larksuite/openclaw-lark-tools info

# 查看详细配置
npx @larksuite/openclaw-lark-tools info --all

# 自动诊断并修复
npx @larksuite/openclaw-lark-tools doctor --fix

Q2：报 cannot find module xxx？

1
2
3
4
5
# 进入插件安装目录
cd ~/.openclaw/plugins/feishu

# 重新安装依赖
npm install

Q3：权限不足？

  1. 登录飞书开放平台 → 权限管理
  2. 点击「批量导入/导出权限」
  3. 复制官方权限配置 JSON 导入
  4. 点击「申请开通」

Q4：飞书机器人收不到消息？

1
2
3
4
5
6
7
8
# 检查服务状态
openclaw status

# 查看日志
openclaw logs

# 验证配置
/feishu doctor

排查清单：

  • App ID/Secret 是否正确
  • 应用是否已添加到个人飞书/群聊
  • 事件订阅 URL 是否可公网访问
  • 服务器防火墙是否开放对应端口

Q5：Node.js 版本不兼容？

1
2
3
4
5
6
# 检查当前版本
node -v # 必须 22.x+

# 如果低于 22.x，需要升级
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

Q6：Coze 上安装失败？

1
2
3
4
5
# 切换 npm 镜像源
export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com

# 重新安装
npx -y @larksuite/openclaw-lark-tools install

七、总结与建议

✅ 这套方案适合谁？

  • 经常用飞书沟通的开发者/团队
  • 有 Obsidian 笔记习惯的知识工作者
  • 想要 24 小时 AI 助手但不想依赖云端服务
  • 注重数据隐私，希望自建服务

⚠️ 注意事项

  1. Node.js 版本：必须 22+，否则可能运行失败
  2. 插件状态：飞书官方插件处于快速迭代阶段，请谨慎用于生产环境
  3. 账号安全：强烈建议用个人飞书账号体验，不建议用公司账号
  4. 权限限制：代用户身份发消息需额外开通权限，部分企业（如字节）不支持
  5. AI 幻觉：重要操作请”先预览，再确认”，切勿完全自动驾驶
  6. 数据备份：笔记仓库定期备份，避免丢失

🚀 进阶优化方向

  • 接入更多模型（Claude、GPT-4 等）做对比
  • 添加 RAG 知识库，让 AI 更懂你的笔记
  • 集成更多工具（日历、邮件、智能家居）
  • 配置多机器人对应不同 Agent
  • 搭建 Web 管理后台，可视化配置

参考资料：

如果本文对你有帮助，欢迎点赞收藏 👍 有问题评论区交流！

🎁 MiniMax 专属福利：通过邀请链接订阅 Coding Plan 享 9 折优惠 + Builder 权益
👉 立即参与