日志中心

日志中心用于在 WebUI 中查看 Nekro Agent 的运行日志。它适合排查部署、适配器、模型调用、插件、工作区和沙盒相关问题。

日志可能包含敏感信息

排查问题时请注意日志中的频道名、用户信息、请求地址、报错上下文等内容。公开求助前建议先脱敏。

日志中心能做什么

功能	说明
查看历史日志	回看最近的运行记录和错误信息
按来源筛选	只看某类模块或服务输出
实时日志流	页面打开后持续观察新日志
下载日志	将日志文件保存下来用于反馈或归档
结合等级排查	根据 INFO、WARNING、ERROR 等等级定位问题

什么时候看日志

以下情况建议打开日志中心：

• Bot 不回复，但适配器显示在线
• 模型调用失败、超时或返回异常
• 插件命令执行失败
• 工作区或 Claude Code 沙盒启动失败
• 知识库上传、向量化或检索异常
• WebUI 页面提示未知错误

日志等级怎么看

等级	含义	建议
DEBUG	详细调试信息	仅排查时临时开启
INFO	正常运行信息	日常观察即可
WARNING	可能影响功能的问题	如果频繁出现，建议检查配置
ERROR	功能执行失败	优先处理
CRITICAL	严重异常	需要尽快排查服务状态

如果需要更详细日志，可以在「系统配置」中调整 APP_LOG_LEVEL。排查完成后建议恢复为默认级别，避免日志过多。

排查建议

适配器连接问题

先筛选或搜索适配器名称，例如 OneBot、Telegram、Discord、飞书、企业微信等。重点关注：

• 鉴权失败
• Webhook 地址错误
• 网络连接失败
• 消息解析失败

模型调用问题

搜索模型组名称、Base URL 或错误关键词。常见原因包括：

• API Key 错误或额度不足
• Base URL 不兼容
• 模型名称填写错误
• 请求超时
• 上游服务限流

工作区和沙盒问题

如果工作区任务失败，先看工作区页面提示，再到日志中心搜索 workspace、sandbox、Claude Code 等关键词。

常见原因包括镜像拉取失败、端口范围不足、沙盒启动超时、工作区路径异常等。

插件问题

插件相关错误通常会包含插件名称或命令名称。排查时可以先临时禁用最近新增或刚更新的插件，确认问题范围。

下载日志并反馈

向社区或开发者反馈问题时，建议同时提供：

1. 问题发生的大致时间
2. 对应日志片段
3. 使用的适配器和部署方式
4. 最近是否更新过版本或修改配置

请在发送前删除密钥、Token、Cookie、内网地址等敏感信息。

相关配置

日志相关配置见 高级配置。常用配置包括：

• APP_LOG_LEVEL
• SAVE_PROMPTS_LOG
• DEBUG_IN_CHAT

相关文档

• 仪表盘
• 高级配置
• 常见问题解答