本文详细介绍了在Python中使用Telethon库从Telegram消息中删除图片的方法。针对用户尝试使用`event.edit(file=None)`无效的问题，我们明确指出，直接移除消息中图片而保留文本的功能并非通过`event.edit`实现。核心解决方案是利用`client.delete_messages`方法来删除包含图片的原消息，并通过示例代码演示了如何初始化客户端、获取消息、判断媒体类型并执行删除操作，确保用户能有效管理消息中的媒体内容。
Telethon消息中图片删除的专业指南
在使用Telethon库处理Telegram消息时，开发者经常会遇到需要从已发送消息中移除图片的需求。常见的误解是尝试通过event.edit(file=None)来达到这一目的。然而，event.edit方法主要用于修改消息的文本内容或替换媒体文件，而非直接“删除”媒体而保留文本。当消息中包含图片时，若要彻底移除该图片，最直接且有效的方法是删除整条消息。
理解消息编辑与删除的差异
Telethon的event.edit方法允许您修改消息的某些属性，例如文本内容或替换其附加的媒体文件。当您尝试将file参数设置为None时，系统并不会理解为“移除现有文件”，而是可能忽略该参数或导致其他非预期行为。对于包含媒体（如图片）的消息，如果目标是使图片消失，同时不关心消息文本是否也一并删除，那么使用删除消息的API是更为直接和推荐的做法。
核心解决方案：删除包含图片的消息
Telethon库提供了client.delete_messages方法，允许您根据聊天ID和消息ID删除一条或多条消息。这是移除消息中图片的有效手段，因为它会彻底移除包含图片的原消息。
以下是实现此功能的详细步骤和示例代码：
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
1. 初始化Telethon客户端
首先，您需要使用您的API凭据初始化Telethon客户端。确保您已经从Telegram获取了api_id和api_hash。
from telethon.sync import TelegramClient
from telethon.tl.types import Message
# 替换为您的API凭据和手机号码
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER' # 首次运行时用于登录
client = TelegramClient('session_name', api_id, api_hash)2. 定义删除图片消息的函数
创建一个异步函数，该函数接收聊天ID和消息ID作为参数。在该函数内部，我们将执行以下操作：
- 通过client.get_messages获取指定的消息对象。
- 检查消息是否包含媒体（即图片或视频）。
- 如果包含媒体，则使用client.delete_messages删除该消息。
async def remove_image_from_message(chat_id: int | str, message_id: int):
"""
从指定聊天中删除包含图片的消息。
Args:
chat_id: 聊天ID（可以是整数或用户名字符串）。
message_id: 要删除的消息的ID。
"""
try:
# 获取指定的消息
message: Message = await client.get_messages(chat_id, ids=message_id)
if message and message.media:
# 如果消息存在且包含媒体（图片、视频等），则删除该消息
await client.delete_messages(chat_id, message_id)
print(f"消息 (ID: {message_id}) 中的图片已成功移除（消息已删除）。")
elif message and not message.media:
print(f"指定消息 (ID: {message_id}) 不包含图片或任何媒体。")
else:
print(f"未找到指定消息 (ID: {message_id})。")
except Exception as e:
print(f"删除图片消息时发生错误: {e}")3. 运行主程序
在main函数中启动客户端，调用remove_image_from_message函数，然后断开客户端连接。
async def main():
await client.start(phone_number)
# 替换为实际的聊天ID和消息ID
# chat_id 可以是整数（如群组ID）或字符串（如用户名 '@username'）
target_chat_id = 'YOUR_CHAT_ID'
target_message_id = 123 # 替换为包含图片的消息ID
await remove_image_from_message(target_chat_id, target_message_id)
await client.disconnect()
if __name__ == '__main__':
# 运行主异步函数
client.loop.run_until_complete(main())完整示例代码
from telethon.sync import TelegramClient
from telethon.tl.types import Message
# --- 配置信息 ---
# 替换为您的API凭据，可在 my.telegram.org 获取
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
# 您的手机号码，首次运行时用于登录
phone_number = 'YOUR_PHONE_NUMBER'
# 替换为实际的聊天ID和消息ID
# chat_id 可以是整数（如群组ID）或字符串（如用户名 '@username'）
TARGET_CHAT_ID = 'YOUR_CHAT_ID'
TARGET_MESSAGE_ID = 123 # 替换为包含图片的消息ID
# 初始化Telethon客户端
# 'session_name' 是会话文件的名称，用于保存登录状态
client = TelegramClient('session_name', api_id, api_hash)
async def remove_image_from_message(chat_id: int | str, message_id: int):
"""
从指定聊天中删除包含图片的消息。
如果消息存在且包含媒体，则删除该消息。
Args:
chat_id: 聊天ID（可以是整数或用户名字符串）。
message_id: 要删除的消息的ID。
"""
try:
# 获取指定的消息
# client.get_messages 返回一个消息列表，即使只请求一个ID
messages = await client.get_messages(chat_id, ids=message_id)
message: Message = messages[0] if messages else None
if message:
if message.media:
# 如果消息存在且包含媒体（图片、视频等），则删除该消息
await client.delete_messages(chat_id, message_id)
print(f"消息 (ID: {message_id}) 中的图片已成功移除（消息已删除）。")
else:
print(f"指定消息 (ID: {message_id}) 不包含图片或任何媒体。")
else:
print(f"未找到指定消息 (ID: {message_id})。")
except Exception as e:
print(f"删除图片消息时发生错误: {e}")
async def main():
"""
主函数，用于启动客户端并执行删除操作。
"""
print("正在启动Telethon客户端...")
await client.start(phone_number)
print("客户端已启动。")
await remove_image_from_message(TARGET_CHAT_ID, TARGET_MESSAGE_ID)
print("正在断开客户端连接...")
await client.disconnect()
print("客户端已断开。")
if __name__ == '__main__':
client.loop.run_until_complete(main())注意事项
- API凭据和权限： 确保您的api_id和api_hash是正确的，并且您的Telegram账户拥有删除消息的权限（例如，在群组中您必须是管理员）。
- 聊天ID和消息ID： 务必替换示例中的YOUR_CHAT_ID和YOUR_MESSAGE_ID为实际的数值。聊天ID可以是整数（对于私人聊天、群组或频道）或字符串（对于用户名，如@username）。消息ID可以通过检查消息的URL或使用Telethon的调试工具获取。
- 彻底删除： client.delete_messages操作是不可逆的，它会彻底从聊天中移除消息及其所有内容（包括文本和媒体）。
-
仅移除图片，保留文本： 如果您的需求是“仅移除图片但保留消息文本”，那么直接删除消息的方案可能不适用。在这种情况下，您需要执行一个更复杂的操作：
- 获取原始消息的文本内容。
- 删除原始消息。
- 重新发送一条只包含文本的新消息。 这种方法虽然可行，但会改变消息ID和时间戳。
总结
通过本教程，您应该已经掌握了使用Telethon从Telegram消息中删除图片的核心方法。关键在于理解event.edit与client.delete_messages之间的功能差异，并选择后者来达到彻底移除包含图片消息的目的。在实际应用中，请务必谨慎操作删除功能，并确保您的API凭据和目标ID准确无误。
