OpenClaw image tool 使用 Minimax VLM 模型时报 invalid api key 错误

问题

在 OpenClaw 中配置 Minimax 视觉模型（如 minimax-cn/Minimax-M2.7 或 minimax/MiniMax-VL-01），发送图片时 image 工具返回错误：

Error: invalid api key (2049)

但用相同的 API key 直接调用 Minimax API 是正常工作的。

根本原因：OpenClaw 的 image 工具使用了通用 API 端点，而 Minimax Coding Plan 用户的视觉模型（VLM）需要使用专用端点 /v1/coding_plan/vlm。两个端点对 API key 的验证逻辑不同，通用端点拒绝了 Coding Plan 的 key。

验证方法：用 curl 直接调 Coding Plan VLM 端点确认 key 是否有效：

curl -X POST "https://api.minimax.io/v1/coding_plan/vlm" \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -d '{"prompt":"describe this image","image_url":"data:image/jpeg;base64,..."}'

注意：全球端点是 api.minimax.io，国内端点是 api.minimaxi.com，两者不同。

解决方案

临时方案：图片分析暂时绕过 OpenClaw 的 image 工具，直接使用 Minimax API：

# 将图片转为 base64
BASE64_IMG=$(base64 -i /path/to/image.jpg)

# 直接调用 VLM 端点
curl -X POST "https://api.minimax.io/v1/coding_plan/vlm" \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"prompt\":\"描述这张图片\",\"image_url\":\"data:image/jpeg;base64,${BASE64_IMG}\"}"

配置回退：如果不依赖图片功能，可以将主模型换为支持 image tool 的其他提供商（如 OpenAI 或 Anthropic），仅文字对话仍使用 Minimax。

等待官方修复：OpenClaw 需要在 image 工具中检测 Minimax Coding Plan 用户并路由到正确的 VLM 端点。可关注 GitHub #66625 进展。

社区补充方法

Anthropic SecretRef API key 配置的 imageModel 始终返回 401（#69620，v2026.4.15）

将 imageModel 配置为 anthropic/claude-haiku-4-5 并使用 SecretRef 格式的 Anthropic API key 时，即使相同 API key 通过直接 curl 和 models search 均工作正常，image 路径仍返回 401。

确认为 v2026.4.15 的双重 bug：

1. 认证 bug：daemon 环境存在正确的 ANTHROPIC_API_KEY，但 image 路径传递的是无效凭证
2. 路径 bug：/home/agents/.openclaw/media/inbound/<uuid>.jpg 被拒绝为"not under an allowed directory"

临时绕过方案：将 imageModel 换用 OpenAI 或 Google 的图片生成模型：

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "openai/gpt-image-1",
        fallbacks: ["google/gemini-3.1-flash-image-preview"],
      },
    },
  },
}

等待官方修复 auth 路径传递逻辑和 media 目录白名单逻辑。