乐于分享
好东西不私藏

公务员都在养龙虾?OpenClaw 免费安装教程,小白 10 分钟搞定

公务员都在养龙虾?OpenClaw 免费安装教程,小白 10 分钟搞定

最近,开源 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@22

Windows(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:按以下顺序排查:

  1. 运行 openclaw doctor,看有没有报错
  2. 检查飞书开放平台里事件订阅是否已选长连接模式
  3. 确认机器人能力("机器人"功能)已开启
  4. 确认三个权限(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 + 飞书组合专项适配。