m1heng/clawdbot-feishu/feishu-chat

Feishu Chat Tool

Feishu chat operations including group announcement reading/writing and group chat management.

Actions

Get Announcement Info

{ "action": "get_announcement_info", "chat_id": "oc_abc123def" }

Returns basic announcement information including type (doc or docx) and metadata.

Get Full Announcement

{ "action": "get_announcement", "chat_id": "oc_abc123def" }

Returns complete announcement content. Supports both old (doc) and new (docx) announcement formats.

List Announcement Blocks

{ "action": "list_announcement_blocks", "chat_id": "oc_abc123def" }

Returns all blocks for a docx-format announcement.

Get Single Announcement Block

{ "action": "get_announcement_block", "chat_id": "oc_abc123def", "block_id": "block_123" }

Returns a single block from the announcement.

Write Announcement

{ "action": "write_announcement", "chat_id": "oc_abc123def", "content": "New announcement content" }

For doc format: replaces the entire announcement content. For docx format: appends a new text block under the page root (full replacement is not supported via API; use update_announcement_block to edit existing blocks).

Append Announcement

{ "action": "append_announcement", "chat_id": "oc_abc123def", "content": "Additional content" }

Appends content to the announcement.

Update Announcement Block

{ "action": "update_announcement_block", "chat_id": "oc_abc123def", "block_id": "block_123", "content": "New text content" }

Updates a single block's text content in a docx-format announcement.

Group Chat Management

Create Group Chat

{ "action": "create_chat", "name": "My Group", "user_ids": ["ou_123", "ou_456"], "description": "Group description" }

Creates a new group chat with optional initial members and description.

Add Members to Group

{ "action": "add_members", "chat_id": "oc_abc123def", "user_ids": ["ou_123", "ou_456"] }

Adds specified users to an existing group chat.

Check Bot in Chat

{ "action": "check_bot_in_chat", "chat_id": "oc_abc123def" }

Checks if the bot is a member of the specified chat.

Delete Chat

{ "action": "delete_chat", "chat_id": "oc_abc123def" }

Deletes/disbands a group chat. The bot must have appropriate permissions (typically needs to be the group owner or have admin privileges).

Note: Deleting a chat will remove all members and the chat history will no longer be accessible. Use with caution.

Create Session Chat (One-Step)

{ 
  "action": "create_session_chat", 
  "name": "Project Discussion", 
  "user_ids": ["ou_123", "ou_456"],
  "greeting": "Hi everyone! Let's discuss the project here.",
  "description": "Group for project collaboration"
}

One-step operation that creates a group chat, adds users, and sends a greeting message.

Configuration

channels:
  feishu:
    tools:
      chat: true  # default: true

Permissions

Required for announcements:

• im:chat.announcement:read - View group announcement information
• im:chat.announcement - Edit group announcement information (for write operations)

Required for group management:

• im:chat:readonly - Get chat info, check bot membership (check_bot_in_chat)
• im:chat - Create and delete group chats (create_chat, delete_chat)
• im:chat.members - Add members to group chats (add_members)
• im:message:send_as_bot - Send messages as bot (for create_session_chat greeting)

Note for delete_chat: Requires the bot to be the group owner or have admin privileges to disband the chat.