Feishu Mention Bot for Openclaw

A specialized tool for programmatically @mentioning robots within Feishu group chats to trigger automated workflows and inter-agent communication.

pcjinglang
v1.0.0
Mar 1, 2026
0
1.4k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install feishu-mention-bot

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install feishu-mention-bot using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Feishu Mention Bot?

The Feishu Mention Bot is a powerful integration designed to facilitate communication between users and robots, or even between multiple robots, within the Feishu (Lark) ecosystem. By leveraging Openclaw Skills, developers can automate the process of sending @mentions, ensuring that specific bots receive and respond to notifications in real-time. This skill is essential for building complex, multi-agent workflows where coordination within group chats is required.

This skill addresses a specific technical challenge in Feishu: robot information is not returned via standard group member APIs. By using this bot, you can effectively identify and target robots using their unique identifiers. It supports various message formats, including plain text, rich text (post), and interactive cards, providing flexibility for diverse automation needs across Openclaw Skills environments.

Feishu Mention Bot Use Cases

  • Triggering specific AI agents or bots within a Feishu group chat to perform tasks.
  • Automating notifications that require direct attention or confirmation from a service robot.
  • Facilitating inter-robot communication to chain multiple automated tasks within a shared channel.
  • Sending structured data or alerts that specific group members (robots) must process using Openclaw Skills.

How Feishu Mention Bot Works

  1. The system identifies the target robot's open_id (starting with ou_) by scanning chat message history or accessing a pre-configured database.
  2. A message payload is constructed using the specialized syntax required by the Feishu API.
  3. The Openclaw Skills agent dispatches the message to the specified chat_id using either the internal messaging tool or a direct API call.
  4. The target robot, provided it has subscribed to the relevant mention events, receives the notification and executes its programmed logic.

Feishu Mention Bot Setup

Prerequisites

Ensure your Feishu application has the following scopes enabled:

  • im:message or im:message:send_as_bot — To send messages.
  • im:message.group_at_msg:readonly — To receive and process @mentions.

Configuration

To use this skill effectively, you must retrieve the robot's open_id from the message history:

# 1. Obtain the tenant_access_token
TOKEN=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
  -H "Content-Type: application/json" \
  -d '{"app_id":"YOUR_APP_ID","app_secret":"YOUR_APP_SECRET"}' | jq -r '.tenant_access_token')

# 2. Extract robot open_ids from chat history mentions
curl -s "https://open.feishu.cn/open-apis/im/v1/messages?container_id_type=chat&container_id=CHAT_ID&page_size=50" \
  -H "Authorization: Bearer $TOKEN" | \
  jq '[.data.items[]? | select(.mentions != null and .mentions != []) | .mentions[]?] | unique_by(.id)'

Feishu Mention Bot Data Schema & Taxonomy

The skill utilizes specific identifier patterns and XML-like tags to ensure mentions are rendered correctly by the Feishu client.

Message Type Mention Syntax
Text Message <at user_id="ou_xxx">RobotName</at>
Rich Text (Post) <at user_id="ou_xxx">RobotName</at>
Interactive Card <at id=ou_xxx></at>

Key Requirements:

  • open_id: Must start with ou_. Application IDs (cli_) are not supported for mentions.
  • chat_id: The target group must contain both the sender and the mentioned robot.

Feishu Mention Bot Advanced Features

  • Support for interactive message cards using Lark_md syntax within Openclaw Skills.
  • Capability to extract and cache bot identifiers from historical interactions to minimize API calls.
  • Integration with automated event subscription models to ensure bots react instantly to mentions.
  • Multi-robot orchestration allowing one bot to mention and hand off tasks to another robot programmatically.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*