OpenClaw 国产化部署全指南：飞书、MiniMax、DeepSeek 与国产网关（白山云）全流程
📋 摘要
本文面向在国内环境落地 OpenClaw 的工程同学，覆盖从安装到「飞书渠道」接入，以及常用国产模型与网关（MiniMax、DeepSeek、国产 OpenAI 兼容网关如白山云）的全流程配置与联调验收。随文附可复制配置片段与排障要点。
原文来源：科技 lion 官方博客
📖 目录
- 准备与安装
- [对接飞书（Feishu/Lark）](#二对接飞书 feishulark)
- [对接 MiniMax](#三对接 minimaxm25m25-highspeed)
- [对接 DeepSeek](#四对接 deepseek 直连或通过网关)
- [通过国产网关统一接入](#五通过国产 openai 兼容网关如白山云统一接入)
- 设置默认模型与验证
- 常见问题与排障
一、准备与安装
服务器要求： 国内云或自有机房均可（建议开启 IPv4、放行必要端口）
安装 OpenClaw：
1
| bash <(curl -sL kejilion.sh) app OpenClaw
|
二、对接飞书（Feishu/Lark）
飞书渠道生产可用，支持机器人私聊与群聊，建议优先走安装向导。
方式 A：安装向导（推荐）
1
2
3
4
5
6
| openclaw onboard
openclaw gateway restart
openclaw gateway status
|
方式 B：手工配置
配置文件：~/.openclaw/openclaw.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| {
"channels": {
"feishu": {
"enabled": true,
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "xxx",
"botName": "我的 AI 助手"
}
}
}
}
}
|
📚 详细文档
三、对接 MiniMax（M2.5/M2.5 highspeed）
路径 A：MiniMax OAuth（Coding Plan，推荐）
1
2
3
4
5
6
|
openclaw plugins enable minimax-portal-auth
openclaw gateway restart
openclaw onboard --auth-choice minimax-portal
|
路径 B：MiniMax API Key（Anthropic 兼容）
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
| {
"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 兼容）
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| {
"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），建议统一走网关，集中鉴权、配额与审计。
通用配置范式
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
| {
"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" }
}
}
}
|
六、设置默认模型与验证联通
设置默认模型
1
2
3
4
5
|
openclaw models set minimax/MiniMax-M2.5
|
联通性自检
1
2
| 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，则回复时只发文字 |
🔗 参考链接
💡 结语
通过上述流程，OpenClaw 可在国内环境下稳定对接「飞书」与多家国产模型/网关（MiniMax、DeepSeek、OpenAI 兼容网关如白山云），实现统一的模型编排与消息渠道收发。
建议将本文的配置片段与排障要点沉淀到内部运维手册，并结合企业网关做统一鉴权与审计。
整理自 KEJILION 原文，版权归作者所有
本文作者：BOSh
本文链接：http://bosh.zz.ac/posts/202603131257.html
版权声明：本文由BoSh发布，部分内容来源于网络。
