数据来源: openclaw/openclaw GitHub Issues 报告时间: 2026-03-10 数据窗口: 2026-03-03 ~ 2026-03-10 (基于 updated_at) Issues 总数: 10,413
一、总体概览
| 指标 | 数值 |
|---|---|
| Issues 总数 | 10,413 |
| Open | 3,420 (32.8%) |
| Closed | 6,993 (67.2%) |
| 本周新增 (created since 03-03) | 2,905 |
| 有 Label | 6,255 (60.1%) |
| 无 Label | 4,158 (39.9%) |
| 有 Assignee | 244 (2.3%) |
| 无 Assignee | 10,169 (97.7%) |
| Regression 标记 | 461 |
| Stale 标记 | 1,120 |
分类汇总
| 分类 | 总数 | Open | Closed | Open 比例 |
|---|---|---|---|---|
| Bug | 8,077 | 2,660 | 5,417 | 32.9% |
| Feature | 1,657 | 541 | 1,116 | 32.6% |
| Other | 337 | 72 | 265 | 21.4% |
| Maintenance | 178 | 70 | 108 | 39.3% |
| Question | 100 | 52 | 48 | 52.0% |
| Documentation | 64 | 25 | 39 | 39.1% |
Top 20 Labels
| Label | 数量 |
|---|---|
| bug | 4,116 |
| enhancement | 1,441 |
| stale | 1,120 |
| regression | 461 |
| bug:behavior | 298 |
| r: support | 163 |
| security | 91 |
| question | 48 |
| bug:crash | 46 |
| tui | 33 |
| dedupe:parent | 24 |
| close:invalid | 16 |
| maintainer | 15 |
| dedupe:child | 14 |
| r: testflight | 14 |
| close:duplicate | 12 |
| invalid | 9 |
| app: web-ui | 7 |
| r: skill | 6 |
| cannot-reproduce | 6 |
二、Bug 分类深度分析 (8,077 个)
Bug 是最主要的问题类型，占总量的 77.6%。以下按子分类分析：
2.1 Agent/会话系统 (~1,972 个)
最大的问题领域。涉及 Agent 生命周期、会话管理、上下文压缩、子Agent 协作等。
代表性问题:
- #41673 - embedded run agent end: LLM request timed out
- #41879 - isHeartbeatEnabledForAgent 忽略 agents.defaults.heartbeat 配置
- #41555 - Opus 模型陷入推理循环，/new 不够用，需切换模型
- #41695 - 子Agent 继承请求者的 workspace 而非自身配置的 workspace
- #38491 - 压缩前 write durable facts 覆盖工作区文件 (MEMORY.md 被破坏)
关键主题: 会话压缩数据丢失、子Agent 配置隔离不足、LLM 请求超时、会话状态污染
2.2 工具调用 (~1,327 个)
exec/browser/web_search/skill 等工具的执行问题。
代表性问题:
- #41839 - MiniMax M2.5 工具调用无效——XML 工具调用被剥离而非执行
- #41412 - write tool 拒绝符号链接并报 sandbox root 错误（即使 sandbox: off）
- #41335 - 会话工具注册表损坏——工具使用一次后变为 "not found"
- #41720 - exec 和 web_fetch 在 macOS 上无限挂起
关键主题: 工具格式兼容性、沙箱权限、工具注册表损坏、工具执行超时
2.3 模型/Provider (~1,249 个)
模型配置、Provider 适配、API 兼容性问题。
代表性问题:
- #41644 - 所有问题返回 '400 Model do not support image input'（纯文本也报错）
- #41690 - Config validation failed: 无法识别 requiresOpenAiAnthropicToolPayload 键
- #41852 - kimi-coding provider 强制 OpenAI 工具格式，破坏 Kimi k2p5 tool_use
- #41871 - 本地 Ollama 模型在 2026.3.8 中仍然挂起
- #41870 - PI SDK ModelRegistry 忽略 Kilocode provider 的环境变量
关键主题: Kimi/OpenAI 工具格式冲突、Ollama 超时、模型配置验证失败、多 Provider 兼容
2.4 Gateway/网关 (~1,064 个)
网关进程管理、启停、LaunchAgent、进程泄漏等。
代表性问题:
- #41845 - macOS gateway start/restart 在 gateway stop 卸载 LaunchAgent 后失败
- #41804 - Windows 计划任务运行时 Gateway 持久化 Stale 进程
- #41829 - CLI 错误报告 'Gateway service not loaded'（实际正在运行）
- #6413 - CRITICAL: Gateway 进程巨大虚拟内存泄漏 (22GB+)
关键主题: macOS LaunchAgent 不稳定、Windows 进程孤儿、内存泄漏、启停可靠性
2.5 配置/验证 (~939 个)
配置文件解析、验证、认证问题。
代表性问题:
- #41690 - 配置验证失败: 无法识别的 key
- #41652 - v2026.2.26 持续报 device-id-mismatch 错误
- #40582 - workspaceAccess: "ro" 挂载沙箱目录而非配置的 workspace
- #7254 - auth-profiles.json 不支持环境变量替换
2.6 内存/性能 (~675 个)
OOM、超时、挂起、性能退化问题。
代表性问题:
- #41778 - openclaw-message 在 4GB 服务器上 OOM（自 v2026.3.7）
- #41789 - 上下文修剪跳过含图像的工具结果，导致截图密集会话上下文溢出
- #11890 - WebChat UI 在大会话上冻结——同步 Markdown 渲染 200 条消息阻塞主线程
- #13624 - 自动压缩死亡螺旋: 转录过大无法压缩时恢复失败
2.7 安装/部署 (~655 个)
安装脚本、Docker、npm、平台兼容性问题。
代表性问题:
- #41828 - Docker install failed
- #41819 - 安装时 node-llama-cpp 构建失败 (无 GPU 支持)
- #41706 - Windows Hyper-V VM 安装失败: 预编译二进制不兼容
- #41797 - 安装脚本在无 winget 的 Windows LTSC 上强制退出 PowerShell
2.8 消息通道 Bug 汇总
| 通道 | Bug 数量 | 代表性问题 |
|---|---|---|
| Telegram | 624 | 消息路由错误、流式传输退化、DM 投递失败、重复消息 |
| Discord | 296 | 线程会话上下文污染、WebSocket 断连、按钮状态异常 |
| 192 | TTS 格式错误、DNS 故障后永久退出、配对消息泄露 | |
| Slack | 183 | Channel binding 被忽略、流式停止时丢失响应 |
| Feishu/飞书 | 181 | 卡片渲染 Bug、插件工具未暴露、多账号 Token 隔离 |
| macOS/iOS App | 88 | Companion app 断连不自动重连、iOS Crash |
| iMessage/BlueBubbles | 86 | 插件加载失败、附件路径被安全策略阻断 |
| Mattermost | 36 | 健康监控检测不到聋 WebSocket |
| Google Chat | 36 | DM 线程断裂、Webhook 事件未接收 |
2.9 Cron/定时任务 (~617 个)
代表性问题:
- #41798 - Cron isolated session 在 v2026.3.8 中不执行
- #41405 - Cron jobs 在 2026.3.8 中静默中断——无执行、无错误
- #41843 - openclaw crontab set 覆盖已有条目无警告
- #41783 - job timeout 包含了 cron-lane 队列等待时间
2.10 UI/UX (~638 个)
代表性问题:
- #41801 - Webchat UI: 图片上传后作为文本发送
- #41755 - 流式传输期间刷新页面后 Chat 按钮状态未恢复
- #40695 - Dashboard 返回 "Not Found"
- #41746 - 粘贴图片发送后图片数据丢失
三、Feature 需求分析 (1,657 个)
| 子分类 | 数量 | 说明 |
|---|---|---|
| 记忆/Memory | 307 | 会话记忆持久化、自动保存、跨会话记忆共享 |
| 消息通道增强 | 302 | 各通道功能增强(文件上传、Reaction、语音消息等) |
| Agent/多Agent | 234 | 多 Agent 协作、子 Agent 编排、Agent 间通信 |
| 模型/Provider | 217 | 新模型支持、Provider 配置灵活性 |
| 工具增强 | 216 | 新工具、工具配置、MCP 支持、Skill 增强 |
| Cron/自动化 | 152 | Cron 生命周期 hooks、超时控制、自动化流程 |
| 配置/系统 | 135 | 热加载配置、备份恢复、Docker 多架构支持 |
| UI/UX 改进 | 100 | WebChat/Control UI/TUI 功能增强 |
| 搜索/Web | 73 | 搜索 Provider 扩展(Tavily、SearXNG、Brave) |
| Voice/TTS/STT | 71 | 语音模式、ElevenLabs 支持、实时语音 |
| 安全/权限 | 62 | 细粒度权限、沙箱配置、路径级 RWX |
| 国际化/社区 | 62 | 中文支持、社区交流群(大量微信群推广帖) |
| iOS/Android/移动 | 44 | TestFlight 请求、Android 原生支持、移动 SDK |
高票Feature 代表:
- #41548 - 统一的跨通道消息同步 (TUI, Telegram, iMessage)
- #41833 - 原生承诺/延迟任务原语，含完成跟踪和升级
- #6842 - A2A (Agent-to-Agent) 协议支持
- #23353 - 支持 Anthropic 原生服务端工具 (web_search, web_fetch, code_execution)
- #75 - Linux/Windows Clawdbot Apps (37 评论)
四、Question (100 个)
主要来源:
- 飞书交流群转发 (~30个): 大量 "飞书openclaw交流群" 自动收集的讨论帖
- 使用指南/How-to (~25个): 如何部署、配置、使用特定功能
- 架构/设计讨论 (~15个): 多 Agent 编排最佳实践、压缩策略、Token 管理
- 环境配置 (~15个): Azure OpenAI 配置、WSL 设置、Proxy 配置
- 功能行为澄清 (~15个): 特定功能的预期行为确认
五、Documentation (64 个)
- 中文文档/翻译 (~15个): 中文文档需求、翻译贡献
- API/配置文档 (~12个): SecretRef、cron 配置 schema、参数文档
- 通道集成文档 (~10个): Feishu/Slack/WhatsApp 集成指南
- 安全通告 (~5个): 恶意 Skill 报告、安全漏洞说明
- 其他 (~22个): 部署指南、功能说明、迁移文档
六、Maintenance (178 个)
- 测试/Test issues (~40个): 大量测试性质 issues (test, ManualTest 等)
- CI/CD 改进 (~35个): 构建、部署流程优化
- 安全加固 (~15个): 恶意 Skill 报告处理、安全加固
- 重构 (~10个): 会话文件清理、配置验证增强
- 社区/运维 (~78个): 混合了各类运维问题和社区互动
七、Other (337 个)
未被分类规则命中的 issues，包含:
- 无法分类的 bug（标题不含关键词）
- 撤回/无效的 issues
- 混合类型的问题
八、关键风险与趋势
8.1 Regression 问题 (461 个)
版本回归是最需要关注的质量问题。主要集中在:
| 版本 | 回归类型 |
|---|---|
| v2026.3.8 | Cron 任务不执行、ACP sessions_spawn 失败、Telegram 流式退化 |
| v2026.3.7 | openclaw-message OOM、Feishu 消息停收 |
| v2026.2.26 | device-id-mismatch、5秒输入延迟 |
| v2026.3.2 | Windows 图片路径安全错误、Telegram 健康监控风暴 |
近期高影响 Regression:
- #41798 - v2026.3.8 Cron 隔离会话不执行
- #41707 - 升级后涉及工具的操作无限重复
- #41014 - 按 Enter 到发送 LLM 的 5 秒固定延迟
- #41581 - Telegram DM 流式从平滑预览退化为卡顿的 editMessageText
- #41801 - Webchat UI 图片上传后作为文本发送
8.2 Stale Issues (1,120 个)
超过 10% 的 issues 被标记为 stale，表明存在大量未处理的积压问题。
8.3 热门讨论 Issues (高评论数)
| Issue | 评论数 | 标题 |
|---|---|---|
| #3460 | 95 | 国际化 (i18n) 和本地化支持 |
| #4111 | 53 | Antigravity 版本不再支持 |
| #32828 | 47 | 所有模型误报 'API rate limit reached' |
| #75 | 37 | Linux/Windows Clawdbot Apps |
| #2697 | 33 | Claude Code CLI OAuth 认证失败 |
| #26534 | 30 | 添加钉钉作为首次安装通道选项 |
| #34810 | 29 | OpenClaw 突然失去文件系统工具 |
| #39651 | 29 | 只会说话不会工作 |
8.4 Assignee 缺失严重
97.7% 的 issues 无 assignee，说明问题分配和跟踪机制不足。
九、建议优先级
P0 - 紧急修复
- v2026.3.8 Cron 回归: Cron 任务完全不执行 (#41798, #41405, #41266)
- 工具无限循环: 升级后工具调用无限重复 (#41707)
- OOM 崩溃: openclaw-message 在 4GB 服务器 OOM (#41778)
- Gateway 内存泄漏: 22GB+ 虚拟内存泄漏 (#6413)
P1 - 高优先级
- Telegram 消息路由错误: 回复被路由到 Web UI 而非源通道 (#41726, #41739)
- macOS Gateway 稳定性: LaunchAgent 重启不稳定 (#41315, #41845)
- Kimi/MiniMax 工具格式: Provider 工具格式不兼容 (#41852, #41839)
- 配置验证: 无法识别的配置键导致启动失败 (#41690, #41445)
- 图片上传失效: Webchat 图片上传后数据丢失 (#41801, #41746)
P2 - 中优先级
-
压缩数据丢失: 上下文压缩导致关键信息/文件丢失
-
Windows 安装: 多个 Windows 平台安装失败
-
Discord WebSocket 断连: 频繁断连影响使用体验
-
中文社区需求: i18n、中文文档、社区建设
