- name
- feishu-bot
- description
- Feishu (Lark) Bot integration for messaging, group management, and approval workflows. Send messages, manage groups, handle approvals, and automate notifications via Feishu Open Platform API.
- tags
- version
- 1.0.0
- author
- chenq
Feishu Bot
Complete Feishu/Lark bot integration for AI agents.
Features
1. Messaging
- Send text, rich text, and card messages
- Send to users, groups, or via webhook
- Reply to messages
- Upload and send files/images
2. Group Management
- Create groups
- Add/remove members
- Update group info
- Bot group management
3. Approval Workflows
- Create approval instances
- Query approval status
- Cancel approvals
- Approval notifications
Prerequisites
- Create a Feishu App at https://open.feishu.cn/app
- Get App ID and App Secret
- Configure permissions:
- im:message - Send messages - im:message:send_as_bot - Send as bot - contact:user.base:readonly - Read user info - im:chat - Manage groups - approval:approval - Approval workflows
Configuration
Set environment variables:
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"Or configure in OpenClaw settings.
Usage
Send Text Message
from feishu_bot import FeishuBot
bot = FeishuBot()
# Send to user
bot.send_text("user_id", "Hello from bot!")
# Send to group
bot.send_text("chat_id", "Group message", is_chat=True)Send Card Message
card = {
"type": "template",
"data": {
"template_id": "xxx",
"template_variable": {"title": "Notification"}
}
}
bot.send_card("chat_id", card)Create Group
group = bot.create_group(
name="Project Team",
user_ids=["ou_xxx", "ou_yyy"]
)
print(group["chat_id"])Approval Workflow
# Create approval
approval = bot.create_approval(
approval_code="xxx",
user_id="ou_xxx",
form={"field1": "value1"}
)
# Query status
status = bot.get_approval_instance(approval["instance_id"])API Reference
| Method | Description |
|---|---|
send_text(target, text, is_chat=False) | Send text message |
send_card(target, card, is_chat=False) | Send card message |
send_image(target, image_key, is_chat=False) | Send image |
send_file(target, file_key, is_chat=False) | Send file |
create_group(name, user_ids) | Create group |
add_group_members(chat_id, user_ids) | Add members |
remove_group_members(chat_id, user_ids) | Remove members |
create_approval(approval_code, user_id, form) | Create approval |
get_approval_instance(instance_id) | Get approval status |
Error Handling
Common errors:
99991663: Token expired - refresh tenant token99991664: Permission denied - check app permissions99991661: User not found - verify user_id