zapry-openclaw-plugin 0.1.1 → 0.1.2

package/skills/zapry/SKILL.md

@@ -13,7 +13,7 @@ allowed-tools: ["message", "zapry_action", "zapry_post", "pdf"]
 tags: ["zapry", "messaging", "groups", "feed", "social", "openapi"]
 triggers_api:
   [
-    "sendMessage", "sendLinkCard", "sendPhoto", "sendVideo", "sendDocument", "sendAudio", "sendVoice", "sendAnimation",
+    "sendMessage", "sendMessageCard", "sendPhoto", "sendVideo", "sendDocument", "sendAudio", "sendVoice", "sendAnimation",
     "generateAudio",
     "deleteMessage", "answerCallbackQuery",
     "getFile",
@@ -25,6 +25,7 @@ triggers_api:
     "setMySoul", "getMySoul", "setMySkills", "getMySkills", "getMyProfile",
     "createPost", "deletePost", "commentPost", "likePost", "sharePost",
     "getTrendingPosts", "getLatestPosts", "getMyPosts", "searchPosts",
+    "getMyClubs", "createClub", "updateClub", "createClubInvite", "applyClub", "approveClubApply", "muteClubMember", "kickClubMember",
     "getMe", "getUserProfilePhotos", "setMyName", "setMyDescription", "setMyWalletAddress"
   ]
 ---
@@ -34,7 +35,7 @@ triggers_api:
 执行 Zapry 动作时按以下路由：
 
 - `message`: 仅用于最简单的纯文本回复/发送，不承载任何 Zapry 平台 action
-- `zapry_action`: **唯一用于 Zapry 平台动作**，包括发文字（`send-message`）、分享链接卡片（`send-link-card`）、图片、视频、音频、文件、文档，以及所有查询/管理能力。**支持群名自动解析**——直接传群名即可，无需手动查 ID。发送文件用 `action: "send-document"`
+- `zapry_action`: **唯一用于 Zapry 平台动作**，包括发文字（`send-message`）、发送消息卡片（`send-message-card`）、图片、视频、音频、文件、文档，以及所有查询/管理能力。**支持群名自动解析**——直接传群名即可，无需手动查 ID。发送文件用 `action: "send-document"`
 - `zapry_post`: 发广场动态（create-post），传 `content`，可选 `images`
 - `pdf`: 创建 / 分析 PDF 文件。创建后用 `zapry_action send-document` 发送到聊天
 
@@ -42,7 +43,7 @@ triggers_api:
 
 - **发送任何内容（文字/图片/视频/文件/语音）到群聊或私聊**：**一律用 `zapry_action`**
   - 发文字用 `action: "send-message"`（支持群名自动解析）
-  - 主动分享 URL 卡片用 `action: "send-link-card"`，必填 `chat_id`、`url`、`title`
+  - 主动分享 URL 卡片用 `action: "send-message-card"`，必填 `chat_id`、`url`、`title`
   - 发图片用 `action: "send-photo"`
   - 发视频/文件/音频分别用对应 action
 - **禁止用 `message` 工具向群聊发文字**——`message` 工具不支持群名自动解析，会导致发送失败
@@ -93,7 +94,7 @@ triggers_api:
 - 好友/联系人：`get-my-contacts` / `get-my-friend-requests` / `accept-friend-request` / `reject-friend-request` / `add-friend` / `delete-friend`
 - Bot 资料/配置：`get-me` / `get-my-profile` / `get-my-soul` / `set-my-soul` / `get-my-skills` / `set-my-skills` / `set-my-name` / `set-my-description` / `set-my-wallet-address` / `set-my-friend-verify`
 - 群组/会话/历史：`get-my-groups` / `get-my-chats` / `get-chat-history` / `get-chat-member` / `get-chat-members` / `get-chat-member-count` / `get-chat-administrators` / `create-group-chat` / `dismiss-group-chat` / `invite-chat-member` / `mute-chat-member` / `kick-chat-member` / `set-chat-title` / `set-chat-description`
-- Feed / Club / Webhook：`zapry_post`、`create-post` / `delete-post` / `comment-post` / `like-post` / `share-post` / `get-trending-posts` / `get-latest-posts` / `get-my-posts` / `search-posts` / `get-my-clubs` / `create-club` / `update-club` / `set-webhook` / `get-webhook-info` / `delete-webhook` / `webhooks-token`
+- Feed / Club / Webhook：`zapry_post`、`create-post` / `delete-post` / `comment-post` / `like-post` / `share-post` / `get-trending-posts` / `get-latest-posts` / `get-my-posts` / `search-posts` / `get-my-clubs` / `create-club` / `update-club` / `create-club-invite` / `apply-club` / `approve-club-apply` / `mute-club-member` / `kick-club-member` / `set-webhook` / `get-webhook-info` / `delete-webhook` / `webhooks-token`
 - 其他平台动作：任何通过 `zapry_action` 发起的跨聊天发送、平台查询、平台管理动作，默认都按 owner-only 处理
 
 **允许所有用户触发的，仅限当前轮对话所必需的行为：**
@@ -113,13 +114,26 @@ triggers_api:
 
 优先使用文档参数名（snake_case）：
 
