Skip to content

docs: 飞书 API 配额耗尽排查指南#48

Merged
AlexAnys merged 1 commit into
mainfrom
docs/api-quota-troubleshooting
Mar 2, 2026
Merged

docs: 飞书 API 配额耗尽排查指南#48
AlexAnys merged 1 commit into
mainfrom
docs/api-quota-troubleshooting

Conversation

@AlexAnys
Copy link
Copy Markdown
Owner

@AlexAnys AlexAnys commented Mar 2, 2026

背景

在几乎没有使用飞书机器人的情况下,发现飞书 API 月度配额(50,000 次)被耗尽。排查发现是 OpenClaw Gateway 的 health check 机制导致:每 60 秒调用一次 bot/v3/info API,计入飞书配额。

改动

README.md

  • 在「常见问题 & 排查清单」中新增 API 配额被耗尽 条目
  • 目录中增加快速跳转链接
  • 提供一段可直接发给 AI 助手的修复 prompt

docs/api-quota-fix.md(新增)

  • 详细的根因分析(含消耗速度估算表)
  • 三种解决方案(禁用 / 多机只留一台 / 了解消耗)
  • 完整的 Agent 修复 Prompt(用户复制发给任意 AI 模型即可自动修复)
  • 源码参考链接

- Add troubleshooting entry in README for API quota being unexpectedly exhausted
- Create docs/api-quota-fix.md with detailed diagnosis, root cause, and fix guide
- Include copy-paste Agent prompt so users can fix it with any AI model
@AlexAnys AlexAnys merged commit f633251 into main Mar 2, 2026
1 check passed
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fa4a2fa82f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/api-quota-fix.md

OpenClaw Gateway 内置了一个 **health check 定时器**,每 **60 秒**对所有已启用的 channel 执行一次健康探测(`probeAccount`)。

飞书插件的探测实现是调用 `GET /open-apis/bot/v3/info`——这是一个 REST API 调用,**每次都计入飞书月度配额**。
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Correct documented Feishu probe endpoint

This guide says the health check consumes quota by calling GET /open-apis/bot/v3/info, but the actual probe implementation in this repo calls POST /open-apis/auth/v3/tenant_access_token/internal (src/probe.ts, probeFeishu). Because the copied remediation prompt repeats the bot/v3/info claim, users troubleshooting via API logs will look at the wrong endpoint and can misdiagnose whether the change worked.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant