在 OpenClaw 中接入 MiniMax 模型

MiniMax 开放平台解决方案

2026年1月28日

什么是 OpenClaw？

OpenClaw（原 clawdbot） 是一个开源的 AI 助手，完全本地化，可以将各种消息平台与 AI 模型连接起来。它支持 WhatsApp、Telegram、Discord、iMessage 等多种平台，让您可以随时随地与 AI 助手对话。

多平台支持

支持 WhatsApp、Telegram、Discord、iMessage 等主流消息平台

AI Agent 桥接

支持 Pi 等 Coding Agent，具备工具调用和流式输出能力

多 Agent 路由

可将不同账户路由到隔离的 Agent，各自独立工作

MiniMax 集成

原生支持 MiniMax M2.7 作为模型提供商

快速开始

官方文档：OpenClaw 快速开始指南

前置条件

Mac OS（如需使用 iMessage）
拥有具备 Token Plan 或积分权限的 MiniMax 订阅 Key，或按量付费 API Key

安装openclaw

openclaw老用户，建议也先通过以下安装命令对openclaw进行更新。

在终端中运行以下命令一键安装：

macOS / Linux
Windows

curl -fsSL https://openclaw.bot/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

配置 MiniMax 模型

通过OAuth登录
手动安装与配置

选择配置选项

如果openclaw的初始配置引导没有出现模型配置，则可以通过以下命令再次进行 openclaw 配置：

openclaw configure

选择配置选项

Where will the Gateway run? → 选择 Local (this machine)
Select sections to configure → 选择 Model
Model/auth provider → 选择 MiniMax
MiniMax auth method → 选择 MiniMax CN — OAuth (minimaxi.com)

登录授权

自动弹出登录页，登录并授权。前端配置界面

确认模型选择

OAuth 登录完成后，进入模型选择。系统会默认勾选 minimax-portal/MiniMax-M2.7 和 minimax-portal/MiniMax-M3，并将 minimax-portal/MiniMax-M3 设为默认模型，可直接按回车确认使用。前端配置界面

推荐使用「一键安装OAuth并登录」的方式进行安装。若登录失败，可尝试以下方法。

进入配置流程

初次安装时一般会直接进入配置流程。若没有自动开始，可通过以下命令手动启动：

openclaw onboard --install-daemon

基本配置选择：

Step 1: 同意声明 → 选择 Yes
Step 2: Onboarding Mode → 选择 QuickStart

如果openclaw的初始配置引导没有出现模型配置，则可以通过以下命令进入 openclaw 配置：

openclaw configure

对于 “Where will the Gateway run?” 项，选择 Local (this machine)；对于 “Select sections to configure”项，选择 Model。

模型配置

Step 1: Model/auth provider → 选择 MiniMax
Step 2: MiniMax auth method → 选择 MiniMax CN — API Key (minimaxi.com)，海外用户选择 MiniMax Global — API Key (minimax.io)

Step 3: MiniMax API key → 填入您的 MiniMax API Key

请注意区分 API Key 类型：

Token Plan：通过接口密钥 > 订阅 Key 获取，以sk-cp开头
按量付费：通过接口密钥 > 创建新的 API Key 获取，以sk-api开头

Step 4: Models in /model picker → 直接回车使用默认选项

功能配置

Step 1: 按需选择 channel（需要在什么 App 中进行对话）
Step 2: 按需配置 Skill
Step 3: 按需启用 Hooks（可选）：
- 💾 session-memory: 执行 /new 时自动保存会话上下文
- 📝 command-logger: 记录所有命令到日志文件
- 🚀 boot-md: 网关启动时运行 BOOT.md

测试对话

输入 openclaw tui ，若成功对话则表示配置成功：下载安装

接入 iMessage

需要准备：Mac 电脑 + iPhone，且 Mac 端「信息 (Messages)」应用需完成登录。

添加邮箱到 Apple ID

电脑需用邮箱登录 iMessage（手机上则是用手机号发送信息），防止自己和自己陷入循环对话。若之前 Apple ID 没有添加邮箱：

在苹果设备上打开「设置」App
点击顶部「Apple ID」
点击「登陆与安全性」
在「电子邮件」栏点击「添加电子邮件」
输入邮箱地址并按提示完成验证

在 iMessage 里启用邮箱

在 Mac 上打开「信息」App
在左上方菜单栏点击「信息」→「设置」
开启「iMessage 信息」
点击「发送与接收」
确保新添加的邮箱开关已打开

安装核心工具 imsg

打开 Mac 终端，依次执行以下命令：

注意，此处如果报错，您需要按报错信息安装新版 Xcode

# 安装 imsg 工具
brew install steipete/tap/imsg

# 验证安装是否成功
imsg chats --limit 1

配置 iMessage 通道

在终端输入配置命令：

openclaw configure

依次执行以下步骤：

Step 1: 「Where will the Gateway run?」→ Local (this machine)
Step 2: 「Select sections to configure」→ channels
Step 3: 「Select a channel to configure/link」→ iMessage Local
Step 4: 「Configure iMessage Local?」→ Skip (leave as-is)
Step 5: 「Finished configuring?」→ Finished
Step 6: 「DM Access」→ Pairing

修改 iMessage 配置文件

打开配置文件：

open ~/.openclaw/openclaw.json

找到 channels 下的 imessage 板块，确保内容如下：

"imessage": {
  "enabled": true,
  "cliPath": "imsg路径",
  "dbPath": "chat.db路径"
}

如何获取路径

