Clawdbot MiniMax 配置问题解决方案

我是用 quickStart 方式，配置完成了Clawdbot，但是给机器人发消息，一直收到空回复，然后我让claude code帮我解决问题，大概20分钟后问题解决，这篇文档也是让claude code生成的！

如果你也想解决这个问题，直接把这篇文章发给claude code，让他直接操作即可

📋 问题概述

Clawdbot 配置 MiniMax M2.1 模型后，在 Telegram 上发送消息时返回空回复，无法获得 AI 响应。

环境信息：

Clawdbot 版本: 2026.1.24-3
系统: macOS 26.2 (arm64)
模型: MiniMax M2.1
通信渠道: Telegram

🔍 问题现象

1. 初始表现

Telegram bot 能接收消息
Agent 状态显示 bootstrapping
Sessions 显示 0 tokens
返回空响应或错误

2. 错误日志

TypeError: fetch failed
404 404 page not found
401 authentication error: invalid api key

3. Agent 状态异常

Agents: 1 · 1 bootstrapping · 0 active
Tokens: 0.0k/200k (0%)

🔧 排查过程

步骤 1: 检查基本状态

clawdbot status --all

发现：

Agent 一直处于 bootstrapping 状态
Gateway 正常运行
Telegram 通道连接正常
但无实际 token 消耗

步骤 2: 查看错误日志

clawdbot logs --follow
tail -f ~/.clawdbot/logs/gateway.err.log

发现多个错误：

TypeError: fetch failed - 网络请求失败
404 page not found - API endpoint 不存在
401 invalid api key - API key 认证失败

步骤 3: 检查会话日志

