[Bug] qq_offical 定时任务中 send_message_to_user 工具调用失败："请求参数msg_id无效或越权"

[naer-lily]

What happened / 发生了什么

在定时任务（cron job）环境中调用 send_message_to_user 工具时，工具执行失败并抛出 botpy.errors.ServerError: 请求参数msg_id无效或越权 异常。该错误发生在 qq_offical 的消息发送流程中。

我注意到在 http://localhost:6185/#/cron页面右上角有提示 主动发送结果仅支持以下您已配置的平台：qq_official(QQ) / webchat(webchat)，这似乎是说 qq_offical 本身是支持这个功能的？但文档 https://docs.astrbot.app/use/proactive-agent.html 中又并没有提到qq_offical……

Reproduce / 如何复现？

1. 让AI 2分钟后连续调用2次send_message_to_user工具
2. 2分钟后，观察到没有任何输出
3. 检查控制台日志，发现上述报错

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

4.20.1 Docker Deepseek/deepseek-reasoner qq_offical

OS

Linux

Logs / 报错日志

[2026-03-19 12:32:41.708] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['create_future_task']

[2026-03-19 12:32:41.709] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：create_future_task，参数：{'run_at': '2026-03-19T12:34:00+08:00', 'note': '2分钟后连续调用2次send_message_to_user工具测试。\n\n执行以下操作：\n1. 调用send_message_to_user工具，发送消息："第一条测试消息：定时任务执行时间 2026-03-19 12:34:00"\n2. 再次调用send_message_to_user工具，发送消息："第二条测试消息：连续调用测试完成"\n\n确保两条消息都能发送成功。', 'name': '连续调用send_message_to_user测试', 'run_once': True}

[2026-03-19 12:32:42.100] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `create_future_task` Result: Scheduled future task 67533b27-696c-4aeb-ae77-2d433c65e15a (连续调用send_message_to_user测试) one-time at 2026-03-19 12:34:00+08:00.

[2026-03-19 12:32:51.889] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['send_message_to_user']

[2026-03-19 12:32:51.890] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：send_message_to_user，参数：{'messages': [{'type': 'plain', 'text': '那尔ちゃん，我已经设置好了定时任务。\n\n**任务详情：**\n- **任务ID**: 67533b27-696c-4aeb-ae77-2d433c65e15a\n- **执行时间**: 2分钟后（2026-03-19 12:34:00 CST）\n- **执行内容**: 连续调用2次send_message_to_user工具\n- **任务类型**: 一次性执行（run_once=true）\n\n（轻声）我会在12:34准时执行测试，然后向你汇报结果。如果到时没有收到消息，可能工具确实有问题，我们就能进一步排查了。'}]}

[2026-03-19 12:32:54.899] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `send_message_to_user` Result: Message sent to session QQ:FriendMessage:1F92E5124D83FC64DFE2A0EC30FA5EA1

[2026-03-19 12:33:09.136] [Core] [INFO] [result_decorate.stage:189]: 流式输出已启用，跳过结果装饰阶段

[2026-03-19 12:34:08.159] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['send_message_to_user']

[2026-03-19 12:34:08.159] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：send_message_to_user，参数：{'messages': [{'type': 'plain', 'text': '第一条测试消息：定时任务执行时间 2026-03-19 12:34:00'}]}

