OpenClaw + MiniMax + 飞书机器人 通用配置流程

阶段1：环境前置准备（解决底层兼容）

  1. 升级OpenClaw到最新稳定版（修复模型识别、OAuth兼容等底层bug）：
    npm install -g openclaw@latest
  2. 清空旧配置缓存（避免历史残留干扰）：
    rm -rf ~/.openclaw/state ~/.openclaw/cache
  3. 验证版本：openclaw -v 确认显示 2026.3.2+ 版本。

阶段2：MiniMax 官方授权（核心打通模型层）

  1. 启用MiniMax授权插件：
    openclaw plugins enable minimax-portal-auth
  2. 运行官方配置引导（选择对应区域端点）：
    openclaw onboard --auth-choice minimax-portal

image

  • 交互选择：对应区域端点（如中国区选「CN」）→ 按提示完成网页端OAuth授权（输入验证码）；
    image
  1. 验证模型：openclaw models list 确认显示 minimax-portal/MiniMax-M2.5 系列模型（标注「default」「configured」）。

阶段3：飞书通道配置（打通消息层）

  1. 引导式配置飞书：

    • 选择「Feishu/Lark（飞书）」通道 → 安装官方飞书插件；

    • 输入飞书平台获取的「App ID」「App Secret」；
      image
      image

    • 配置参数：WebSocket连接模式 + 对应区域域名 + 群聊白名单（按需添加允许的群ID）；
      image
      image

  2. 清理重复插件（若出现警告）：

    rm -rf ~/.openclaw/extensions/feishu

阶段4：网关服务修复（保障运行稳定）

  1. 同步配置与服务token（消除不一致警告）：
    openclaw gateway install --force
  2. 重启网关生效配置：
    openclaw gateway restart
  3. 验证网关状态：openclaw gateway status 显示「running」「RPC probe: ok」。

阶段5：权限放行与功能验证

  1. 批准飞书用户访问（解决权限拦截）：
    openclaw pairing approve feishu [配对码]
    • 配对码从飞书机器人首次消息提示中获取；
  2. 功能测试：飞书发送消息（如「你好」），机器人正常回复即完成配置。

二、核心问题解决方案（对应此前遇到的关键错误）

错误类型 错误表现 根本原因 解决步骤
模型识别失败 Unknown model: anthropic/custom-minimax/minimax/M2-her 1. 自定义代理脱离官方minimax-portal体系；2. 模型名格式错误（无minimax-portal前缀）；3. 未走OAuth授权 1. 放弃自定义代理，使用openclaw onboard官方引导；2. 模型名必须为minimax-portal/MiniMax-M2.5；3. 完成MiniMax OAuth授权
版本兼容问题 OAuth授权超时、设备签名错误、token不一致 未升级到2026.3.2+版本，旧版本存在底层bug 执行npm install -g openclaw@latest升级，清空缓存后重新配置
权限拦截 飞书提示「access not configured」 新用户首次访问未通过配对批准，被安全机制拦截 从飞书消息获取配对码，执行openclaw pairing approve feishu [配对码]放行
日志查看失败 error: unknown option '--follow' 误用日志命令参数，OpenClaw不支持--follow 用Linux通用命令查看实时日志：tail -f /tmp/openclaw/openclaw-[日期].log
插件重复警告 配置日志提示「duplicate plugin id detected」 本地存在重复的飞书插件安装 执行rm -rf ~/.openclaw/extensions/feishu删除重复插件，保留官方安装版本

三、模型配置核心对比（正确vs错误）

配置维度 错误配置（此前无效尝试） 正确配置（最终生效） 关键差异说明
Provider名称 自定义命名（如custom-minimax/shell） 官方原生minimax-portal 自定义Provider会被OpenClaw误映射到anthropic体系，官方minimax-portal是MiniMax专属适配
模型ID格式 简写/错误拼接（如MiniMax-M2.5/M2-her） 完整前缀格式（minimax-portal/MiniMax-M2.5） OpenClaw 2026+版本要求模型ID必须包含Provider前缀，否则无法识别
授权方式 手动填写API Key/自定义curl请求 官方OAuth授权（minimax-oauth模式） 手动API Key配置脱离官方验证体系，OAuth授权自动刷新token，且符合版本规范
配置来源 手动修改config.yml文件 官方onboard引导生成 手动配置易遗漏关键参数（如contextWindow/api类型），官方引导确保配置完整性
模型列表识别 未显示目标模型或显示anthropic前缀模型 明确显示minimax-portal/MiniMax-M2.5（标注default） 错误配置未接入MiniMax官方模型库，正确配置通过OAuth关联模型资源

核心总结

  1. 正确配置的关键：遵循OpenClaw官方体系，不自定义代理/手动修改核心配置，通过onboard引导完成OAuth授权和通道配置；
  2. 错误配置的共性：绕开官方规范（自定义Provider、简写模型名、未升级版本），导致模型识别、授权验证等核心流程失效；
  3. 适配2026+版本的核心原则：模型ID必须带minimax-portal前缀，授权必须走OAuth流程，网关配置需通过install --force同步token。
posted @ 2026-03-04 11:25  vivek+  阅读(0)  评论(0)    收藏  举报