Skip to content
Agentmart
Submit a tool

feishu-troubleshoot

When 飞书 plugin errors or auth failures occur → troubleshoot with FAQ and authorization diagnostics.

Skill by cklxx

IndexedMIT★ 11
Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/cklxx-feishu-troubleshoot

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

When 飞书 plugin errors or auth failures occur → troubleshoot with FAQ and authorization diagnostics.

Use cases: security

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools
No tools found
Secrets
None asked for
Install scripts
None found

Network hosts it talks to 1

  • codeload.github.com · found in install command

Files it touches

  • ~/.claude/skills/feishu-troubleshoot

What's inside

Skill name
feishu-troubleshoot
Description
When 飞书 plugin errors or auth failures occur → troubleshoot with FAQ and authorization diagnostics.
License
MIT
Instructions
52 lines in SKILL.md · view on GitHub

Files (1)

  • SKILL.md

SKILL.md (first lines)

# 飞书问题排查

## 常见问题(FAQ)

### 授权相关

**Token 过期**
- 现象:API 调用返回 `99991668` 或 `99991672`
- 解决:重新执行 OAuth 授权流程

**权限不足**
- 现象:API 返回 `99991400` 或 `99991403`
- 解决:检查应用是否开通了所需的 API 权限,参考下方权限对照表

**Refresh Token 过期**
- 现象:刷新 token 时返回错误
- 解决:需要重新走完整 OAuth 流程

### 权限对照表

| 功能模块 | 所需权限 scope |
|---------|---------------|
| 日历读写 | `calendar:calendar`, `calendar:calendar:readonly` |
| 文档读写 | `docx:document`, `docx:document:readonly` |
| 多维表格 | `bitable:app`, `bitable:app:readonly` |
| 任务管理 | `task:task`, `task:task:readonly` |
| 通讯录 | `contact:user.base:readonly`, `contact:department.base:readonly` |
| 消息读写 | `im:message`, `im:message:readonly` |
| 云盘 | `drive:drive`, `drive:drive:readonly` |
| Wiki | `wiki:wiki`, `wiki:wiki:readonly` |
| 邮件 | `mail:mailgroup`, `mail:mailgroup:readonly` |

### API 调用问题

**频率限制**
- 飞书 API 有频率限制,通常 100 次/秒
- 批量操作建议串行 + 延迟 0.5-1 秒

**字段值格式错误**
- 参考 `skills/feishu-bitable/references/record-values.md`

## 诊断命令

```bash
# 查看授权状态
python3 skills/feishu-cli/run.py '{"action":"auth","subcommand":"status"}'

# 查看可用模块
python3 skills/feishu-cli/run.py '{"action":"help","topic":"modules"}'
```

From cklxx/elephant.ai, MIT.

More from cklxx/elephant.ai

Signals

Stars
11
Forks
2
Open issues
1
Last commit (this folder)
Mar 23, 2026 (7 months ago)
Last release
Feb 16, 2026 (8 months ago)

From GitHub (fetched Oct 24, 2026).

Details

License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

More from cklxx

Cite this page

feishu-troubleshoot skill. Agent Mart. https://agentmart.dev/skills/cklxx-feishu-troubleshoot (last updated 2026-10-24)