本页覆盖 middleware.py 的导入方式、senderID 来源、同步错误处理和常见返回体。
导入方式
from middleware import Sender, getSenderID
sender = Sender(getSenderID())
getSenderID() 从运行时参数读取当前运行上下文 ID。消息触发、路由触发、cron / fake 上下文都会由 autClaw 注入运行时凭据；插件不要自行拼接 /api/plugins/runtime 地址。
常用返回值
SendReceipt
文本、媒体和撤回类方法通常返回发送回执。
{
"ok": true,
"message_id": "123456",
"messageid": "123456",
"message_ids": ["123456"],
"raw": {},
"action": "sendText"
}
receipt.get("ok") is False，消息 ID 同时兼容 message_id 和 messageid。
FileDownloadResult
fileDownload(...) 和 downloadAdapterFile(...) 返回本地文件信息。
{
"path": "/opt/autclaw/file/demo.png",
"file_path": "/opt/autclaw/file/demo.png",
"file_name": "demo.png",
"mime_type": "image/png",
"file_size": 12345
}
sender.getMediaItems() 返回当前事件或最近一次 listen(...) / input(...) 捕获到的媒体项。
{
"type": "file",
"source": "...",
"name": "report.csv",
"mime_type": "text/csv",
}
downloadAdapterFile(...)，不要手动解析平台原始字段。
WaitPaySuccess
waitPay(...) 支付成功时返回支付事件对象；超时返回字符串 "timeout"，繁忙返回 "busy"。
{
"payment_channel": "alipay",
"received_amount": "19.80",
"expected_amount": 19.8,
"amount_matched": true,
"order_id": "pay_demo"
}
错误处理
Python SDK 同步返回数据。运行时请求失败、必填参数为空或依赖安装失败时会抛出 Exception。
try:
receipt = sender.replyImage("./result.png")
if receipt.get("ok") is False:
sender.reply("图片发送失败，请稍后重试。")
except Exception as error:
print(error)
sender.reply("处理失败，请联系管理员查看日志。")
下一步
Last modified on June 3, 2026
