Feishu Mention Helper

What This Skill Does

The Feishu Mention Helper is an essential bridge between human-readable names and the machine-readable identifiers required by Feishu's API. In automated group chat environments, simply typing an @ mention followed by a name is insufficient for the system to trigger a notification. This skill automates the process of querying the Feishu organization directory to retrieve the unique OpenID associated with a specific user or bot name. By performing this lookup, the skill allows OpenClaw to inject correctly formatted XML-like mention tags into chat messages. This ensures that when the AI broadcasts updates, alerts, or task reminders, the specific recipients receive a direct notification ping. Furthermore, the skill intelligently manages a local cache in the skills/identity-manager/identities.json file, which significantly reduces API latency for frequently mentioned team members and minimizes unnecessary network traffic to the Feishu servers.

Installation

To integrate the Feishu Mention Helper into your existing OpenClaw ecosystem, execute the following command in your terminal within your OpenClaw workspace:

clawhub install openclaw/skills/skills/autogame-17/feishu-mention-helper

Ensure that your OpenClaw environment has the necessary API credentials and permission scopes configured for Feishu. This skill requires access to read the user directory, so verify that your Feishu application settings permit user searching.

Use Cases

This skill is perfect for automated project management workflows where the AI needs to notify specific developers when a build fails or a pull request is assigned. It is also highly useful in daily stand-up automation where the bot needs to @mention members to request status updates, as well as in incident response scenarios where the AI must ping the on-call engineer during a system outage.

Example Prompts

1. "Check the current project status and @mention Sarah Jenkins to see if the deployment is finished."
2. "Look up the OpenID for the QA Lead and notify them that the smoke tests have passed."
3. "Send a reminder to the infrastructure team by mentioning everyone on the DevOps list in the announcement group."

Tips & Limitations

To ensure optimal performance, keep your identity cache updated. If a user changes their display name in Feishu, you may need to clear or refresh your identities.json file to prevent lookup errors. Note that the skill relies on the exact spelling of user names as defined in the Feishu directory; fuzzy matching is not supported natively, so be precise with your inputs. If the user is not found, verify that the bot account used for integration has 'View user info' permissions granted in the Feishu developer console.