Sửa lỗi

Khi Bestie có vấn đề, bắt đầu bằng Doctor:

bestie doctor

Setup

Không có lệnh bestie

Kiểm tra file link:

ls ~/.local/bin/bestie

Nếu có file nhưng shell không nhận, thêm ~/.local/bin vào PATH.

Thiếu config

Chạy lại onboarding:

bestie onboard

Nếu provider đang lỗi hoặc muốn setup offline:

bestie onboard --skip-provider-test

.env permission không an toàn

bestie doctor --fix

--fix chỉ sửa lỗi local an toàn, không ghi đè config, prompt hoặc secrets.

Provider

Timeout

Tăng timeout nếu provider chậm:

{
  "llm": {
    "timeoutMs": 120000
  }
}

Auth failed

Kiểm tra:

• API key trong .bestie/.env.
• Tên biến trong llm.apiKeyEnv.
• Quyền/quota của tài khoản provider.

Không paste API key vào issue, screenshot hoặc chat.

Telegram

Nếu bot không trả lời:

• Kiểm tra BESTIE_TELEGRAM_BOT_TOKEN trong .bestie/.env.
• Kiểm tra ownerUserId đúng Telegram user id.
• Đảm bảo đang nhắn từ owner account.
• Đảm bảo bestie telegram đang chạy.

bestie doctor
bestie doctor --telegram-connect

Non-owner bị ignore là hành vi đúng.

Memory

Kiểm tra memory:

bestie memory status
bestie memory list

Nếu memory bị pause:

bestie memory resume

Nếu policy là ask, memory có thể đang chờ duyệt:

bestie memory pending

Sửa hoặc quên memory sai:

bestie memory inspect 1
bestie memory edit 1 "Updated memory text."
bestie memory forget 1

MCP/tools

MCP tool phải được phân loại trước khi gọi read-only:

bestie mcp list
bestie mcp show dry-run
bestie mcp classify dry-run read_file --category read

Nếu output có secrets, dừng lại và coi đó là bug. Bestie phải redact secret-like values trong logs, Doctor report và channel summaries.