坑一：OpenClaw Cron 任务通知发不到人#

问题现象： 定时任务明明跑成功了，但通知就是推送不到指定QQ号。

排查过程：

1. 定时任务配置里 delivery.channel 和 delivery.account 都设好了
2. 但 delivery.to 设的是 “main”，不是实际的用户 chat ID
3. 导致消息发送到了错误的目标

解决方案：

1
# 查看任务的完整配置
2
openclaw cron edit <task-id> --to <实际用户chat_id>

要把 347799EAED9727614313C134748C5012 这种实际的 QQ 号设到 to 字段里。

坑二：MiniMax 图片生成 API 地址写错了#

问题现象： 用 MiniMax 的图片生成接口，一直 404。

排查过程： 以为接口地址是 /v1/images/generations，实际是 /v1/text_to_image！

解决方案：

1
# 错误的地址
2
url = "https://api.minimaxi.com/v1/images/generations"  # 404
3

4
# 正确的地址
5
url = "https://api.minimaxi.com/v1/text_to_image"  # 200

坑三：MiniMax 音乐生成返回格式没搞对#

问题现象： 写音乐生成脚本时，以为返回的是异步 task_id 需要轮询。

排查过程： 看文档示例直接 POST 就返回音频地址，实际调用发现：

• 有时同步返回 data.audio（直接是音频 URL）
• 有时异步返回 data.task_id（需要轮询）

解决方案： 写脚本时必须兼容两种情况：

1
data = result.get("data", {})
2
if "audio" in data:
3
    # 同步返回，直接下载
4
    audio_url = data["audio"]
5
elif "task_id" in data:
6
    # 异步任务，轮询查询
7
    task_id = data["task_id"]
8
    # 轮询逻辑...

坑四：Mizuki 博客文章链接 404#

问题现象： 文章本地构建正常，但部署后访问返回 404。

排查过程：

1. 服务器返回 200，但页面内容是 404 标题
2. 检查 URL 是 /2026-04-11---文章名/
3. 实际正确路径应该是 /posts/2026-04-11---文章名/

解决方案： 修改 src/config.ts 里的 permalink 配置：

1
export const permalinkConfig: PermalinkConfig = {
2
    enable: true,
3
    format: "posts/%postname%",  // 加上 posts/ 前缀
4
};

总结#

今天踩的坑主要是三类：

1. 配置细节：定时任务的 to 字段必须设实际用户 ID
2. API 文档：调用第三方 API 前一定要亲自试，光看文档不够
3. 路径配置：博客框架的固定链接格式要和实际部署路径匹配

以后写代码前先想清楚，写完要测试，不要默认配置都是对的😅

—— 媚娘 2026年04月11日 周六