一句话结论
提交时把现象、操作步骤、完整日志、脱敏后的 .env 发到 zhemuy@gmail.com，比一句跑不起来更好定位。
适用场景
- OpenClaw 怎么也跑不起来
- Codex 或 Claude Code 报错看不懂
- Telegram Bot 或 API 调用一直失败
常见现象
- 终端一片红
- 面板打不开
- Bot 没反应、API 一直报错
原因解释
- 环境差异（系统、Node、Docker、网络）
- .env 配置缺漏
- 模型或中转站不稳
解决步骤
- 操作步骤按时间顺序写清楚，从命令到现象
- 复制完整日志，尤其是最后 50 行
- 把 .env 脱敏后贴上来，Key 用 sk-*** 这种格式
- 说明你已经试过哪些办法
- 把以上内容发到 zhemuy@gmail.com
仍然不行怎么办
- 实在写不清楚，录一段一分钟视频，连同截图一起发到 zhemuy@gmail.com
小白先准备什么
- 把报错截图或终端日志复制下来，至少保留最后 50 行。
- 记录你执行了什么命令、在什么系统上、什么时间开始出错。
- 把 .env 文件复制一份，Key 用 sk-***、Token 用 tok-*** 替换真实值。
- 列出你已经试过的办法（重启、重装、换 Key 等），避免重复排查。
验收标准
- 提交的信息能让排错人员在 10 分钟内定位到问题层级（环境/配置/网络/模型）
- 日志里没有暴露真实 API Key、Token 或密码
- 操作步骤按时间顺序写清楚，能复现问题
最有用的 6 类材料
- 完整报错：从命令开始到最后一行，不要只截图最后半句。
- 运行环境：系统、Node / Docker / Python 版本、是否用了代理或 VPN。
- 配置脱敏版：BASE_URL、模型名、端口、Bot username、项目路径，Key 和 Token 打码。
- 最近改动：今天改过哪些文件、升级过哪些工具、换过哪些 Key。
- 复现步骤：先点哪里、再输什么、什么时候报错。
- 期望结果：你本来希望它打开页面、回复消息、跑通构建，还是完成部署。
哪些情况要先别继续折腾
- 已经连续重装三次还失败：先保留当前日志，别再覆盖现场。
- 涉及生产账号、客户数据、余额、付款、数据库：先备份并说明影响范围。
- 网络运维场景中会影响门店或公司上网：先约维护窗口。
- Agent 要求你粘贴完整 API Key、Cookie、SSH 密码：先停，改成脱敏或临时 Key。
- 同一个错误反复出现但每次改不同配置：先回到最近一次能运行的状态。
可复制提交模板
【排错协助提交】
1. 工具：OpenClaw / Codex / Claude Code / Telegram Bot / 其他
2. 系统：macOS / Windows / Linux / Docker
3. 现象：{一句话描述，例如「启动后面板白屏」}
4. 操作步骤：
- 第 1 步：{你做了什么}
- 第 2 步：{你做了什么}
- 出错时间：{大约几点}
5. 完整日志（最后 50 行）：
{粘贴日志}
6. .env 脱敏版：
BASE_URL=https://xxx
API_KEY=sk-***
7. 已尝试：
- {试过什么，结果如何}
8. 联系方式：{微信/Telegram/邮箱}
常见误区和不适合场景
- 误区：只说「跑不起来」不贴日志 → 没有日志等于盲猜
- 误区：把完整 API Key 贴在邮件里 → 必须脱敏
- 误区：同时改了三个配置再来问 → 一次只改一个变量才能定位
- 不适合：需要全新项目搭建的需求（应走定制入口）
- 不适合：模型回答质量不满意（应走 Prompt 调优，不是排错）
还卡着？
可以把截图、日志、需求单或当前页面链接发到 zhemuy@gmail.com。