# OpenClaw HTTP 401 错误排查与配置模板指南

## 问题现象

每次部署新的 OpenClaw Docker 实例后，出现 **HTTP 401 authentication_error** 错误，飞书机器人无法回复消息。

## 根本原因

**模型 API key 未配置**

OpenClaw 需要调用 AI 模型（MiniMax/千问等）来生成回复，但新实例默认没有配置 API key，导致每次请求都返回 401 认证失败。

—

## 排查步骤

### 1. 查看日志定位问题

“`bash
# 查看容器日志，搜索 401 错误
docker logs 容器名 –tail 50 | grep -i “401\|error\|api\|key”

# 示例输出：
# error=HTTP 401 authentication_error: invalid api key
“`

### 2. 检查配置文件

“`bash
# 查看 openclaw.json 中的 API key 配置
cat /opt/1panel/apps/openclaw/xxx/data/conf/openclaw.json | grep -i “apiKey”

# 如果没有输出，说明 API key 未配置
“`

### 3. 确认模型配置完整性

检查配置文件中是否包含：
– `models.providers` 配置项
– 正确的 API key
– 正确的 provider 名称（如 `minimax-cn`、`dashscope` 等）

—

## 修复方法

### 方案 A：直接修改配置文件（推荐）

编辑 `openclaw.json`，添加模型配置：

“`json
{
“models”: {
“mode”: “merge”,
“providers”: {
“minimax-cn”: {
“baseUrl”: “https://api.minimaxi.com/anthropic”,
“api”: “anthropic-messages”,
“authHeader”: true,
“models”: [
{
“id”: “MiniMax-M2.5”,
“name”: “MiniMax M2.5”,
“reasoning”: true,
“input”: [“text”],
“cost”: {
“input”: 0.3,
“output”: 1.2,
“cacheRead”: 0.03,
“cacheWrite”: 0.12
},
“contextWindow”: 200000,
“maxTokens”: 8192
}
],
“apiKey”: “你的MiniMax API key”
}
}
}
}
“`

**重启容器生效：**
“`bash
docker restart 容器名
“`

### 方案 B：环境变量配置

在 1Panel 容器配置中添加环境变量：

| 变量名 | 变量值 |
|——–|——–|
| `MINIMAX_API_KEY` | 你的 MiniMax API key |

**优点：** 不修改配置文件，部署时直接注入

### 方案 C：Web 界面配置

1. 访问 `http://IP:端口`
2. 进入 Settings → Models
3. 点击 Add Model Provider
4. 选择 MiniMax，填入 API key

—

## 配置模板

### 完整配置模板（含 MiniMax + 飞书）

“`json
{
“agents”: {
“defaults”: {
“model”: {
“primary”: “minimax-cn/MiniMax-M2.5”
}
}
},
“commands”: {
“native”: “auto”,
“nativeSkills”: “auto”,
“restart”: true,
“ownerDisplay”: “raw”
},
“channels”: {
“feishu”: {
“enabled”: true,
“appId”: “cli_你的飞书AppID”,
“appSecret”: “你的飞书AppSecret”,
“botName”: “小蓝助手”,
“groupPolicy”: “open”
}
},
“gateway”: {
“port”: 18789,
“mode”: “local”,
“bind”: “lan”,
“controlUi”: {
“dangerouslyAllowHostHeaderOriginFallback”: true,
“allowInsecureAuth”: false,
“dangerouslyDisableDeviceAuth”: true
},
“auth”: {
“mode”: “token”,
“token”: “自动生成”
}
},
“models”: {
“mode”: “merge”,
“providers”: {
“minimax-cn”: {
“baseUrl”: “https://api.minimaxi.com/anthropic”,
“api”: “anthropic-messages”,
“authHeader”: true,
“models”: [
{
“id”: “MiniMax-M2.5”,
“name”: “MiniMax M2.5”,
“reasoning”: true,
“input”: [“text”],
“cost”: {
“input”: 0.3,
“output”: 1.2,
“cacheRead”: 0.03,
“cacheWrite”: 0.12
},
“contextWindow”: 200000,
“maxTokens”: 8192
}
],
“apiKey”: “sk-cp-你的APIkey”
}
}
},
“plugins”: {
“entries”: {
“feishu”: {
“enabled”: true
}
}
}
}
“`

### 阿里云千问配置模板

“`json
{
“models”: {
“mode”: “merge”,
“providers”: {
“dashscope”: {
“baseUrl”: “https://dashscope.aliyuncs.com/compatible-mode/v1”,
“api”: “openai-completions”,
“apiKey”: “sk-你的DashScopeKey”,
“models”: [
{
“id”: “qwen-plus”,
“name”: “Qwen Plus”,
“reasoning”: false,
“input”: [“text”],
“cost”: {
“input”: 0.8,
“output”: 2
},
“contextWindow”: 32000,
“maxTokens”: 8192
}
]
}
}
}
}
“`

—

## 快速部署检查清单

部署新 OpenClaw 实例时，按此清单检查：

– [ ] 容器正常运行（`docker ps` 查看状态）
– [ ] Web 界面可访问（HTTP 200）
– [ ] 模型 API key 已配置
– [ ] 飞书 AppID/AppSecret 已配置（如使用飞书）
– [ ] 飞书插件依赖已安装（`@larksuiteoapi/node-sdk`）
– [ ] 发送测试消息验证

—

## 常见问题

### Q1: 配置了 API key 还是 401？
**检查：** API key 是否完整（以 `sk-` 开头），是否有多余空格

### Q2: 飞书消息没回复？
**检查：**
1. 飞书插件是否加载（查看日志 `feishu WebSocket client started`）
2. 模型 API key 是否配置
3. 飞书机器人是否被添加到群组

### Q3: 如何查看完整日志？
“`bash
docker logs 容器名 -f
“`

—

## 参考链接

– OpenClaw 文档：https://docs.openclaw.ai
– MiniMax API：https://api.minimaxi.com
– 飞书开放平台：https://open.feishu.cn

—

*整理时间：2026-03-09*
*适用版本：OpenClaw 2026.3.x*

原文链接： http://192.168.1.55:2789

由小蓝整理发布