memU Bot 快速安装 + 飞书接入保姆级教程（Windows/macOS 通用）

memU Bot 是一个基于memU（专为大模型与智能体打造的开源记忆框架）构建的主动式AI智能体助手，是OpenClaw（Moltbot、Clawdbot）的优质替代方案，可以7×24小时全天候自动执行任务。

memU Bot

基于memU记忆框架打造的AI智能体助手，7×24小时全天候主动式执行任务

下面是一份完整、可直接照做的 memU Bot 安装+飞书接入步骤，全程约 10 分钟，无需代码基础。

一、准备工作（必做）

1. 一台 Windows 10/11（64 位）或 macOS 电脑，建议 SSD、内存 ≥ 8GB。
2. 一个可用的大模型 API Key（推荐国内模型，速度快、稳定）：
3. • MiniMax、智谱 GLM-4、Kimi、通义千问、Anthropic Claude 均可。
   • 去对应平台官网注册 → 进入「API 密钥」→ 创建并复制保存 Key。
4. 3、一个飞书账号（个人 / 企业均可），用于创建机器人应用。

二、memU Bot 客户端安装（3 分钟）

三、配置大模型 API（核心，2 分钟）

1. 1、打开 memU Bot → 进入左侧「设置」→ 顶部「通用 / 模型」。
2. 2、选择你的模型厂商：
   • 内置支持：Anthropic、MiniMax
   • 自定义：选择「Custom Provider」，填入 GLM-4、Kimi 等的 API 地址与 Key。
3. 3、填写API和模型配置信息：
   • API Key（粘贴你提前复制的密钥）
   • 模型名称（如 glm-4、kimi-latest、claude-3-5-sonnet）
   • 点击「测试连接」，显示「连接成功」即可。
4. 4、保存设置，memU Bot 会自动用该模型作为 “大脑”。

四、飞书接入完整配置（5 分钟，关键步骤）

步骤 1：在飞书开放平台创建自建应用

1. 浏览器打开飞书开放平台：https://open.feishu.cn/app，用你的飞书账号登录。
2. 点击「创建应用」→ 选择「企业自建应用」（个人也可创建，仅自己可见）。
3. 填写应用信息：
4. • 应用名称：memU Bot 助手（自定义）
   • 应用描述：7×24 主动 AI 助手
   • 图标：上传任意图标
5. 创建完成，进入应用详情页，复制保存 2 个关键信息：
6. • App ID
   • App Secret
     （后面步骤5-2要填到 memU Bot 里）

步骤 2：配置飞书应用权限（必须开全，否则无法收发消息）

1. 左侧菜单进入「权限管理」→「权限配置」。
2. 搜索并开通以下权限（批量添加）：
3. • im:message（发送与接收消息，全部勾选）
   • contact:user.base:readonly（获取用户基础信息）
   • im:chat:readonly（获取会话信息）
4. 点击「申请权限」→ 提交（个人应用一般秒通过）。

步骤 3：配置事件与回调（长连接模式）

1. 左侧进入「事件与回调」→「事件配置」。
2. 勾选：
   • 接收消息事件（im.message.receive_v1）
   • 选择「使用长连接接收事件」
3. 回调配置同样选择「长连接」，保存设置。

步骤 4：发布飞书应用版本

1. 左侧进入「应用发布」→「创建版本」。
2. 填写版本号（如 1.0.0）、更新说明（如 “初始版本”）。
3. 提交发布，等待审核（个人应用一般 1–5 分钟通过）。
4. 审核通过后，在飞书客户端「工作台」就能看到你的 memU Bot 应用。

步骤 5：在 memU Bot 中绑定飞书

1. 回到 memU Bot → 左侧「设置」→ 找到「平台 / 飞书」。
2. 填入飞书创建的应用信息（见上面步骤1-5）：
   • App ID（从飞书开放平台复制）
   • App Secret（从飞书开放平台复制）
3. 点击「连接飞书」，显示「连接成功」即完成绑定。

五、测试与使用（1 分钟）

1. 打开飞书，进入「工作台」，找到你创建的「memU Bot 助手」。
2. 发送测试消息，例如：
   • 你好
   • 帮我总结今天的待办
3. 若 memU Bot 正常回复，说明安装 + 飞书接入完全成功。

六、常见问题与避坑

1. 飞书收不到回复
   • 检查权限是否全开，尤其是 im:message 全部权限。
   • 确认事件配置为「长连接」，并已发布版本。
   • 重启 memU Bot，重新连接飞书。
2. 模型连接失败
   • 核对 API Key 是否正确，有无多余空格。
   • 国内模型建议检查网络是否正常，无需代理。
