最近,开源 AI 助手 OpenClaw(小龙虾) 冲上热搜,连公务员群体都在讨论"养龙虾"。
今天这篇教程不走寻常路——用国产大模型 MiniMax M2.5 当 AI 大脑,接入飞书,
打造一个真正属于你自己的、跑在本地的 AI 工作助手。
全程保姆级操作,零基础也能跟着做!
🤔 先搞清楚:这三个东西分别是什么?
OpenClaw(小龙虾):开源 AI 助手框架,是"壳",负责把 AI 大脑和你的聊天软件连接起来。数据跑在你自己电脑上,不泄露隐私。
MiniMax M2.5:国内 AI 公司 MiniMax 推出的大模型,代码能力比肩 Claude Opus,但价格只有它的约十分之一,非常适合高频使用。
飞书:字节跳动旗下的企业协作平台,OpenClaw 原生支持飞书机器人接入,上班族用起来天然顺手。
三者组合起来就是:用飞书发消息 → OpenClaw 转发 → MiniMax M2.5 处理 → 回复到飞书,全程不到 1 秒。
📋 开始前,对照清单检查一下
✅ 必须有的:
- 一台电脑(Mac、Windows、Linux 均可)
- 正常上网
- 一个飞书账号(个人版免费注册:https://www.feishu.cn)
- 一个 MiniMax 账号(免费注册:https://platform.minimax.com)
✅ Windows 用户额外需要:
- 安装 WSL2(下面会手把手教)
💡 为什么选 MiniMax M2.5?
国内可直连、无需翻墙、注册即有免费额度,日常使用费用极低(每百万 token 约 2 元),
且官方已与 OpenClaw 深度适配,配置比其他模型更简单。
🪟 第零步(Windows 用户专属):装 WSL2
Mac 和 Linux 用户跳过这一步,直接看第一步 👇
WSL2 让 Windows 也能跑 Linux 程序,非常必要:
第一步:以管理员身份打开 PowerShell
开始菜单搜索"PowerShell"→ 右键 → 以管理员身份运行
第二步:输入以下命令并回车:
wsl --install第三步:等待安装完成,重启电脑
第四步:重启后会弹出黑色窗口,按提示设置一个用户名和密码(随便起,记住就行)
✅ WSL2 装好!后续所有命令都在这个黑窗口里操作。
📦 第一步:安装 Node.js 22
Node.js 是 OpenClaw 的运行环境,必须是 22 或更高版本。
Mac 用户
打开"终端"(启动台搜索"终端"),依次运行:
# 安装 Homebrew(没有的话先装,有的话跳过)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js 22
brew install node@22Windows(WSL2)/ Linux 用户
在 WSL2 终端里运行:
# 安装 nvm(Node 版本管理工具)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载配置
source ~/.bashrc
# 安装并启用 Node 22
nvm install 22
nvm use 22验证是否成功
node --version看到 v22.x.x 就成功了 🎉
🦞 第二步:安装 OpenClaw
一行命令搞定:
npm install -g openclaw@latest等待 1-3 分钟下载完成后,验证:
openclaw --version出现版本号即安装成功。
🧠 第三步:获取 MiniMax API Key
在运行向导之前,先去拿 MiniMax 的 API Key:
第一步:打开 https://platform.minimax.io,注册/登录
第二步:进入控制台 → 点击左侧 API Keys → 点 创建 API Key
第三步:给 Key 随便起个名字(如 "openclaw"),点确认
第四步:复制生成的 Key(格式类似 sk-xxxxxxxxxxxxxxxx),保存好,只显示一次!
🚀 第四步:运行新手引导向导
运行这一行命令,进入傻瓜式配置界面:
openclaw onboard --install-daemon向导会逐步问你几个问题,按照下面的选择操作:
① 是否开始引导? → 选 Yes
② 选择引导方式? → 选 QuickStart(快速配置)
③ 选择模型提供商? → 选 MiniMax
④ 选择认证方式? → 选 MiniMax API Key
⑤ 选择 API 区域? → 选 Global(国内用户也选这个)
💡 如果你在中国大陆网络下有连接问题,也可以选 CN(api.minimaxi.com)
⑥ 粘贴你的 API Key → 把第三步复制的 Key 粘贴进去,回车
⑦ 选择模型 → 默认会出现 MiniMax-M2.5,直接回车确认
⑧ 选择接入渠道? → 这里选 Feishu/Lark(飞书)(下一步专门讲)
💬 第五步:在飞书开放平台创建机器人
这一步要去飞书创建一个"自建应用"(机器人),流程如下:
5.1 创建飞书应用
第一步:打开飞书开放平台:https://open.feishu.cn/app
第二步:点右上角 创建企业自建应用
第三步:填写应用名称(比如"AI助手")、描述,上传个头像,点 确定
第四步:进入应用详情页 → 点左侧 凭证与基础信息
第五步:复制 App ID(格式:cli_xxx)和 App Secret,分别保存好
5.2 添加机器人能力
在应用详情页左侧 → 应用功能 → 机器人 → 点 开启
5.3 配置权限
左侧 → 权限管理 → 批量导入权限:
{
"scopes": {
"tenant": [
"im:message",
"im:message.p2p_msg:readonly",
"im:message.group_at_msg:readonly",
"im:message:send_as_bot",
"docx:document:readonly"
],
"user": [
"docx:document:readonly"
]
}
}5.4 开启事件订阅(长连接模式)
左侧 → 事件与回调 → 事件配置 → 选择 使用长连接接收事件
💡 长连接模式无需公网 IP,在家/公司内网都能用,是飞书接入 OpenClaw 最省事的方式。
订阅以下事件:
im.message.receive_v1(接收消息)
5.5 发布应用
左侧 → 版本管理与发布 → 创建版本 → 填写版本说明 → 申请线上发布
如果是个人测试,可以先点 创建测试版本,添加自己的飞书账号为测试用户,免去审核等待。
⚙️ 第六步:配置飞书渠道
注意:如果没有飞书这个渠道的话,请安装下面这个 @m1heng-clawd/feishu 插件,如果已经有了就不需要安装。
openclaw plugins install @m1heng-clawd/feishu回到终端,向导还在等你输入飞书信息:
◆ Enter Feishu App ID
▌ cli_你的AppID
◆ Enter Feishu App Secret
▌ 你的AppSecret粘贴刚才保存的 App ID 和 App Secret,回车继续。
向导完成后,配置文件会自动写好。你也可以手动检查配置(可选):
nano ~/.openclaw/openclaw.json正确的配置长这样:
{
"agents": {
"defaults": {
"model": {
"primary": "minimax/MiniMax-M2.5"
}
}
},
"models": {
"mode": "merge",
"providers": {
"minimax": {
"baseUrl": "https://api.minimax.io/anthropic",
"apiKey": "sk-你的APIKey",
"api": "anthropic-messages"
}
}
},
"channels": {
"feishu": {
"accounts": {
"main": {
"appId": "cli_你的AppID",
"appSecret": "你的AppSecret"
}
}
}
}
}▶️ 第七步:启动网关,开始使用!
openclaw gateway start看到类似下面的输出说明启动成功:
✓ Gateway running on ws://127.0.0.1:18789
✓ Feishu channel connected
✓ MiniMax M2.5 model ready现在打开飞书,找到你创建的机器人,给它发一条消息,它就会回复你了!🦞
如果你在群里,需要 @机器人 才会触发回复(这是飞书默认的安全机制)。
🔒 第八步:配置私信安全审批(推荐)
默认情况下,陌生人给你的机器人发私信,它会要求对方输入配对码(不会直接回复)。这是为了防止滥用。
如果有人发私信后收到了配对码,你需要在终端运行:
openclaw pairing approve feishu <配对码>这样对方就加入白名单了,以后可以直接聊。
如果你想让机器人对所有人开放私信,可以在配置里加:
"channels": {
"feishu": {
"dmPolicy": "open"
}
}🛠 常用命令速查
| 命令 | 作用 |
|---|---|
openclaw gateway | 启动 AI 网关 |
openclaw gateway restart | 重启网关 |
openclaw doctor | 检查配置是否有问题 |
openclaw logs --follow | 实时查看日志 |
openclaw update --channel stable | 更新到最新版本 |
在飞书里可以 @ 机器人发这些指令:
| 指令 | 效果 |
|---|---|
/new 或 /reset | 开始新对话,清空记忆 |
/status | 查看当前 token 用量 |
/think high | 开启深度推理模式(回答更慢但更准) |
/compact | 压缩对话历史,省 token |
/verbose on | 显示详细过程 |
❓ 常见问题 Q&A
Q:配置完了,飞书机器人不回消息怎么办?
A:按以下顺序排查:
- 运行
openclaw doctor,看有没有报错 - 检查飞书开放平台里事件订阅是否已选长连接模式
- 确认机器人能力("机器人"功能)已开启
- 确认三个权限(im:message / im:chat / contact:user.base)已授权
Q:MiniMax API Key 填进去报错 "Authentication failed"?
A:检查 Key 是否完整复制,有没有多余空格;另外确认 baseUrl 配置为 https://api.minimax.io/anthropic。
Q:电脑关机后机器人就离线了,怎么让它一直在线?
A:运行向导时加了 --install-daemon 参数,它会把 OpenClaw 注册为系统服务,开机自动启动。如果想手动检查服务状态,Mac 用户运行 launchctl list | grep openclaw,Linux 用户运行 systemctl --user status openclaw。
Q:MiniMax 费用大概多少?
A:MiniMax M2.5 定价约 0.3 元/百万输入 token,1.2 元/百万输出 token。日常工作聊天,一个月用几块钱完全够。注册后还有免费额度,新手够用很久。
Q:我的对话记录安全吗?
A:OpenClaw 的会话管理、配置文件存储在你本地(~/.openclaw/ 文件夹)。但消息内容会发送到 MiniMax 服务器处理——这是所有 AI 服务的必要步骤。建议不要在聊天里发送工作密码、个人身份证等高度敏感信息。
🎯 三步回顾
1️⃣ 装 Node.js 22
↓
2️⃣ npm install -g openclaw@latest
↓
3️⃣ openclaw onboard --install-daemon
(向导里选 MiniMax + Feishu,填入 Key 和 App ID/Secret)
↓
4️⃣ openclaw gateway --port 18789
↓
🦞 在飞书 @ 你的机器人,开始聊!📚 更多资源
- OpenClaw 官方文档:https://docs.openclaw.ai
- 飞书渠道文档(中文):https://docs.openclaw.ai/zh-CN/channels/feishu
- MiniMax 平台:https://platform.minimax.io
- GitHub 项目:https://github.com/openclaw/openclaw
💬 遇到问题了? 欢迎在评论区留言,我看到都会回复!
觉得有用的话,点个在看 让更多人看到 🙏
本文基于 OpenClaw 官方文档及飞书开放平台文档整理,针对 MiniMax M2.5 + 飞书组合专项适配。
夜雨聆风