Clawdbot启动失败因MiniMax配置错误、认证失效或端点不可达，需修正baseUrl与api路径、更新Bearer Token认证、切换至v2原生接口、备用Qwen模型，或通过日志定位具体错误。
如果您尝试启动 Clawdbot，但 Agent 一直处于 bootstrapping 状态、无 token 消耗、返回空响应或报错，则可能是由于 MiniMax API 配置错误、认证失败或端点不可达所致。以下是解决此问题的步骤：
一、修正 MiniMax API 基础配置
Clawdbot 默认使用 MiniMax 提供的 Anthropic 兼容接口，但原始配置中 baseUrl 和 api 路径存在域名错误与路径缺失，导致 404 或 401 错误。必须将 endpoint 指向正确的 .chat 域名及有效路径。
1、打开配置文件：nano ~/.clawdbot/clawdbot.json
2、定位到 "models.providers.minimax" 区块
3、将原错误配置：{"baseUrl":"https://api.minimax.io/anthropic","api":"anthropic-messages"}
4、替换为正确配置（任选其一）：{"baseUrl":"https://api.minimax.chat/anthropic","api":"v1/messages"}
5、保存并退出编辑器
二、验证并更新 API Key 权限与格式
MiniMax 当前要求使用 Bearer Token 认证方式，且 API Key 必须具备调用 text/chatcompletion_v2 或 anthropic/v1/messages 的权限。旧式 x-api-key 头在部分 endpoint 上已失效。
1、确认 API Key 格式为 sk-cp-xxxxxxxxxxxxxxxxxxxxxxxx（以 sk-cp- 开头）
2、在配置文件中检查是否误写为 x-api-key 字段
3、修改为标准 Authorization 头格式：在 clawdbot.json 中添加或修正字段："authHeader": "Authorization", "authValue": "Bearer ${API_KEY}"
4、确保环境变量 MINIMAX_API_KEY 已正确导出并匹配配置中的占位符
三、切换至 MiniMax 原生 Chat Completion 接口
若 Anthropic 兼容接口仍不稳定，可绕过兼容层，直接对接 MiniMax 官方 v2 文本对话接口，该接口经实测稳定返回且无需额外模型映射。
1、在 clawdbot.json 中修改 MiniMax provider 配置：{"baseUrl":"https://api.minimax.chat/v1","api":"text/chatcompletion_v2"}
2、同步更新请求头配置："authHeader": "Authorization", "authValue": "Bearer ${API_KEY}"
3、确认 model 字段值为官方支持型号，例如："MiniMax-M2.1"
4、重启服务：clawdbot restart
四、启用阿里云百炼千问模型作为备用方案
当 MiniMax 服务持续异常时，可快速切换至阿里云百炼平台的 Qwen 系列模型，该方案已在无影云电脑与轻量应用服务器镜像中预集成，无需额外安装依赖。
1、登录阿里云控制台，开通 百炼模型服务 并获取 API Key
2、在 clawdbot.json 中新增或替换 provider："qwen": {"baseUrl":"https://dashscope.aliyuncs.com/api/v1","api":"services/aigc/text-generation/generation","authHeader":"Authorization","authValue":"Bearer ${QWEN_API_KEY}"}
3、修改 agents 配置，将 defaultModel 指向："qwen/qwen-max"
4、执行 clawdbot config reload 重载配置
五、检查会话日志与实时错误流
仅修改配置不足以定位深层故障，必须结合实时日志验证请求是否真正发出、响应是否被拦截或解析失败。
1、运行 clawdbot logs --follow gateway 观察网关转发行为
2、单独查看错误日志：tail -f ~/.clawdbot/logs/gateway.err.log
3、提取最近一次会话的完整记录：ls -lt ~/.clawdbot/agents/main/sessions/*.jsonl | head -1 | awk '{print $NF}' | xargs tail -20
4、确认 errorMessage 字段中是否仍出现 "404 page not found" 或 "invalid api key"
