反馈建议提交指南
本文旨在帮助大家更高效地提交反馈，让问题更快被定位，产品更快跟进。
官方提供了一份简洁的模板：
【本次反馈为】需求建议 or Bug 反馈 or 使用问题
【具体描述】问题的现象及影响，并附上截图
但在实际排查问题时，光靠这个基础模板往往信息量不够，排查起来耗时较长。因此我整理了以下更完善的提交格式，希望能帮助大家更好地表述问题，让开发者更快接手。
推荐模板
【本次反馈为】
提供三种类型之一：需求建议 / Bug 反馈 / 使用问题
【简短描述】
建议用一两句话对需求或问题进行简要概括，方便后续关键字检索，帮助后来人快速判断是否已有相同反馈。
例：「多 Agent 协作时，开发 Agent 无法正常返回消息」
【基础信息】
- Loop 版本：（如 v0.x.x）
- Agent 运行时类型：（如 builtin / docker / 其他）
- 默认模型：（如 deepseek-v4 / gpt-4o 等）
- 操作系统 / 运行环境：（如 Windows 11 / macOS 14 / Linux）
【具体描述】
使用步骤详细描述如何复现问题，并提供相关 Agent 的活动日志截图及相关文档。
示例：Bug 反馈（多 Agent 协作失败）
本次反馈为： Bug 反馈
简短描述： 多 Agent 聊天频道中，发送任务后其中一个 Agent 不再响应
基础信息：
- Loop 版本：v1.0.2-rc.19
- Agent 运行时：内置运行时
- 默认模型：deepseek-v4
- 操作系统：Windows 10
具体描述：
步骤 1： 创建三个 Agent（开发、测试、项目负责人），角色配置：…
步骤 2： 创建一个聊天频道，将以上三个 Agent 加入。
步骤 3： 在聊天频道发布任务，任务内容如下：
我准备为我的openclaw添加一个可动桌面形象，以此为目标建立一个项目，openclaw是github的已有项目，https://github.com/openclaw/openclaw.git这是它的仓库地址，它已经有接入channel然后通过其他应用来进行交流的功能，但是我想要添加一个live2D模型实现的桌面小萝莉，可以点击互动、拖拽、并且直接和它对话，让它作为openclaw的真实形象来直接和我交流，运行环境是windows桌面应用。 @项目负责人 你是项目的主要负责人，负责接受我的安排并且规划设计该项目，带领其他agent一同完成此项目。 @开发 你是这个项目的开发人员，负责根据需求开发代码 @测试 你是这个项目的测试人员，负责对开发的代码进行测试，排查功能性问题和安全问题，并反馈开发同事进行修复。
步骤 4： 项目负责人首先回复并进行项目规划，然后发送给测试，等待开发返回
步骤 5： 此时开发 Agent 无法返回消息，时间点：12:39:49
开发 Agent 活动日志：
（插入截图）
步骤 4： 项目负责人首先回复并进行项目规划，然后发送给测试，等待开发返回
（插入截图）
步骤 5： 此时开发 Agent 无法返回消息，时间点：12:39:49
开发 Agent 活动日志：
最后一次返回的消息内容：
New message received:
[target=dm:@cp55e3nnr8d3 msg=238d41116948250c64abba2493490ed7 delivery=238d41116948250c64abba2493490ed7 time=2026-05-28T15:18:28+08:00]
@cp55e3nnr8d3: 我已经去除了代理，请重新测试一下 Electron 下载
[mode=turn_direct session=9729d7a2-1eda-451d-a34f-f5dacee8b0bb turn=241f35f3-2548-49ac-8c84-f362a087288e wake=7ce69c40c0c09b55d537ad42e77b70e7]
[freshness targetKey=dm_v2aanzkosonfdwinuz04 targetSeq=2]
Respond as appropriate. Complete all your work before stopping.
步骤 6： 继续与开发 Agent 交流，该 Agent 不再返回任何消息
Loop 运行日志（这里建议提交文档，我是windows，所以使用了loop j --tail 10）：
PS C:\Users\admin.loop\bin> .\loop.exe j --tail 10
time=2026-05-28T16:07:02.906+08:00 level=INFO msg=“merged loop agent update” agent_id=agt_actc04slb8xsqh4oaojt agent_name=测试 runtime=builtin
time=2026-05-28T16:07:02.909+08:00 level=INFO msg=“merged loop agent update” agent_id=agt_q75hpvpt1skq97ue9ama agent_name=项目负责人 runtime=builtin
time=2026-05-28T16:15:36.088+08:00 level=INFO msg=“Loop: agent:trajectory:history received” channel=chn_2AEGvnjLWuDn agent_id=agt_88d2ytx2z8w4pd0w61xs request_id=trajectory_history_1779956140679011431 limit=200 before=0
time=2026-05-28T16:18:31.589+08:00 level=INFO msg=“Loop: agent:workspace:list received” channel=chn_2AEGvnjLWuDn agent_id=agt_88d2ytx2z8w4pd0w61xs target_path=“” dir_path=“”
time=2026-05-28T16:18:31.789+08:00 level=INFO msg=“Loop: agent:workspace:list received” channel=chn_2AEGvnjLWuDn agent_id=agt_88d2ytx2z8w4pd0w61xs target_path=“” dir_path=state
time=2026-05-28T16:18:31.824+08:00 level=INFO msg=“Loop: agent:workspace:list received” channel=chn_2AEGvnjLWuDn agent_id=agt_88d2ytx2z8w4pd0w61xs target_path=“” dir_path=kb
time=2026-05-28T16:18:31.858+08:00 level=INFO msg=“Loop: agent:workspace:list received” channel=chn_2AEGvnjLWuDn agent_id=agt_88d2ytx2z8w4pd0w61xs target_path=“” dir_path=archive
time=2026-05-28T16:18:32.725+08:00 level=INFO msg=“Loop: agent:review:files received” channel=chn_2AEGvnjLWuDn agent_id=agt_88d2ytx2z8w4pd0w61xs request_id=review_files_1779956317321974715 scope=branch
time=2026-05-28T16:18:32.726+08:00 level=INFO msg=“Loop: agent:review:summary received” channel=chn_2AEGvnjLWuDn agent_id=agt_88d2ytx2z8w4pd0w61xs request_id=review_summary_1779956317323759379
time=2026-05-28T16:18:33.875+08:00 level=INFO msg=“Loop: agent:trajectory:history received” channel=chn_2AEGvnjLWuDn agent_id=agt_88d2ytx2z8w4pd0w61xs request_id=trajectory_history_1779956318472140131 limit=200 before=0
日志截图：
（插入截图）
提交检查清单
提交前可以快速过一遍，确保前置工作已做完和关键信息不遗漏：
- 在专栏里面找不到别人提供的类似BUG或者需求
- 通过Loop
- 反馈类型标注清楚
- 简短描述便于检索
- 版本 / 运行时 / 模型已填写
- 复现步骤清晰（有时间线和操作顺序）
- 有截图或日志文档（关键报错 / Agent 行为异常 / 日志条目）
- 预期结果与实际结果有对比
以上，祝大家提交的每一个反馈都能被快速处理