octop脚本默认日志路径为~/.octop/logs/，每次运行生成带时间戳的log文件，如octop_install_20260916_142218.log；可通过tail -n 50 $(ls -t ~/.octop/logs/*.log | head -n1)快速查看最近一次末尾50行。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

安装失败时，日志是定位问题的第一手线索。Octop 一键脚本默认会创建隔离的 Python 环境（用 uv），所有运行过程和错误都会输出到终端，但关键的是它还会把详细日志写入本地文件。

默认日志路径在哪

Octop 脚本运行时生成的日志默认保存在用户主目录下的 ~/.octop/logs/ 目录中：

• 每次执行 octop run 或安装脚本，都会生成一个带时间戳的 log 文件，例如 octop_install_20260916_142218.log
• 如果脚本中途退出，最后几行通常包含报错原因，比如网络超时、权限拒绝、依赖下载失败等
• SQLite 初始化失败、端口被占用、数据库目录不可写等问题，也会记录在此处

快速查看最近一次安装日志

打开终端，直接执行：

ls -t ~/.octop/logs/ | head -n1 | xargs cat ~/.octop/logs/

或者更稳妥地：

腾讯云文字识别（通用高精度版）

腾讯云通用文字识别（高精度版）技能包。用户发送/粘贴图片、提供图片URL或要求识别图片文字时自动调用。支持中文、英文、中英混合、数字及特殊符号的检测与识别，返回文字框位置与内容。适用于文字较多、版式复杂、准召率要求高的场景。

下载

tail -n 50 $(ls -t ~/.octop/logs/*.log | head -n1)

这能快速看到最近一次安装/启动的末尾 50 行，往往就是失败的关键提示。

常见报错对应检查点

根据已知部署反馈，以下几类错误高频出现，可对照日志关键词排查：

• "Permission denied: '~/.octop'" → 检查用户对 ~/.octop 目录是否有读写权限，尤其在 root 下安装后切回普通用户运行时容易出这个问题
• "Address already in use: 8088" → 端口被占，改端口启动：OCTOP_PORT=8090 octop run
• "Failed to fetch model list" 或 "Unauthorized" from provider → 大模型 API Key 未配置或无效，检查 ~/.octop/config.yaml 中的 llm.provider 和 llm.api_key
• "harness-agent not found" 或 "ModuleNotFoundError" → 说明底层闭源依赖未正确拉取，可能因网络问题中断；可手动清空 ~/.cache/uv 后重试

启用更详细输出（调试模式）

重新运行安装或启动命令时，加上环境变量开启调试日志：

DEBUG=1 OCTOP_LOG_LEVEL=debug octop run

此时控制台会打印完整调用栈和组件初始化细节，适合配合日志文件交叉比对。