OpenClaw 国产化部署全指南飞书MiniMaxDeepSeek 与国产网关白山云全流程

2026-03-13

📋 摘要

本文面向在国内环境落地 OpenClaw 的工程同学，覆盖从安装到「飞书渠道」接入，以及常用国产模型与网关（MiniMax、DeepSeek、国产 OpenAI 兼容网关如白山云）的全流程配置与联调验收。随文附可复制配置片段与排障要点。

原文来源：科技 lion 官方博客

📖 目录

准备与安装
对接飞书（Feishu/Lark）
对接 MiniMax
对接 DeepSeek
通过国产网关统一接入
设置默认模型与验证
常见问题与排障

一、准备与安装

服务器要求： 国内云或自有机房均可（建议开启 IPv4、放行必要端口）

安装 OpenClaw：

bash <(curl -sL kejilion.sh) app OpenClaw

二、对接飞书（Feishu/Lark）

飞书渠道生产可用，支持机器人私聊与群聊，建议优先走安装向导。

方式 A：安装向导（推荐）

openclaw onboard
# 或：openclaw channels add
# 按提示选择 Feishu，填入 App ID / App Secret

openclaw gateway restart
openclaw gateway status

方式 B：手工配置

配置文件：~/.openclaw/openclaw.json

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "botName": "我的 AI 助手"
        }
      }
    }
  }
}

📚 详细文档

官方文档（中文）： https://docs.openclaw.ai/zh-CN/channels/feishu
项目内沉淀指南： AI-Skills/public/feishu-channel-guide

三、对接 MiniMax（M2.5/M2.5 highspeed）

路径 A：MiniMax OAuth（Coding Plan，推荐）

# 启用 OAuth 插件并重启
openclaw plugins enable minimax-portal-auth
openclaw gateway restart

# 交互式登录并选择区域（Global/CN）
openclaw onboard --auth-choice minimax-portal

路径 B：MiniMax API Key（Anthropic 兼容）

{
  "env": { "MINIMAX_API_KEY": "sk-..." },
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.io/anthropic",
        "api": "anthropic-messages",
        "apiKey": "${MINIMAX_API_KEY}",
        "models": [
          { 
            "id": "MiniMax-M2.5", 
            "name": "MiniMax M2.5", 
            "reasoning": true, 
            "contextWindow": 200000, 
            "maxTokens": 8192 
          },
          { 
            "id": "MiniMax-M2.5-highspeed", 
            "name": "MiniMax M2.5 Highspeed", 
            "reasoning": true, 
            "contextWindow": 200000, 
            "maxTokens": 8192 
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "minimax/MiniMax-M2.5" }
    }
  }
}

四、对接 DeepSeek（直连或通过网关）

直连示例（OpenAI 兼容）

{
  "env": { "DEEPSEEK_API_KEY": "sk-..." },
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "api": "openai-responses",
        "apiKey": "${DEEPSEEK_API_KEY}",
        "models": [
          { "id": "deepseek-chat", "name": "DeepSeek Chat" },
          { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
        ]
      }
    }
  }
}

五、通过国产 OpenAI 兼容网关（如白山云）统一接入

若企业已上「白山云等国产 AI 网关」（OpenAI 兼容 /v1），建议统一走网关，集中鉴权、配额与审计。

通用配置范式

{
  "env": { "BAISHAN_API_KEY": "bs-..." },
  "models": {
    "mode": "merge",
    "providers": {
      "baishan": {
        "baseUrl": "https://<网关控制台给出的域名>/v1",
        "api": "openai-responses",
        "apiKey": "${BAISHAN_API_KEY}",
        "models": [
          { "id": "gpt-4.1", "name": "Gateway GPT-4.1" },
          { "id": "minimax-m2.5", "name": "Gateway MiniMax M2.5" },
          { "id": "deepseek-chat", "name": "Gateway DeepSeek Chat" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "baishan/deepseek-chat" }
    }
  }
}

六、设置默认模型与验证联通

设置默认模型

# 交互式
openclaw models set minimax/MiniMax-M2.5

# 或直接在 openclaw.json 写入
# "agents": { "defaults": { "model": { "primary": "minimax/MiniMax-M2.5" } } }

联通性自检

openclaw agent --message "你好，OpenClaw 已接通吗？"
openclaw logs --follow

飞书端到端验收

在飞书中私聊你的机器人，发送一条「ping」
OpenClaw 收到消息后应返回正常文本
若无响应，依次排查：
- OpenClaw 网关状态
- 飞书应用权限与事件订阅
- 网络出站访问（到模型提供商或网关）

七、常见问题与排障要点

问题	解决方案
飞书事件订阅保存失败	确保先 `openclaw channels add` 添加了 Feishu，且 `openclaw gateway status` 为运行中
模型报 Unknown model	通常是 provider 未配置或 id 不匹配；用 `openclaw models list` 查看加载到的模型清单
通过网关 401/403	检查企业网关的鉴权白名单、流量策略、计费状态
Telegram 语音气泡重复	若在配置里将 `messages.tts.auto` 设为 `always`，则回复时只发文字

🔗 参考链接

MiniMax： https://www.minimaxi.com/
DeepSeek： https://api-docs.deepseek.com/zh-cn/
白山云： https://ai.baishan.com/auth/login

💡 结语

通过上述流程，OpenClaw 可在国内环境下稳定对接「飞书」与多家国产模型/网关（MiniMax、DeepSeek、OpenAI 兼容网关如白山云），实现统一的模型编排与消息渠道收发。

建议将本文的配置片段与排障要点沉淀到内部运维手册，并结合企业网关做统一鉴权与审计。

整理自 KEJILION 原文，版权归作者所有