send_group_msg发送群消息需要后端方法动作列表
这一页是自动生成的
内容来自 schema/onebot-actions.json,由 pnpm docs:actions 从 packages/onebot/src/actions/ 的代码导出。不要手改这个页面 —— 改代码后重跑脚本。
最后同步的版本:214 条 action / 14 个分组 / 194 条有入参。
怎么读
点开任意一条可以看完整描述与参数表。能力标记的含义:
| 标记 | 含义 |
|---|---|
| 始终注册 | 不依赖后端任何能力,这个部署一定有 |
| 需要后端方法 | 后端实现了列出的方法才注册,否则调用返回 1404 |
| 按能力域判定 | 按功能域整体判定(如关掉 qzone 则整组不注册) |
文档列出 ≠ 当前部署能调
注册由后端能力决定,能力不足的 action 不会注册,调用时返回 1404。 启动日志里的 actions: N 才是这个部署的真实数量。
敏感能力
以下命令永不注册(即使后端实现了),属于资金类,不通过 OneBot 暴露:
send_redbagsend_red_packetreceive_redbaggrab_redbagtransfersend_transferhb_sendsso_handle
全部动作
显示 214 / 214 条
send_private_msg发送私聊消息需要后端方法send_msg发送消息(按 message_type / group_id 自动路由)需要后端方法delete_msg撤回消息需要后端方法get_msg获取消息始终注册can_send_image是否可发送图片始终注册无入参can_send_record是否可发送语音始终注册无入参get_status运行状态始终注册无入参get_version_info实现与协议版本始终注册无入参get_group_msg_history获取群消息历史按能力域判定get_friend_msg_history获取好友消息历史按能力域判定get_forward_msg获取合并转发消息(id 或 message_id)按能力域判定upload_forward_msg上传转发消息(只上传资源,不发送)按能力域判定upload_foward_msg上传转发消息(只上传资源,不发送)按能力域判定send_forward_msg发送合并转发(按 message_type / group_id / user_id 自动路由)按能力域判定send_group_forward_msg发送群合并转发按能力域判定send_private_forward_msg发送私聊合并转发按能力域判定mark_group_msg_as_read标记群消息已读按能力域判定mark_private_msg_as_read标记私聊消息已读按能力域判定mark_msg_as_read标记消息已读(群聊 / 私聊自动路由)按能力域判定forward_friend_single_msg转发单条消息给好友按能力域判定forward_group_single_msg转发单条消息到群按能力域判定send_custom_face发送账号收藏表情(emoji_id 或 MD5)按能力域判定get_login_info获取登录号信息需要后端方法无入参get_friend_list获取好友列表需要后端方法无入参get_group_list获取群列表需要后端方法无入参get_group_info获取群信息需要后端方法get_group_member_list获取群成员列表需要后端方法get_group_member_info获取群成员信息需要后端方法get_stranger_info获取陌生人信息需要后端方法set_group_card设置群名片需要后端方法set_group_ban群禁言需要后端方法set_group_whole_ban全员禁言需要后端方法set_group_admin设置群管理员需要后端方法set_group_name设置群名需要后端方法set_group_kick踢出群成员需要后端方法set_group_leave退出群需要后端方法set_group_special_title设置群头衔需要后端方法set_essence_msg设为群精华消息按能力域判定delete_essence_msg移除群精华消息按能力域判定set_group_remark设置群备注按能力域判定get_group_info_ex获取群信息(扩展)按能力域判定get_group_detail_info获取群详细信息按能力域判定set_group_kick_members批量踢出群成员按能力域判定set_group_add_option设置加群选项按能力域判定get_group_tags读取某个群分类下的资料标签按能力域判定add_group_tag添加群资料标签按能力域判定delete_group_tag删除群资料标签按能力域判定get_group_admin_permissions读取指定管理员权限按能力域判定set_group_admin_permissions设置指定管理员的撤回 / 踢人权限按能力域判定set_group_admin_receive_verify设置指定管理员是否接收加群验证消息按能力域判定set_group_robot_add_option设置群机器人加群选项按能力域判定set_group_portrait设置群头像按能力域判定get_group_system_msg获取群系统消息按能力域判定set_group_search设置群被搜索方式按能力域判定set_group_member_invite_policy设置群成员邀请策略按能力域判定set_group_new_member_history_visibility设置新成员是否可查看历史消息按能力域判定set_group_member_permissions设置群成员权限(仅群主可改)按能力域判定get_group_admin_settings获取群管理设置的当前值按能力域判定send_like给好友点赞需要后端方法send_poke戳一戳需要后端方法friend_poke好友拍一拍需要后端方法group_poke群拍一拍需要后端方法click_inline_keyboard_button点击机器人消息的内联键盘按钮按能力域判定set_friend_add_request处理加好友请求需要后端方法set_group_add_request处理加群请求需要后端方法get_group_root_files获取群根目录文件列表按能力域判定get_group_files_by_folder获取群文件夹内文件列表按能力域判定get_group_file_url获取群文件下载链接按能力域判定get_group_file_system_info获取群文件系统信息(文件数 / 空间)按能力域判定delete_group_file删除群文件按能力域判定move_group_file移动群文件到指定文件夹按能力域判定rename_group_file重命名群文件按能力域判定create_group_file_folder新建群文件文件夹按能力域判定delete_group_file_folder删除群文件文件夹按能力域判定get_private_file_url获取私聊文件下载链接按能力域判定rename_group_file_folder重命名群文件文件夹按能力域判定delete_group_folder删除群文件夹(NapCat 别名)按能力域判定trans_group_file转存群文件按能力域判定upload_group_file上传群文件按能力域判定upload_private_file上传私聊文件并发送按能力域判定add_custom_face添加收藏表情按能力域判定fetch_custom_face获取收藏表情列表按能力域判定无入参fetch_custom_face_detail获取收藏表情详情(备注)按能力域判定modify_custom_face修改收藏表情备注按能力域判定move_custom_face_to_front把收藏表情移到最前按能力域判定delete_custom_face删除收藏表情按能力域判定fetch_sys_faces获取系统表情目录按能力域判定无入参search_sys_faces按关键字搜索系统表情按能力域判定fetch_face_entity按 id 查询单个系统表情按能力域判定get_emoji_likes获取消息的表情回应列表按能力域判定get_msg_emoji_likes获取消息的表情回应列表按能力域判定fetch_emoji_like获取消息的表情回应列表按能力域判定fetch_emoji_likes获取消息的表情回应列表按能力域判定set_msg_emoji_like给群消息贴 / 撤表情回应按能力域判定set_group_reaction给群消息贴 / 撤表情回应按能力域判定set_group_todo设为群待办按能力域判定complete_group_todo完成群待办按能力域判定cancel_group_todo取消群待办按能力域判定get_group_todo_list获取群待办列表按能力域判定get_group_at_all_remain获取群 @全体成员 剩余次数按能力域判定translate_en2zh英译中(服务端翻译)按能力域判定share_peer分享用户 / 群 Ark 卡片按能力域判定send_ark_share分享用户 / 群 Ark 卡片(NapCat 标准名)按能力域判定send_group_ark_share分享群 Ark 卡片按能力域判定send_tuwen_ark发送图文 Ark 卡片按能力域判定share_group_ex分享群 Ark 卡片按能力域判定get_ai_characters获取 AI 语音角色按能力域判定get_ai_record生成 AI 语音并返回下载 URL按能力域判定send_group_ai_record生成并发送 AI 语音到群按能力域判定delete_friend删除好友按能力域判定set_friend_remark设置好友备注按能力域判定get_unidirectional_friend_list获取单向好友列表按能力域判定无入参get_doubt_friends_add_request获取可疑好友申请列表按能力域判定set_doubt_friends_add_request同意 / 拒绝可疑好友申请按能力域判定create_flash_task创建闪传任务按能力域判定get_fileset_info获取闪传文件集信息按能力域判定get_flash_file_list获取闪传文件列表按能力域判定list_filesets列出当前账号的闪传文件集按能力域判定无入参get_share_link获取闪传分享链接按能力域判定delete_flash_file删除闪传文件集按能力域判定rename_flash_file重命名闪传文件集按能力域判定send_flash_msg发送闪传分享消息按能力域判定get_flash_file_url获取闪传主文件直链按能力域判定download_fileset解析闪传主文件直链(不下载字节)按能力域判定get_fileset_id从闪传分享码 / 链接解析文件集 id按能力域判定get_group_shut_list获取群禁言列表按能力域判定fetch_super_face_id判断系统表情是否使用超级表情格式按能力域判定get_group_ignored_notifies获取被过滤的入群请求按能力域判定无入参get_group_ignore_add_request获取被忽略的入群请求(NapCat 字段)按能力域判定无入参get_group_share_link获取群分享 / 邀请链接按能力域判定get_rkey_server获取下载 rkey按能力域判定无入参get_mini_app_ark获取小程序分享卡片按能力域判定bot_exit优雅下线 bot(不退出进程)按能力域判定无入参get_profile_like获取资料点赞按能力域判定set_qq_profile设置 QQ 资料按能力域判定set_qq_avatar设置 QQ 头像按能力域判定set_online_status设置在线状态按能力域判定set_diy_online_status设置自定义在线状态按能力域判定request_decrypt_key请求数据库解密密钥按能力域判定get_friends_with_category获取分组好友列表按能力域判定set_friends_category移动好友到指定分组按能力域判定set_self_longnick设置个性签名按能力域判定set_input_status设置好友会话输入状态按能力域判定_get_group_notice获取群公告按能力域判定_send_group_notice发送群公告(支持置顶 / 新成员 / 弹窗 / 确认)按能力域判定_del_group_notice删除群公告(fid / notice_id 二选一)按能力域判定get_group_honor_info获取群荣誉信息(龙王 / 群聊之火 / 传说 / 快乐源泉)按能力域判定get_group_signed_list获取群今日打卡列表按能力域判定get_essence_msg_list获取群精华消息列表按能力域判定get_group_album_list获取群相册列表按能力域判定upload_image_to_qun_album上传图片到群相册按能力域判定get_group_album_media_list获取群相册媒体列表按能力域判定do_group_album_comment评论群相册媒体按能力域判定set_group_album_media_like点赞群相册媒体按能力域判定cancel_group_album_media_like取消点赞群相册媒体按能力域判定get_qun_album_list获取群相册列表(NapCat 封套)按能力域判定upload_video_to_qun_album上传视频到群相册按能力域判定del_group_album_media删除群相册图片或视频按能力域判定_get_friend_dress查询好友当前使用的装扮按能力域判定get_self_dress查询本账号当前使用的全部装扮按能力域判定无入参get_vip_info查询本账号会员身份(VIP / SVIP / 大会员)按能力域判定无入参get_special_care查询特别关心列表按能力域判定无入参get_friend_mutual_mark查询与好友的互动标识(火花 / 巨轮等)按能力域判定get_dress_mall_rank获取装扮商城排行榜(2 气泡 / 4 挂件 / 5 字体)按能力域判定search_dress搜索装扮商城按能力域判定get_gift_mall_home礼物商城首页推荐、愿望单与服务端页签按能力域判定get_gift_mall_list礼物商城首页礼物列表(tab / 子 tab / 游标分页)按能力域判定search_gift_mall按关键词搜索礼物商城按能力域判定get_gift_mall_gift查询单个礼物针对收礼人的详情与资格状态按能力域判定get_gift_mall_vip查询礼物商城关联的 VIP / SVIP 权益按能力域判定get_gift_mall_wall礼物墙(送出 / 收到);游标与 begin_time 原样回传按能力域判定get_gift_mall_ai_disc_status礼物商城关联的 AI 内容披露状态按能力域判定无入参send_gift赠送礼物(仅下单,返回支付参数;不会自动付款)按能力域判定get_collection_list获取收藏列表按能力域判定get_dress_url获取个性装扮(气泡 / 字体 / 头像挂件)的资源下载地址按能力域判定ftf2ttf把 FTF 字体转换成 TTF(原生 nt_helper 转换器)按能力域判定send_private_flash_photo给好友发一张闪照(阅后即焚,仅私聊)始终注册send_emoji_bounce表情弹射:让同一个系统表情在聊天窗口里弹射多份始终注册send_bubble_msg发送泡泡消息(圆形循环播放的短视频)始终注册get_group_gift_list获取群礼物面板(页签与礼物列表)按能力域判定send_location_share发起位置共享并发送位置共享卡片按能力域判定update_location_share更新位置共享里的当前定位(需按服务端间隔持续调用)按能力域判定get_qq_show_url获取 QQ 秀图片地址;不传 user_id 时查自己按能力域判定get_qzone_profile获取空间名称与说明按能力域判定get_qzone_msg_list获取空间说说列表按能力域判定get_qzone_msg_detail获取空间说说详情与评论按能力域判定get_qzone_feeds获取好友动态按能力域判定get_qzone_public_capabilities查询空友推荐入口与「推」能力按能力域判定无入参get_qzone_public_feeds读取空友推荐动态按能力域判定get_qzone_public_feed_detail读取空友推荐动态详情按能力域判定get_qzone_public_comments读取空友推荐动态评论按能力域判定get_qzone_public_replies读取空友推荐动态的评论回复按能力域判定set_qzone_profile修改空间名称 / 说明按能力域判定send_qzone_msg发表说说按能力域判定delete_qzone_msg删除说说按能力域判定like_qzone点赞说说按能力域判定unlike_qzone取消点赞说说按能力域判定comment_qzone评论说说或回复指定评论(楼中楼仅文字)按能力域判定set_qzone_msg_right修改自己空间一条说说的查看权限按能力域判定forward_qzone_msg转发一条普通说说(可带转发语)按能力域判定set_qzone_ban拉黑 / 解除拉黑(修改本账号空间黑名单)按能力域判定set_qzone_public_upvote推 / 取消推一条空友动态按能力域判定set_qzone_public_like点赞 / 取消点赞空友动态按能力域判定set_qzone_public_comment_like点赞 / 取消点赞空友评论或回复按能力域判定comment_qzone_public_feed评论空友动态按能力域判定reply_qzone_public_feed回复空友评论按能力域判定delete_qzone_public_comment删除自己的空友评论按能力域判定delete_qzone_public_reply删除自己的空友回复按能力域判定set_qzone_public_follow蹲 / 取消蹲空友动态作者按能力域判定forward_qzone_public_feed转发空友动态按能力域判定get_qzone_home_feeds读取空间主页完整动态按能力域判定get_qzone_feed_detail按 tid 读取完整空间动态按能力域判定get_qzone_share_ark用完整空间动态生成分享卡片按能力域判定