OpenClaw 国产化部署全指南：飞书、MiniMax、DeepSeek 与国产网关（白山云）全流程

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 原文，版权归作者所有