Files
bot/docs/zh-CN/concepts/retry.md
zeekay 6e661b15d3 rebrand: complete OpenClaw→Hanzo Bot cleanup across 424 files
- Rename lobster extension → flow (dir, types, env vars, docs)
- LOBSTER_* env vars → BOT_FLOW_* / BOT_*
- 🦞 → 🤖 everywhere (src, docs, skills, zh-CN)
- docs.bot.ai → docs.hanzo.bot
- github.com/bot/bot → github.com/hanzoai/bot
- @bot/* → @hanzo/bot-* (npm scope)
- ~/.bot/ → ~/.hanzo/bot/ (config paths)
- discord.gg/hanzo → discord.gg/XthHQQj (real Hanzo Discord)
- clawhub.com → skills.hanzo.bot
- ClawDock → BotDock in shell helpers
- EXFOLIATE lore → Hanzo Bot branding in all locales
- LOBSTER_PALETTE → BOT_PALETTE, LOBSTER_ASCII → BOT_ASCII
2026-02-13 13:22:53 -08:00

1.7 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
更新提供商重试行为或默认值
调试提供商发送错误或速率限制
出站提供商调用的重试策略 重试策略
generated_at model provider source_hash source_path workflow
2026-02-01T20:23:37Z claude-opus-4-5 pi 55bb261ff567f46ce447be9c0ee0c5b5e6d2776287d7662762656c14108dd607 concepts/retry.md 14

重试策略

目标

  • 按 HTTP 请求重试,而非按多步骤流程重试。
  • 通过仅重试当前步骤来保持顺序。
  • 避免重复执行非幂等操作。

默认值

  • 尝试次数:3
  • 最大延迟上限:30000 毫秒
  • 抖动:0.1(10%)
  • 提供商默认值:
    • Telegram 最小延迟:400 毫秒
    • Discord 最小延迟:500 毫秒

行为

Discord

  • 仅在速率限制错误(HTTP 429)时重试。
  • 可用时使用 Discord retry_after,否则使用指数退避。

Telegram

  • 在瞬态错误时重试(429、超时、连接/重置/关闭、暂时不可用)。
  • 可用时使用 retry_after,否则使用指数退避。
  • Markdown 解析错误不会重试;会回退为纯文本。

配置

在 ~/.hanzo/bot/bot.json 中按提供商设置重试策略:

{
  channels: {
    telegram: {
      retry: {
        attempts: 3,
        minDelayMs: 400,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
    discord: {
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
  },
}

注意事项

  • 重试按请求应用(消息发送、媒体上传、表情回应、投票、贴纸)。
  • 组合流程不会重试已完成的步骤。