fix: format src/gateway/server/ws-connection/message-handler.ts
This commit is contained in:
spiceoogway
parent
d2c1fd3c61
commit
b91099cd80
206
bug-report.md
Normal file
206
bug-report.md
Normal file
@ -0,0 +1,206 @@
|
||||
# Moltbot 空响应 Bug 报告
|
||||
|
||||
## 🐛 Bug 描述
|
||||
|
||||
Moltbot Gateway 在 WebChat 中显示空的 Assistant 响应，即使 API（OpenAI 和 Google Gemini）返回了正确的内容。
|
||||
|
||||
## 📊 症状
|
||||
|
||||
1. **WebChat 显示空响应**：
|
||||
- 只显示 "Assistant" 标签和时间戳
|
||||
- 没有任何文本内容
|
||||
- 按钮从 "Stop" 变成 "Send"，说明 agent 已完成
|
||||
|
||||
2. **日志显示成功**：
|
||||
- `embedded run done: aborted=false` ✅
|
||||
- 没有任何错误信息
|
||||
- Agent 正常完成运行
|
||||
|
||||
3. **API 返回正常**：
|
||||
- 直接测试 OpenAI API：返回 `insufficient_quota` 错误（配额问题）
|
||||
- 直接测试 Gemini API：返回正确的文本内容 ✅
|
||||
|
||||
## 🔬 测试证据
|
||||
|
||||
### Gemini 2.0 Flash 测试
|
||||
|
||||
**直接 API 调用**：
|
||||
```bash
|
||||
curl -x http://192.168.1.110:8899 \
|
||||
-H 'Content-Type: application/json' \
|
||||
-d '{"contents":[{"parts":[{"text":"你好，请用中文回复\"收到\""}]}]}' \
|
||||
"https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=AIzaSyCB..."
|
||||
```
|
||||
|
||||
**返回**：
|
||||
```json
|
||||
{
|
||||
"candidates": [{
|
||||
"content": {
|
||||
"parts": [{"text": "收到。\n"}],
|
||||
"role": "model"
|
||||
},
|
||||
"finishReason": "STOP"
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
✅ **API 返回了正确的内容："收到。"**
|
||||
|
||||
**Moltbot WebChat 测试**：
|
||||
- 发送消息："Gemini 2.0 测试：你好，请用中文回复\"收到\""
|
||||
- 结果：Assistant 回复为空（只显示标签和时间）
|
||||
- 日志：`embedded run done: durationMs=56381 aborted=false`
|
||||
|
||||
❌ **Moltbot 没有显示任何内容**
|
||||
|
||||
### OpenAI GPT-4o-mini 测试
|
||||
|
||||
**直接 API 调用**：
|
||||
```bash
|
||||
curl -x http://192.168.1.110:8899 \
|
||||
-H "Authorization: Bearer sk-proj-..." \
|
||||
-d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"你好"}]}'
|
||||
```
|
||||
|
||||
**返回**：
|
||||
```json
|
||||
{
|
||||
"error": {
|
||||
"message": "You exceeded your current quota",
|
||||
"type": "insufficient_quota"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
❌ **OpenAI 配额用完（这是预期的错误）**
|
||||
|
||||
**Moltbot WebChat 测试**：
|
||||
- 发送消息："OpenAI 配置成功测试：你好"
|
||||
- 结果：Assistant 回复为空
|
||||
- 日志：`embedded run done: durationMs=33063 aborted=false`
|
||||
|
||||
❌ **Moltbot 没有显示错误信息**
|
||||
|
||||
## 🔍 根本原因分析
|
||||
|
||||
### 问题 1：响应文本提取失败
|
||||
|
||||
Moltbot 的 `buildEmbeddedRunPayloads` 函数（`src/agents/pi-embedded-runner/run/payloads.ts`）负责从 API 响应中提取文本。
|
||||
|
||||
可能的原因：
|
||||
1. `assistantTexts` 数组为空
|
||||
2. `extractAssistantText()` 函数无法正确解析 Gemini 2.0 的响应格式
|
||||
3. 文本被 `shouldSuppressRawErrorText()` 或其他过滤器过滤掉了
|
||||
|
||||
### 问题 2：错误信息不显示
|
||||
|
||||
当 OpenAI 返回 `insufficient_quota` 错误时，Moltbot 应该：
|
||||
1. 检测到 API 错误
|
||||
2. 在 WebChat 中显示友好的错误信息
|
||||
3. 提示用户检查 API 配额
|
||||
|
||||
但实际上，Moltbot 只是返回空响应，没有任何错误提示。
|
||||
|
||||
## 🛠️ 复现步骤
|
||||
|
||||
### 环境
|
||||
- Moltbot 版本：2026.1.27-beta.1
|
||||
- 部署方式：Docker Compose
|
||||
- 操作系统：Synology NAS (Linux)
|
||||
- 代理：mihomo (http://192.168.1.110:8899)
|
||||
|
||||
### 配置
|
||||
|
||||
**moltbot.json**：
|
||||
```json
|
||||
{
|
||||
"agents": {
|
||||
"defaults": {
|
||||
"model": {
|
||||
"primary": "google/gemini-2.0-flash"
|
||||
},
|
||||
"models": {
|
||||
"google/gemini-2.0-flash": {},
|
||||
"openai/gpt-4o-mini": {}
|
||||
}
|
||||
}
|
||||
},
|
||||
"env": {
|
||||
"GOOGLE_API_KEY": "AIzaSyCB-kAc2xCTwLAVBBmGs6Up7NKAg03PQ5Q",
|
||||
"HTTP_PROXY": "http://192.168.1.110:8899",
|
||||
"HTTPS_PROXY": "http://192.168.1.110:8899"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**auth-profiles.json**：
|
||||
```json
|
||||
{
|
||||
"version": 1,
|
||||
"profiles": {
|
||||
"google:default": {
|
||||
"type": "api_key",
|
||||
"provider": "google",
|
||||
"key": "AIzaSyCB-kAc2xCTwLAVBBmGs6Up7NKAg03PQ5Q"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 复现步骤
|
||||
|
||||
1. 配置 Moltbot 使用 `google/gemini-2.0-flash` 模型
|
||||
2. 在 WebChat 中发送任意消息
|
||||
3. 观察 Assistant 回复为空
|
||||
4. 检查日志：`embedded run done: aborted=false`（成功完成）
|
||||
5. 直接测试 Gemini API：返回正确内容
|
||||
|
||||
## 💡 建议修复
|
||||
|
||||
### 1. 改进响应解析
|
||||
|
||||
在 `src/agents/pi-embedded-runner/run/payloads.ts` 中：
|
||||
- 添加调试日志，记录 `assistantTexts` 的内容
|
||||
- 检查 `extractAssistantText()` 是否正确处理 Gemini 2.0 的响应格式
|
||||
- 确保文本不会被意外过滤
|
||||
|
||||
### 2. 改进错误处理
|
||||
|
||||
当 API 返回错误时：
|
||||
- 检测错误类型（quota, rate_limit, invalid_key 等）
|
||||
- 在 WebChat 中显示友好的错误信息
|
||||
- 提供可操作的建议（如"请检查 API 配额"）
|
||||
|
||||
### 3. 添加诊断工具
|
||||
|
||||
- 在 WebChat 中添加"显示原始响应"选项
|
||||
- 在日志中记录 API 响应的完整内容
|
||||
- 提供调试模式，显示响应解析的每个步骤
|
||||
|
||||
## 📝 相关文件
|
||||
|
||||
- `src/agents/pi-embedded-runner/run.ts` - Agent 运行逻辑
|
||||
- `src/agents/pi-embedded-runner/run/payloads.ts` - 响应解析逻辑
|
||||
- `src/agents/pi-embedded-subscribe.ts` - 响应订阅和文本提取
|
||||
- `src/agents/pi-embedded-utils.ts` - 文本提取工具函数
|
||||
|
||||
## 🔗 相关 Issue
|
||||
|
||||
- 这个 bug 影响所有使用 Gemini 2.0 和 OpenAI 的用户
|
||||
- 可能与 Gemini 3.0 的空响应问题相关
|
||||
- 需要检查 Moltbot 对不同 API 版本的兼容性
|
||||
|
||||
## ✅ 临时解决方案
|
||||
|
||||
目前没有有效的解决方案。建议：
|
||||
1. 等待 Moltbot 官方修复
|
||||
2. 或者使用其他支持良好的模型（如 Claude）
|
||||
3. 向 OpenClaw 项目提交 Issue
|
||||
|
||||
---
|
||||
|
||||
**报告时间**: 2026-01-30 16:55
|
||||
**报告人**: Kiro AI Assistant
|
||||
**严重程度**: 高（核心功能无法使用）
|
||||
**影响范围**: Gemini 2.0, OpenAI, 可能还有其他 provider
|
||||
1
openclaw
Submodule
1
openclaw
Submodule
@ -0,0 +1 @@
|
||||
Subproject commit 40632e727f2d5473a1e79e14739c41ee6647388c
|
||||
@ -681,7 +681,7 @@ export function attachGatewayWsMessageHandler(params: {
|
||||
instructions: {
|
||||
list: "openclaw devices list",
|
||||
approve: `openclaw devices approve ${pairing.request.requestId}`,
|
||||
}
|
||||
},
|
||||
},
|
||||
}),
|
||||
});
|
||||
|
||||
Loading…
Reference in New Issue
Block a user