Feishu Mention Helper

Resolve Feishu user and bot names to OpenIDs for group chat mentions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/WangK0221/OpenClaw_Shrimp --skill feishu-mention-helper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Feishu Mention Helper
Source: https://github.com/WangK0221/OpenClaw_Shrimp/tree/main/skills/feishu-mention-helper
Command: npx skills add https://github.com/WangK0221/OpenClaw_Shrimp --skill feishu-mention-helper

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires axios, and includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of creating functional @mentions in Feishu group chats by resolving user or bot names to their unique OpenIDs.

Core Features & Use Cases

  • Name to OpenID Resolution: Converts human-readable names into the required OpenID format for mentions.
  • Contextual Search: Prioritizes searching within a specified chat for more accurate results.
  • Caching: Stores resolved identities to speed up future lookups.
  • Use Case: When you need to @mention a colleague in a Feishu group but only know their name, this skill finds their OpenID so the mention works correctly.

Quick Start

Use the Feishu Mention Helper skill to find the OpenID for the user named 'Alice' in the chat with ID 'chat123'.

Frequently Asked Questions about Feishu Mention Helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resolve a Feishu user name to an OpenID for group chat mentions?

To resolve Feishu user names to OpenIDs for mentions, you can use a lookup tool that searches within a specific chat ID and falls back to cached identities. This requires Feishu API access tokens to authenticate the resolution process.

What is needed to look up Feishu OpenIDs for functional @mentions?

Looking up Feishu OpenIDs requires Feishu API access tokens and optionally an identity manager for persistent storage. You must also provide the target user or bot name and optionally the specific chat ID for contextual search.

Does Feishu mention resolution work without specifying a chat ID?

Feishu mention resolution prioritizes searching within a provided chat ID for accurate results, but it can fall back to cached identities. Without a chat ID, it relies entirely on previously stored identity manager data.

How do I speed up repeated Feishu OpenID lookups for bot mentions?

To speed up repeated Feishu OpenID lookups, the resolution process stores resolved identities in a cache. By optionally utilizing an identity manager for persistent storage, future lookups for the same bots bypass the API calls.

Why does my Feishu @mention fail to notify the user when using their name?

Feishu @mentions fail when using human-readable names because the API requires the user's unique OpenID format. You must resolve the name to the corresponding OpenID first to enable functional mentions in group chats.

Can I use axios to resolve Feishu user names to OpenIDs?

Yes, you can use axios to make the HTTP requests required by the Feishu API for resolving user names to OpenIDs. The resolution process depends on API access tokens to authenticate these requests and retrieve the correct identifiers.