[BUG]: Gmail agent API key bug/parser

快速结论：该报错通常出现在 AnythingLLM 桌面版配置 Gmail agent 时，API Key 中包含特殊字符（如 @）或末尾存在换行符/空格，导致 API 身份验证失败，返回 401 Unauthorized 错误。优先排查 API Key 是否包含特殊字符或不可见空白字符，并重新部署。

问题场景

用户在 AnythingLLM 桌面版（Windows 11）中，按照官方文档配置 Gmail agent 后，尝试搜索邮件时失败。LLM 提供商为 Ollama（模型 llama3.1:8b），嵌入器模型同为 llama3.1:8b。Gmail agent 的 Apps Script 已正确部署，但工具调用 gmail-get-inbox 始终返回 401 错误。

报错原文

"Unauthorized" error (401)
gmail-get-inbox fails

原因分析

可能原因：

API Key 中包含特殊字符（如 @），虽然官方开发者测试并未复现此问题，但用户报告在移除 @ 后问题解决。
API Key 复制时末尾可能包含不可见的换行符或空格，导致实际传入的密码与部署的 Apps Script 密码不匹配。
注意：401 错误明确表示服务端已成功连接，但身份验证密码错误，因此不需要排查网络或工具配置问题。

环境排查

AnythingLLM 桌面版 v1.14.0（最新版）
Windows 11
Ollama + llama3.1:8b
Gmail agent 部署状态（确认已部署且 API Key 已正确粘贴到 AnythingLLM 设置中）

解决步骤

打开 AnythingLLM 的 Gmail agent 配置面板，检查已粘贴的 API Key。
可优先尝试：移除 API Key 中的所有特殊字符（如 @、#、$ 等），仅使用字母和数字。
同时清除 API Key 字段中可能存在的首尾空格或换行符（建议在记事本中重新输入纯文本密码后复制粘贴）。
在 Google Apps Script 端使用相同的新密码（不含特殊字符）重新部署 Gmail agent。
在 AnythingLLM 中保存配置并重启 Gmail agent。

验证方法

尝试在 AnythingLLM 中再次调用 gmail-get-inbox 搜索邮件，如果不再返回 401 错误，说明问题已解决。也可以先在 Google Apps Script 的测试功能中验证 API Key 的正确性。

参考来源

Mintplex-Labs/anything-llm #5832

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

[BUG]: Gmail agent API key bug/parser