[2026-03-19 12:34:08.354] [Core] [WARN] [v4.20.1] [runners.tool_loop_agent_runner:858]: Traceback (most recent call last):
  File "/AstrBot/astrbot/core/agent/runners/tool_loop_agent_runner.py", line 757, in _handle_function_tools
    async for resp in executor:  # type: ignore
  File "/AstrBot/astrbot/core/astr_agent_tool_exec.py", line 175, in execute
    async for r in cls._execute_local(tool, run_context, **tool_args):
  File "/AstrBot/astrbot/core/astr_agent_tool_exec.py", line 596, in _execute_local
    resp = await asyncio.wait_for(
           ^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.12/asyncio/tasks.py", line 520, in wait_for
    return await fut
           ^^^^^^^^^
  File "/AstrBot/astrbot/core/astr_agent_tool_exec.py", line 737, in call_local_llm_tool
    ret = await ready_to_call
          ^^^^^^^^^^^^^^^^^^^
  File "/AstrBot/astrbot/core/astr_main_agent_resources.py", line 385, in call
    await context.context.context.send_message(
  File "/AstrBot/astrbot/core/star/context.py", line 456, in send_message
    await platform.send_by_session(session, message_chain)
  File "/AstrBot/astrbot/core/platform/sources/qqofficial/qqofficial_platform_adapter.py", line 144, in send_by_session
    await self._send_by_session_common(session, message_chain)
  File "/AstrBot/astrbot/core/platform/sources/qqofficial/qqofficial_platform_adapter.py", line 287, in _send_by_session_common
    ret = await QQOfficialMessageEvent.post_c2c_message(
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/AstrBot/astrbot/core/platform/sources/qqofficial/qqofficial_message_event.py", line 566, in post_c2c_message
    result = await self.bot.api._http.request(route, json=payload)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.12/site-packages/botpy/http.py", line 190, in request
    return await _handle_response(response)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.12/site-packages/botpy/http.py", line 85, in _handle_response
    raise ServerError(message) from None  # adding from None to prevent chain exception being raised
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
botpy.errors.ServerError: 请求参数msg_id无效或越权

[2026-03-19 12:34:08.355] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `send_message_to_user` Result: error: 请求参数msg_id无效或越权

[2026-03-19 12:34:13.214] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['send_message_to_user']

[2026-03-19 12:34:13.214] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：send_message_to_user，参数：{'messages': [{'type': 'plain', 'text': '第二条测试消息：连续调用测试完成'}]}

[2026-03-19 12:34:13.744] [Core] [WARN] [v4.20.1] [runners.tool_loop_agent_runner:858]: Traceback (most recent call last):
  File "/AstrBot/astrbot/core/agent/runners/tool_loop_agent_runner.py", line 757, in _handle_function_tools
    async for resp in executor:  # type: ignore
  File "/AstrBot/astrbot/core/astr_agent_tool_exec.py", line 175, in execute
    async for r in cls._execute_local(tool, run_context, **tool_args):
  File "/AstrBot/astrbot/core/astr_agent_tool_exec.py", line 596, in _execute_local
    resp = await asyncio.wait_for(
           ^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.12/asyncio/tasks.py", line 520, in wait_for
    return await fut
           ^^^^^^^^^
  File "/AstrBot/astrbot/core/astr_agent_tool_exec.py", line 737, in call_local_llm_tool
    ret = await ready_to_call
          ^^^^^^^^^^^^^^^^^^^
  File "/AstrBot/astrbot/core/astr_main_agent_resources.py", line 385, in call
    await context.context.context.send_message(
  File "/AstrBot/astrbot/core/star/context.py", line 456, in send_message
    await platform.send_by_session(session, message_chain)
  File "/AstrBot/astrbot/core/platform/sources/qqofficial/qqofficial_platform_adapter.py", line 144, in send_by_session
    await self._send_by_session_common(session, message_chain)
  File "/AstrBot/astrbot/core/platform/sources/qqofficial/qqofficial_platform_adapter.py", line 287, in _send_by_session_common
    ret = await QQOfficialMessageEvent.post_c2c_message(
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/AstrBot/astrbot/core/platform/sources/qqofficial/qqofficial_message_event.py", line 566, in post_c2c_message
    result = await self.bot.api._http.request(route, json=payload)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.12/site-packages/botpy/http.py", line 190, in request
    return await _handle_response(response)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.12/site-packages/botpy/http.py", line 85, in _handle_response
    raise ServerError(message) from None  # adding from None to prevent chain exception being raised
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
botpy.errors.ServerError: 请求参数msg_id无效或越权

[2026-03-19 12:34:13.745] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `send_message_to_user` Result: error: 请求参数msg_id无效或越权

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

Hi @V-YOP! I'm Dosu and I’m helping the AstrBot team.

这个问题的根本原因是 QQ 官方机器人 API 的架构限制 —— 它主要设计为"被动回复"模式，而非"主动推送"模式。

核心原因分析：

1. msg_id 时效性问题：QQ 官方 API 的 msg_id 来自用户发送的消息，每个 msg_id 在 5 分钟内最多只能回复 4 条消息。你的日志显示第一条消息在 12:32:51 成功发送（此时使用的是刚收到的用户消息的 msg_id），但定时任务在 12:34:08 执行时，原始 msg_id 很可能已经超时失效。

2. 定时任务的 msg_id 机制：QQ Official 适配器使用缓存的 msg_id 发送消息。当定时任务执行时，它会复用上次与该用户交互时缓存的 msg_id —— 但这个 msg_id 在 2 分钟后已过期或使用次数已耗尽。

3. 主动消息功能受限：QQ 官方机器人 API 对主动消息发送有严格限制，普通机器人可能无法使用真正的主动推送功能，必须依赖有效的 msg_id 进行"被动回复"。

关于管理页面的提示：管理页面显示 qq_official 支持主动发送是因为代码层面确实实现了 send_message_to_user，但它依赖缓存的 msg_id，而非真正的主动消息 API。这是一个 UI 提示与实际能力不完全匹配的问题。

可能的解决方向：

• 考虑使用其他支持真正主动消息的平台（如 Telegram、Discord）进行定时推送
• 或等待 AstrBot 后续版本改进 qq_official 对过期 msg_id 的处理逻辑

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

  

[naer-lily]

@dosu 我的环境是私聊，我尝试在/AstrBot/astrbot/core/platform/sources/qqofficial/qqofficial_platform_adapter.py line 287，ret = await QQOfficialMessageEvent.post_c2c_message( 的上一行增加一行代码 payload.pop("msg_id", None)，发现这样的话10分钟后的定时任务也能成功返回消息了。是否是说这个不能主动推送，是群聊的限制而非私聊的限制？

日志见下（虽然大概没啥意义）：

[2026-03-19 13:10:45.985] [Core] [INFO] [core.event_bus:66]: [default] [QQ(qq_official)] 1F92E5124D83FC64DFE2A0EC30FA5EA1: [At:qq_official] 2分钟后连续调用2次send_message_to_user工具 

[2026-03-19 13:10:46.139] [Core] [INFO] [respond.stage:184]: Prepare to send - /1F92E5124D83FC64DFE2A0EC30FA5EA1: 

[2026-03-19 13:10:46.139] [Core] [INFO] [respond.stage:200]: 应用流式输出(QQ)

[2026-03-19 13:10:57.518] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['create_future_task']

[2026-03-19 13:10:57.519] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：create_future_task，参数：{'run_at': '2026-03-19T13:12:00+08:00', 'note': '2分钟后（13:12）连续调用2次send_message_to_user工具测试定时任务的消息发送功能。\n\n执行步骤：\n1. 调用send_message_to_user工具，发送消息："定时任务测试消息1：时间 2026-03-19 13:12:00"\n2. 等待短暂间隔后，再次调用send_message_to_user工具，发送消息："定时任务测试消息2：连续调用测试"\n\n记录执行结果和可能的错误信息，用于分析定时任务中send_message_to_user工具的问题。', 'name': '定时任务send_message_to_user工具测试', 'run_once': True}

[2026-03-19 13:10:57.751] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `create_future_task` Result: Scheduled future task 7286088a-6b26-49c6-a607-c07584bef173 (定时任务send_message_to_user工具测试) one-time at 2026-03-19 13:12:00+08:00.

[2026-03-19 13:11:06.949] [Core] [INFO] [result_decorate.stage:189]: 流式输出已启用，跳过结果装饰阶段

[2026-03-19 13:12:14.642] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['send_message_to_user']

[2026-03-19 13:12:14.642] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：send_message_to_user，参数：{'messages': [{'type': 'plain', 'text': '定时任务测试消息1：时间 2026-03-19 13:12:00'}]}

[2026-03-19 13:12:16.509] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `send_message_to_user` Result: Message sent to session QQ:FriendMessage:1F92E5124D83FC64DFE2A0EC30FA5EA1

[2026-03-19 13:12:21.148] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['send_message_to_user']

[2026-03-19 13:12:21.148] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：send_message_to_user，参数：{'messages': [{'type': 'plain', 'text': '定时任务测试消息2：连续调用测试'}]}

[2026-03-19 13:12:22.276] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `send_message_to_user` Result: Message sent to session QQ:FriendMessage:1F92E5124D83FC64DFE2A0EC30FA5EA1

[2026-03-19 13:12:57.437] [Core] [INFO] [core.event_bus:66]: [default] [QQ(qq_official)] 1F92E5124D83FC64DFE2A0EC30FA5EA1: [At:qq_official] 测试成功了，再测试10分钟后连续调用2次send_message_to_user工具 

[2026-03-19 13:12:57.588] [Core] [INFO] [respond.stage:184]: Prepare to send - /1F92E5124D83FC64DFE2A0EC30FA5EA1: 

[2026-03-19 13:12:57.588] [Core] [INFO] [respond.stage:200]: 应用流式输出(QQ)

[2026-03-19 13:13:10.395] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['create_future_task']

[2026-03-19 13:13:10.395] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：create_future_task，参数：{'run_at': '2026-03-19T13:22:00+08:00', 'note': '10分钟后（13:22）连续调用2次send_message_to_user工具进行进一步测试。\n\n执行步骤：\n1. 调用send_message_to_user工具，发送消息："10分钟后测试消息1：时间 2026-03-19 13:22:00"\n2. 再次调用send_message_to_user工具，发送消息："10分钟后测试消息2：连续调用验证"\n\n测试定时任务环境下send_message_to_user工具的稳定性和可靠性。', 'name': '10分钟后send_message_to_user工具测试', 'run_once': True}

[2026-03-19 13:13:11.337] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `create_future_task` Result: Scheduled future task 215da7c4-d975-4033-9a6c-beaeaa2fee97 (10分钟后send_message_to_user工具测试) one-time at 2026-03-19 13:22:00+08:00.

[2026-03-19 13:13:21.409] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['send_message_to_user']

[2026-03-19 13:13:21.409] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：send_message_to_user，参数：{'messages': [{'type': 'plain', 'text': '那尔ちゃん，定时任务已经设置好了。\n\n**任务详情：**\n- **任务ID**: 215da7c4-d975-4033-9a6c-beaeaa2fee97\n- **执行时间**: 10分钟后（2026-03-19 13:22:00 CST）\n- **执行内容**: 连续调用2次send_message_to_user工具\n- **任务类型**: 一次性执行\n\n（轻声）这次的测试是为了验证定时任务环境下消息发送功能的稳定性。我会在13:22准时执行测试，然后向你汇报结果。'}]}

[2026-03-19 13:13:22.805] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `send_message_to_user` Result: Message sent to session QQ:FriendMessage:1F92E5124D83FC64DFE2A0EC30FA5EA1

[2026-03-19 13:13:29.923] [Core] [INFO] [result_decorate.stage:189]: 流式输出已启用，跳过结果装饰阶段

[2026-03-19 13:22:06.505] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['send_message_to_user']

[2026-03-19 13:22:06.505] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：send_message_to_user，参数：{'messages': [{'type': 'plain', 'text': '10分钟后测试消息1：时间 2026-03-19 13:22:00'}]}

[2026-03-19 13:22:07.562] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `send_message_to_user` Result: Message sent to session QQ:FriendMessage:1F92E5124D83FC64DFE2A0EC30FA5EA1

[2026-03-19 13:22:11.225] [Core] [INFO] [runners.tool_loop_agent_runner:657]: Agent 使用工具: ['send_message_to_user']

[2026-03-19 13:22:11.225] [Core] [INFO] [runners.tool_loop_agent_runner:703]: 使用工具：send_message_to_user，参数：{'messages': [{'type': 'plain', 'text': '10分钟后测试消息2：连续调用验证'}]}

[2026-03-19 13:22:12.316] [Core] [INFO] [runners.tool_loop_agent_runner:881]: Tool `send_message_to_user` Result: Message sent to session QQ:FriendMessage:1F92E5124D83FC64DFE2A0EC30FA5EA1

[dosubot]

你的发现非常有价值！确实，在私聊场景下移除 msg_id 后可以成功发送主动消息。

根据代码分析，这确实是 QQ 官方 API 私聊和群聊的一个重要差异：

• 代码中已经为媒体消息（视频/文件）实现了移除 msg_id 的逻辑，注释明确说明是为了避免"越权"错误
• 但普通文本消息在私聊场景下没有做同样的处理

你的测试表明：私聊 C2C 的文本消息也可以不带 msg_id 主动发送，而群聊可能仍需要 msg_id。这看起来是 QQ 官方 API 对私聊放宽了限制。

建议：可以考虑提交一个 PR，在 _send_by_session_common 方法中，针对私聊场景（FriendMessage）也移除 msg_id，而不是在没有缓存 msg_id 时直接跳过发送。这样可以解决私聊定时任务的主动消息问题。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

  

[DBJD-CR]

群聊中也会存在这种情况吗？相同的修改是否也可以应用于群聊中的主动消息？

[naer-lily]

群聊中也会存在这种情况吗？相同的修改是否也可以应用于群聊中的主动消息？

呃我没有测试过，我主要是私聊使用的，我检查 https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/send-receive/send.html 发现沙箱环境是没有频控限制的，可以任意地发送主动消息 2026/03/05 能力更新说明 沙箱环境内，机器人发送消息不受频控策略影响。

尝试测试发现群聊的机器人好像暂时没法创建？系统维护中，非企业认证的开发者账号暂时无法修改‘群’的沙箱环境配置

[NayukiChiba]

最新的issue#6670也出现了这个问题

[jueshali]

#6856 可以试试我这个pr