3. memU Bot 后台退出
   • Windows：设置开机自启，关闭杀毒软件拦截。
   • MacOS：在「系统设置→通用→登录项」中添加 memU Bot。

memU Bot

基于memU记忆框架打造的AI智能体助手，7×24小时全天候主动式执行任务

七、安装后404报错如何解决

按照流程配置了之后，一直报：

<code>Error: 404 {“error”:{“message”:”Not Found”,”type”:”not_found”,”code”:404}}</code>

这个 404 Not Found 是 memU Bot 调用飞书 API 时找不到对应应用 / 接口，核心是飞书应用没正确发版、长连接 / 事件配置错、AppID/AppSecret 填错、权限没开全这四类问题，按下面顺序一步步排查可以按下面顺序一步步排查：

0️⃣ 先定位：404 到底是什么意思

这个错误是飞书返回：找不到你这个应用（AppID 无效 / 未发布）、或请求的接口 / 事件不存在Feishu。
不是网络、模型、memU 安装问题，只和飞书开放平台配置 + memU 飞书参数绑定有关。

1️⃣ 第一步：核对 AppID / AppSecret（最常见）

1. 打开飞书开放平台 → 你的 memU 应用 → 首页，重新复制 AppID、AppSecret（不要手动输入，容易多空格 / 换行）
2. 回到 memU Bot → 设置 → 飞书：
   • 清空原有内容，纯粘贴（不要加任何空格、引号、换行）
   • 确认：AppID 以 cli_ 开头，AppSecret 是一串随机字符
3. 点击「断开飞书」→ 重启 memU Bot → 重新「连接飞书」

2️⃣ 第二步：飞书应用必须完成「发布版本」（90% 人漏这步）

1. 没发版的应用，飞书开放平台会直接返回 404，必须做这 3 步：
2. 飞书开放平台 → 你的应用 → 左侧「应用发布」→「创建版本」
   • 版本号：填 1.0.0
   • 更新说明：随便写（如「memU Bot 接入」）
   • 点击「提交」
3. 等待审核：个人自建应用一般 1–5 分钟秒过，企业应用可能需要管理员审批
4. 审核通过后：必须点「发布到工作台」，让应用上线（只创建版本、不发布，依然 404）
5. 发版后，重启 memU Bot，重新连接飞书

3️⃣ 第三步：事件与回调必须是「长连接」（绝对不能选 Webhook）

这是 memU 接入飞书的硬性要求，选错必 404：

1. 飞书开放平台 → 应用 → 左侧「事件与回调」→「事件配置」
2. 必须勾选：使用长连接接收事件（绝对不要选「HTTP 回调 / Webhook」）
3. 必须添加事件：im.message.receive_v1（接收消息，必选，少这个就 404）
4. 回调配置：同样选「长连接」，不要填任何 URL、Token、Encrypt Key（长连接不需要这些）
5. 保存 → 重新发布版本（改事件后必须重发版）

4️⃣ 第四步：权限必须开全（少一个就 404 / 无响应）

1. 飞书开放平台 → 应用 → 左侧「权限管理」→「权限配置」
2. 搜索并全部开通以下权限（缺一不可）：
   • im:message（发送与接收消息，所有子权限全勾）
   • contact:user.base:readonly（获取用户基础信息）
   • im:chat:readonly（获取会话信息）
3. 点击「申请权限」→ 提交（个人应用秒过）
4. 权限开通后，必须重新发布版本

5️⃣ 第五步：memU 飞书设置 + 重启（收尾）

1. memU Bot → 设置 → 飞书：
   • 确认：只填 AppID、AppSecret，其他所有字段（URL、Token、Encrypt Key）全部留空（长连接不需要）
2. 完全退出 memU Bot（任务栏右键退出，不要只关窗口）
3. 重新打开 memU → 连接飞书 → 看是否提示「连接成功」
4. 测试：飞书工作台找到 memU 机器人，发消息，看是否回复

6️⃣ 终极排查清单（按顺序做，必好）

1. ✅ AppID/AppSecret 纯粘贴、无空格、正确
2. ✅ 飞书应用已「创建版本 + 发布到工作台」（审核通过）
3. ✅ 事件配置：长连接 + 仅勾选 im.message.receive_v1
4. ✅ 回调：长连接、不填任何 URL/Token
5. ✅ 3 个核心权限全部开通、已重发版
6. ✅ memU 重启、重新连接飞书

7️⃣ 如果还是 404

1. 删掉飞书开放平台里的旧应用，重新创建一个全新自建应用，严格按上面流程走（避免旧配置残留）
2. 确认飞书账号是个人 / 企业主账号，不是子账号 / 子应用
3. 关闭电脑代理 / VPN，memU 直接走本地网络