Complete Feishu/Lark bot integration for AI agents.
im:message - Send messagesim:message:send_as_bot - Send as botcontact:user.base:readonly - Read user infoim:chat - Manage groupsapproval:approval - Approval workflowsSet environment variables:
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"
Or configure in OpenClaw settings.
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)
card = {
"type": "template",
"data": {
"template_id": "xxx",
"template_variable": {"title": "Notification"}
}
}
bot.send_card("chat_id", card)
group = bot.create_group(
name="Project Team",
user_ids=["ou_xxx", "ou_yyy"]
)
print(group["chat_id"])
# 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"])
| 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 |
Common errors:
99991663: Token expired - refresh tenant token99991664: Permission denied - check app permissions99991661: User not found - verify user_id共 1 个版本