Hermes LibraryDiagnosis Sistem
Hermes AI Agent Tak Jalan? Semak Ini Dahulu
Jangan ubah banyak perkara serentak. Kenal pasti lapisan yang gagal: sambungan VPS, proses Hermes, model AI, gateway Telegram atau workflow.
Uji sistem dari bawah ke atas: boleh SSH ke server, process Hermes hidup, model AI memberi respons, kemudian barulah uji Telegram dan workflow. Simpan mesej ralat sebenar sebelum restart atau mengubah konfigurasi.
Urutan diagnosis lima lapisan
- Sambungan VPSPastikan IP, username, password atau SSH key betul dan server berada dalam status aktif.
- Process HermesSemak sama ada service sedang berjalan, berhenti atau restart berulang kali.
- Model AIUji credential, billing, model name dan rangkaian tanpa melibatkan Telegram.
- Gateway TelegramSahkan token bot, user ID, whitelist dan connection log.
- Workflow atau skillUji satu tugasan kecil dan asingkan tool yang menyebabkan kegagalan.
Peta simptom dan tindakan pertama
| Simptom | Punca yang mungkin | Tindakan pertama |
|---|---|---|
| SSH gagal | IP, OpenSSH, firewall atau credential | Semak panel VPS dan cuba sambungan asas |
| Command Hermes tidak dikenali | Installer tidak selesai atau shell belum reload | Buka sesi terminal baharu dan semak arahan rasmi |
| Model error | API key, billing, model name atau rate limit | Semak dashboard provider dan mesej ralat penuh |
| Telegram bot diam | Token, gateway, whitelist atau service | Uji Hermes dari terminal kemudian semak log Telegram |
| Jawapan terlalu lemah | Model, prompt atau konteks tidak mencukupi | Uji arahan jelas dengan objektif dan format output |
| Usage cepat habis | Scheduler kerap atau prompt terlalu besar | Pause job dan audit penggunaan API |
SSH tidak boleh masuk
Semak sama ada VPS aktif, IP tidak berubah dan port SSH tidak disekat. Jika anda baru membuat server, tunggu proses provisioning selesai. Password yang ditaip tidak kelihatan pada terminal dan itu bukan tanda input gagal.
Elakkan mencuba password terlalu banyak sehingga IP disekat. Gunakan console web provider untuk memulihkan akses jika perlu.
Hermes dipasang tetapi command gagal
Buka shell baharu, semak hasil installer dan cari mesej error terdahulu. Pastikan anda menggunakan user dan environment yang sama semasa pemasangan. Jangan jalankan semula installer berkali-kali tanpa membaca log kerana ia boleh mengaburkan punca sebenar.
Model AI tidak memberi respons
- Sahkan API key belum tamat atau di-rotate.
- Pastikan akaun provider mempunyai billing atau quota.
- Semak nama model dan endpoint yang dikonfigurasi.
- Uji prompt pendek untuk membezakan masalah model daripada masalah workflow.
- Perhatikan rate limit dan error rangkaian.
Selepas restart, Hermes terus berhenti
Semak service manager dan startup configuration. Pastikan environment variable tersedia kepada service, bukan hanya dalam sesi terminal manual. Log selepas reboot biasanya menunjukkan sama ada masalah datang daripada credential, path atau resource server.
Bila perlu restore backup?
Restore hanya apabila anda tahu konfigurasi semasa rosak dan backup datang daripada keadaan yang pernah berfungsi. Simpan salinan konfigurasi semasa dahulu. Jangan restore secret lama yang telah di-rotate atau token yang sudah dibatalkan.
Periksa repositori dan issues rasmi Hermes Agent untuk perubahan release serta masalah yang sedang diketahui. Untuk isu portal pembeli Hermes Library, gunakan support@aihermesagent.my.