ls -lt ~/.clawdbot/agents/main/sessions/*.jsonl | head -1 | awk '{print $NF}' | xargs tail -30

会话内容显示：

{
  "message": {
    "role": "assistant",
    "content": [],
    "stopReason": "error",
    "errorMessage": "404 404 page not found"
  }
}

步骤 4: 验证 API 配置

cat ~/.clawdbot/clawdbot.json | jq '.models.providers.minimax'

原始错误配置：

{
  "baseUrl": "https://api.minimax.io/anthropic",
  "api": "anthropic-messages"
}

步骤 5: 测试 API 端点

测试不同的 endpoint：

# 测试 1: 原始配置（失败）
curl -X POST https://api.minimax.io/anthropic/v1/messages \
  -H "x-api-key: sk-cp-..." \
  -d '{"model":"MiniMax-M2.1",...}'
# 结果: 401 invalid api key

# 测试 2: 使用 .chat 域名的原生 API（成功）
curl -X POST https://api.minimax.chat/v1/text/chatcompletion_v2 \
  -H "Authorization: Bearer sk-cp-..." \
  -d '{"model":"MiniMax-M2.1",...}'
# 结果: ✅ 成功返回响应

# 测试 3: 使用 .chat 域名的 Anthropic 兼容 API（成功）
curl -X POST https://api.minimax.chat/anthropic/v1/messages \
  -H "x-api-key: sk-cp-..." \
  -d '{"model":"MiniMax-M2.1",...}'
# 结果: ✅ 成功返回响应

# 测试 4: 使用错误的路径（失败）
curl -X POST https://api.minimax.chat/v1/messages \
  -H "x-api-key: sk-cp-..." \
  -d '{"model":"MiniMax-M2.1",...}'
# 结果: 404 page not found

🎯 根本原因

问题 1: BaseURL 域名错误

错误配置: https://api.minimax.io/anthropic
正确配置: https://api.minimax.chat/anthropic
原因: .io 域名的 API endpoint 不支持用户的 API key

问题 2: URL 路径不完整

问题: Clawdbot 使用 api: "anthropic-messages" 时，会在 baseUrl 后添加 /v1/messages
实际调用: https://api.minimax.chat/v1/messages ❌
正确调用: https://api.minimax.chat/anthropic/v1/messages ✅
原因: baseUrl 缺少 /anthropic 路径段

问题 3: API Key 未在 Provider 配置中指定

问题: 仅在 auth-profiles.json 中配置，未在 models.providers.minimax 中指定
影响: 某些场景下无法正确读取 API key

✅ 解决方案

方案实施步骤

1. 更新 MiniMax Provider 配置

编辑配置文件：

vim ~/.clawdbot/clawdbot.json

或使用命令行：

clawdbot config set models.providers.minimax.baseUrl "https://api.minimax.chat/anthropic"

2. 添加 API Key 到 Provider 配置

在配置文件中添加 apiKey 字段：

{
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.chat/anthropic",
        "apiKey": "<API-KEY>",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M2.1",
            "name": "MiniMax M2.1",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 15,
              "output": 60,
              "cacheRead": 2,
              "cacheWrite": 10
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

3. 重启 Gateway

clawdbot gateway restart

4. 清除旧会话（可选）

如果会话文件包含错误的配置，建议清除：

rm ~/.clawdbot/agents/main/sessions/sessions.json
clawdbot gateway restart

5. 验证配置

# 检查状态
clawdbot status

# 查看 Agent 状态
clawdbot status | grep -A 5 "Agents"

# 查看 Tokens 使用
clawdbot status | grep "Tokens"

预期结果：

Agents: 1 · 1 active · sessions 1
Tokens: > 0 tokens (显示实际使用量)

✨ 验证结果

成功指标

Agent 状态正常
```
Agents: 1 · 1 active · sessions 1
```
Token 使用正常
```
Tokens: 12k/200k (6%)
```

会话日志显示成功响应

{
  "type": "message",
  "message": {
    "role": "assistant",
    "content": [
      {
        "type": "text",
        "text": "回复内容..."
      }
    ],
    "stopReason": "stop",
    "usage": {
      "input": 16,
      "output": 160,
      "totalTokens": 11839
    }
  }
}

Telegram Bot 正常回复
- 发送消息后能收到 AI 响应
- 响应内容完整且有意义

测试命令

# 实时查看日志
clawdbot logs --follow

# 查看最新会话
ls -lt ~/.clawdbot/agents/main/sessions/*.jsonl | head -1 | awk '{print $NF}' | xargs tail -20

# 完整状态检查
clawdbot status --all

📚 完整配置参考

clawdbot.json (MiniMax 部分)

{
  "auth": {
    "profiles": {
      "minimax:default": {
        "provider": "minimax",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.chat/anthropic",
        "apiKey": "sk-cp-YOUR_API_KEY_HERE",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M2.1",
            "name": "MiniMax M2.1",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 15,
              "output": 60,
              "cacheRead": 2,
              "cacheWrite": 10
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "minimax/MiniMax-M2.1"
      }
    }
  }
}

auth-profiles.json

{
  "version": 1,
  "profiles": {
    "minimax:default": {
      "type": "api_key",
      "provider": "minimax",
      "key": "sk-cp-YOUR_API_KEY_HERE"
    }
  },
  "lastGood": {
    "minimax": "minimax:default"
  }
}

🔍 故障排查技巧

常用命令

# 1. 检查 Gateway 状态
clawdbot gateway status

# 2. 查看 Agent 状态
clawdbot status

# 3. 实时日志
clawdbot logs --follow

# 4. 查看 Gateway 日志
tail -f ~/.clawdbot/logs/gateway.log

# 5. 查看错误日志
tail -f ~/.clawdbot/logs/gateway.err.log

# 6. 测试模型列表
clawdbot models list

# 7. 测试模型状态
clawdbot models status

# 8. 运行诊断
clawdbot doctor
clawdbot doctor --fix

# 9. 深度健康检查
clawdbot status --deep

# 10. 测试 API 连接
curl -v -X POST https://api.minimax.chat/anthropic/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"MiniMax-M2.1","max_tokens":100,"messages":[{"role":"user","content":"hi"}]}'

常见错误及解决

错误信息	原因	解决方案
`fetch failed`	BaseURL 错误或网络问题	检查 `baseUrl` 配置，测试网络连接
`404 page not found`	API endpoint 路径错误	确保 baseUrl 包含 `/anthropic`
`401 invalid api key`	API key 错误或位置不对	检查 `apiKey` 字段和 `auth-profiles.json`
`Agent bootstrapping`	Agent 无法启动	检查日志，清除旧会话
`Tokens: 0.0k`	无实际 API 调用	检查配置和日志

📖 参考资源

官方文档

API 端点测试

MiniMax 原生 API: https://api.minimax.chat/v1/text/chatcompletion_v2
MiniMax Anthropic 兼容: https://api.minimax.chat/anthropic/v1/messages

🎓 经验总结

关键要点

BaseURL 必须包含完整路径
- 错误: https://api.minimax.chat
- 正确: https://api.minimax.chat/anthropic
API Key 需要在两处配置
- models.providers.minimax.apiKey
- auth-profiles.json
不同域名的用途不同
- api.minimax.io - 官方文档推荐，但可能需要特殊 key
- api.minimax.chat - 实际可用的 endpoint
测试 API 是关键
- 使用 curl 测试 endpoint 可验证配置
- 从错误日志中获取实际调用的 URL
清除旧会话很重要
- 错误配置的会话会缓存
- 删除 sessions.json 可以强制重新初始化

最佳实践

配置修改后总是重启 gateway
使用 clawdbot status --all 获取完整诊断
定期查看 clawdbot logs --follow 了解运行状态
保留配置文件的备份
先用 curl 测试 API，再配置 Clawdbot

📝 变更历史

日期	版本	变更内容
2026-01-27	1.0	初始版本，完整解决方案

文档创建时间: 2026-01-27
最后更新: 2026-01-27
适用版本: Clawdbot 2026.1.24-3
作者: AI Assistant (Claude)