跳转至

排障快速索引

这里不再维护第二份重复正文。按症状选择入口,再到统一排障手册执行完整步骤。

按症状进入

现象 完整步骤
nanobot、Python 或 MkDocs 命令找不到 安装与 Python 环境
401、模型不可用、配置解析失败 配置、Provider 与模型
人格、规则、工作区或文件边界不对 Bootstrap 与工作区
Skill 不触发或依赖执行失败 Skill 排障
Telegram、Discord、Slack 不回复或等待配对 Channel、配对与 Gateway
WebUI 打不开、认证或端口异常 WebUI、端口与认证
容器挂载、权限、监听地址或日志异常 Docker 部署
Session、Memory、Consolidator 或 Dream 异常 记忆生命周期
严格构建、内部链接或 Hero 示例语法失败 文档与示例构建
准备向上游报告问题 提交 Issue 前的最小信息

不确定从哪里开始

先运行四个本地、只读检查:

1
2
3
4
nanobot --version
nanobot status
bash scripts/check-env.sh
bash scripts/verify-config.sh

不要打印或提交完整配置、环境文件、Token、配对码、Session 或 Memory。仍无法归类时,从统一排障手册的一分钟定位表开始。