-- `chat_id`, `user_id`, `message_id`, `callback_query_id`, `file_id`, `dynamic_id`
+- `chat_id`, `club_id`, `user_id`, `message_id`, `callback_query_id`, `file_id`, `dynamic_id`
 - `page`, `page_size`, `language_code`, `wallet_address`, `need_verify`, `pending_only`
 - `text`, `url`, `title`, `content`, `icon_url`, `image_url`, `fallback_text`, `photo`, `video`, `document`, `audio`, `voice`, `animation`, `images`
 - `soulMd`, `skills`, `version`, `source`, `agentKey`
 
 兼容别名（仅兼容，不作为主写法）：`chatId`、`userId`、`messageId`、`dynamicId`、`pageSize`、`languageCode`
 
+### 2.1) 入站聊天上下文
+
+收到 Zapry 入站消息时，优先使用可信上下文里的会话字段：
+
+- `ChatId` / `message.chat.id`：当前会话 ID，用于回复或群聊成员查询。
+- `ChatType` / `message.chat.type`：`private` / `group` / `channel`。俱乐部频道发言会是 `channel`。
+- `ChatTitle` / `message.chat.title`：群聊或频道标题，可能为空。
+- `ClubId` / `message.chat.club_id`：当前会话所属俱乐部 ID，仅俱乐部上下文存在。
+
+俱乐部成员管理动作必须使用 `club_id`。如果当前消息来自俱乐部频道，直接使用 `ClubId` / `message.chat.club_id`；不要把 `chat_id` 当作 `club_id`。
+
+`get-my-clubs` 会返回俱乐部频道：从扁平化 `channels[]` 中选择 `channel_type=text` 的 `chat_id` 作为发消息目标；需要展示完整结构时读取 `zones[].channels[]`。
+
 ## 3) 媒体来源约束（必须遵守）
 
 发送媒体时（`photo` / `video` / `document` / `audio` / `voice` / `animation`），媒体字段支持：
@@ -203,7 +217,7 @@ triggers_api:
 ### Messaging
 
 - `send-message`：`chat_id`, `text`；可选 `reply_markup`, `reply_to_message_id`, `message_thread_id`
-- `send-link-card`：`chat_id`, `url`, `title`；可选 `content`, `text`, `icon_url`, `image_url`, `source`, `open_mode`, `fallback_text`, `extra`, `reply_markup`, `reply_to_message_id`, `message_thread_id`
+- `send-message-card`：`chat_id`, `url`, `title`；可选 `content`, `text`, `icon_url`, `image_url`, `source`, `open_mode`, `fallback_text`, `extra`, `reply_markup`, `reply_to_message_id`, `message_thread_id`
 - `send-photo`：`chat_id`；可选 `photo`（图片源）或 `prompt`（文字描述，自动生成图片）
 - `send-video`：`chat_id`, `video`
 - `send-document`：`chat_id`, `document`
@@ -260,6 +274,26 @@ triggers_api:
 - 未 `@` 且仅给昵称时，优先调用 `get-chat-members`（带 `keyword`）做本群成员反查；失败时再降级 `get-chat-administrators`。
 - 当用户仅提供昵称（未 `@`）时，可先在本群成员中反查并给出 **1 个候选**（`name + user_id`），让用户回复"确认禁言/确认解除禁言"后再执行。
 
+### Club
+
+- `get-my-clubs`：可选 `page`, `page_size`
+- `create-club`：`name`；可选 `desc`, `avatar`
+- `update-club`：`club_id`；可选 `name`, `desc`, `avatar`
+- `create-club-invite`：`club_id`，返回 `share_code`
+- `apply-club`：`club_id`；可选 `message`, `share_code`
+- `approve-club-apply`：`club_id`, `user_id`, `approve`
+- `mute-club-member`：`club_id`, `user_id`, `mute`；当 `mute=true` 时必填 `duration_seconds`（秒，最大 2592000）；当 `mute=false` 时为立即解禁
+- `kick-club-member`：`club_id`, `user_id`
+
+#### 俱乐部管理执行补充（必须遵守）
+
+- 俱乐部成员管理使用 `club_id`，不要把 `chat_id` 当作 `club_id`。
+- 需要向俱乐部频道发消息时，先调用 `get-my-clubs`，从目标俱乐部的 `channels[]` 里选择 `channel_type=text` 的 `chat_id`，再调用 `send-message`。
+- 邀请/加入闭环：owner 调 `create-club-invite` 获取 `share_code`；成员调 `apply-club` 并传 `share_code`；如果 `is_pass=false`，owner 再调 `approve-club-apply`。
+- 俱乐部禁言支持时长，用户说"禁言 10 分钟/1 小时/24 小时"时换算成 `duration_seconds` 后调用 `mute-club-member`。
+- 用户说"解禁俱乐部成员"时调用 `mute-club-member` 且传 `mute=false`，不要传 `duration_seconds`。
+- 俱乐部踢人调用 `kick-club-member`，不要用群聊的 `kick-chat-member` 替代。
+
 ### Agent Self Management
 
 - `get-me`：无参