imsg 路径: 终端输入 which imsg，通常是 /Users/用户名/.homebrew/bin/imsg
chat.db 路径: Finder → 菜单栏「前往」→ 按住 Option 点击「资源库」→ 打开 Messages 文件夹 → 找到 chat.db → 右键按住 Option → 选择「将…拷贝为路径名称」

保存后重启网关服务：

openclaw gateway restart

授权访问权限

操作完成后，电脑端会弹出访问权限授权弹窗，点击「允许」。如果没有弹窗，需要手动授权：

手动授权步骤

打开 imsg 的完全磁盘访问权限：

系统设置 → 隐私与安全性 → 完全磁盘访问权限
点「+」→ 按 ⌘+⇧+G
粘贴 /Users/用户名/.homebrew/bin
选择 imsg → 点「打开」

打开终端的完全磁盘访问权限：

系统设置 → 隐私与安全性 → 完全磁盘访问权限
点「+」→ 按 ⌘+⇧+G
粘贴 /Applications/Utilities/Terminal.app
点「打开」

配对连接

用手机给 iMessage 账号（即前面配置的邮箱）发消息，会收到一个配对码。在终端执行以下配对命令（将 <配对码> 替换为收到的配对码）：

openclaw pairing approve imessage <配对码>

开始对话

配对完成后，您就可以通过 iMessage 与 MiniMax M2.7 驱动的 AI 助手进行对话了！配置文件修改

您的 OpenClaw AI 助手可以帮助您：

回答问题和提供信息
撰写和编辑文本
代码辅助和调试
创意任务和头脑风暴
以及更多！

接入飞书

飞书插件现已作为 OpenClaw 官方插件，随当前版本内置发布，无需额外安装或源码编译。

基础对话

支持飞书私聊和群聊中的 AI 对话交互

文件传输

支持接收和发送文档、音频、图片、视频

互动卡片

支持互动卡片、流式回复和表情回复

创建飞书应用

访问飞书开放平台

打开浏览器，访问飞书开放平台
使用飞书账号登录
点击「创建企业自建应用」
填写应用名称和描述，点击「确定创建」

获取应用凭证

在「凭证与基础信息」页面，复制以下凭证：

App ID（格式：cli_xxx）
App Secret

请妥善保管应用密钥，不要分享给他人或提交到代码仓库。

添加权限

导航到「权限管理」，点击「批量导入」，粘贴以下权限配置：

{
  "scopes": {
    "tenant": [
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ]
  }
}

启用机器人能力

在「应用能力」>「机器人」中，开启机器人能力并设置机器人名称。

配置事件订阅

在「事件与回调」页面：

订阅方式选择「使用长连接接收事件」（WebSocket 模式）
添加事件：im.message.receive_v1（接收消息）

请确保 OpenClaw 网关正在运行后再配置此步骤。

发布应用

进入「版本管理与发布」页面，创建版本并提交发布。

配置 OpenClaw 飞书通道

添加飞书通道

运行以下命令进入交互式配置：

openclaw channels add

选择 Feishu，然后按提示输入 App ID 和 App Secret。

验证配置

可以检查配置文件 ~/.openclaw/openclaw.json 中飞书配置是否正确：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "name": "My AI assistant"
        }
      }
    }
  }
}

连接飞书测试

启动网关

openclaw gateway start

添加群机器人

进入飞书，新建群聊后，在群设置中添加群机器人，搜索并选择上述创建的应用，并点击添加。

测试对话

在群聊中 @机器人发送消息。首次使用时，机器人会返回一个配对码，在终端中运行以下命令进行配对：

openclaw pairing approve feishu <配对码>

配对成功后即可正常对话。

通过 OAuth 登录 minimax-portal 后，OpenClaw 的 image 工具会自动配置为使用 MiniMax 图像理解 MCP 服务背后的 VLM 端点，无需额外配置即可让您的智能体具备图像理解能力。

总结

在本教程中，您学习了如何：

安装和配置 OpenClaw：使用 MiniMax M2.7 模型驱动 OpenClaw 开启工作
正确配置服务：修改 API 地址以成功使用
接入 iMessage：在 Mac 上配置 iMessage 通道与 AI 助手对话
接入飞书：使用官方内置飞书插件在群聊中与 AI 助手对话

通过 OpenClaw 和 MiniMax M2.7，您现在可以随时通过 iMessage 或飞书与 AI 助手交流，体验便捷的智能对话服务。

OpenClaw 文档

官方文档

MiniMax M3

模型介绍

Token Plan

立即订阅

开始使用

使用指南

常见问题

条款与政策

什么是 OpenClaw？

多平台支持

AI Agent 桥接

多 Agent 路由

MiniMax 集成

快速开始

前置条件

安装openclaw

配置 MiniMax 模型

接入 iMessage

接入飞书

基础对话

文件传输

互动卡片

创建飞书应用

配置 OpenClaw 飞书通道

连接飞书测试

总结

相关资源

OpenClaw 文档

MiniMax M3

Token Plan

​什么是 OpenClaw？

多平台支持

AI Agent 桥接

多 Agent 路由

MiniMax 集成

​快速开始

​前置条件

​安装openclaw

​配置 MiniMax 模型

​接入 iMessage

​接入飞书

基础对话

文件传输

互动卡片

​创建飞书应用

​配置 OpenClaw 飞书通道

​连接飞书测试

​总结

​相关资源

OpenClaw 文档

MiniMax M3

Token Plan

什么是 OpenClaw？

快速开始

前置条件

安装openclaw

配置 MiniMax 模型

接入 iMessage

接入飞书

创建飞书应用

配置 OpenClaw 飞书通道

连接飞书测试

总结

相关资源