hermes - 💡(How to fix) Fix Improve Feishu startup diagnostics when lark-oapi is missing

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

The gateway should surface a clear error that Feishu is configured but lark-oapi is missing, and ideally point to the installation / upgrade step required to fix it.

Additional Logs / Traceback

Root Cause

The runtime dependency check appears to conflate a missing package with a missing config signal, which makes the startup failure too ambiguous.

RAW_BUFFERClick to expand / collapse

Bug Description

When Feishu is configured, the gateway can still start with No adapter available for feishu if the lark-oapi dependency is missing. The only visible clue is a warning like Feishu: lark-oapi not installed or FEISHU_APP_ID/SECRET not set, which makes the failure look like a config problem instead of a missing runtime dependency.

Related to #21653, but this issue is specifically about startup diagnostics and actionable guidance.

Steps to Reproduce

  1. Configure Feishu credentials / enable the Feishu adapter.
  2. Start the gateway without lark-oapi installed in the environment.
  3. Observe the gateway log output.

Expected Behavior

The gateway should surface a clear error that Feishu is configured but lark-oapi is missing, and ideally point to the installation / upgrade step required to fix it.

Actual Behavior

The gateway logs a generic warning and reports No adapter available for feishu, which makes diagnosis slower.

Affected Component

  • Gateway (Telegram/Discord/Slack/WhatsApp)
  • Configuration / startup diagnostics
  • Feishu platform adapter

Debug Report

Not available from the forwarded conversation. Relevant log excerpts were:

  • Feishu: lark-oapi not installed or FEISHU_APP_ID/SECRET not set
  • No adapter available for feishu

Operating System

macOS 26.3.1

Python Version

3.11.13

Hermes Version

Hermes Agent v0.13.0 (2026.5.7)

Additional Logs / Traceback

The gateway only connected after lark-oapi was installed and the gateway was restarted.

Root Cause Analysis

The runtime dependency check appears to conflate a missing package with a missing config signal, which makes the startup failure too ambiguous.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix Improve Feishu startup diagnostics when lark-oapi is missing