排错

常见 owlcoda doctor 警告、安装绊脚石、配置错误 —— 含义与解法。

出问题时 owlcoda doctor 是第一步。它检查 Node 版本、本地 runtime、proxy 端口、每个已配置的 model。

“Local runtime: not reachable” 警告（Day 0）

含义： config.json 里 routerUrl 指的本地 backend 没监听。

解法： 启动 Ollama (ollama serve)、LM Studio 本地 server、或 vLLM (vllm serve …)。然后重跑 owlcoda init 自动探测。或显式指定：

owlcoda init --router http://127.0.0.1:11434/v1

这条警告刻意不是 hard fail —— Day 0 你完全可以先装 OwlCoda，再装 backend。

含义： runtime 不可达（见上），或配置的 model id 与 backend 实际提供的对不上。

解法： 跑 owlcoda models 比较已配置 vs runtime 可见 model。如不一致，编辑 config.json 让 backendModel 与 backend 报告的一致。

含义： 全局 npm prefix 没写权限。三种 workaround 见安装 / 如果 npm link 失败。

含义： 另一个 OwlCoda daemon 在跑，或别的进程占着。

解法：

owlcoda status              # 看是不是我们的 daemon
owlcoda stop --force        # 停掉
lsof -i :8019               # 不是我们的话，找谁

或换 OwlCoda 的端口：

OWLCODA_PORT=8020 owlcoda

含义： OwlCoda 可选的 WebSearch 工具需要 SearXNG。如果不用 web search，忽略。

解法（如要 web search）： 本地装 SearXNG，设 OWLCODA_SEARXNG_URL=http://localhost:8888，重启 OwlCoda。

含义： shell 里设了 OWLCODA_TRAINING_COLLECTION=1，或 config.json 里 trainingCollection: true。

解法： unset + 清掉已收集的：

unset OWLCODA_TRAINING_COLLECTION
# config.json 里把 "trainingCollection" 改回 false
owlcoda training clear

ls -la ~/.owlcoda/sessions/

随便备份或删除。会话是 JSON；owlcoda sessions --json 直接读。