# Cara Menghubungkan Hermes Agent ke Telegram dan Mengurus Tugas dari Telefon

> Persediaan langkah demi langkah: cipta bot melalui BotFather, masukkan token dan senarai akses dalam Hermes Agent, kemudian mulakan gateway. Mesej suara, tugas berjadual dan kawalan melalui telefon.

Source: https://ailoot.ai/blog/ms/hermes-agent-telegram-setup/
Canonical: https://ailoot.ai/blog/ms/hermes-agent-telegram-setup/
Language: ms
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-118
Revision: sha256-1fbb00f41d2c2c3b855eb1fc9bc1ed1cd6d8199b3af6d4ddf90cab9f8ee7609b


Anda boleh menghantar mesej kepada Hermes Agent atau mendiktekan tugas kepadanya dalam Telegram melalui telefon apabila anda jauh dari komputer, dan menerima hasilnya dalam sembang yang sama. Hasil tugas berjadual akan dihantar ke sembang yang anda tetapkan sebagai sembang utama sekali sahaja.

Jika anda belum mempunyai Hermes, mulakan dengan panduan tentang [apa itu ejen ini dan cara memasangnya](https://ailoot.ai/blog/ms/hermes-agent-install-setup/), kemudian kembali untuk menghubungkan Telegram.

Arahan tambahan tersedia dalam [dokumentasi Ailoot](https://ailoot.ai/docs/).

## Apakah yang diperlukan untuk menghubungkan Hermes Agent ke Telegram?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Perkara penting dalam bahagian ini">

Perkara penting

Anda memerlukan Hermes Agent yang telah dipasang dan disambungkan kepada model, serta akaun Telegram. Mencipta bot dalam Telegram adalah percuma, dan Hermes ialah projek sumber terbuka. Kos berasingan mungkin dikenakan untuk model, pengecaman pertuturan awan dan pelayan jika anda memilih untuk membiarkan bot berjalan sepanjang masa.

</div>

Perintah `hermes doctor` memeriksa pemasangan Hermes dan sambungan model anda. Kita akan mencipta bot dalam aplikasi Telegram, dan anda memerlukan komputer untuk menjalankan perintah di terminal.

## Bagaimanakah cara mencipta bot melalui BotFather?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Perkara penting dalam bahagian ini">

Perkara penting

Buka @BotFather dalam Telegram, hantar /newbot, pilih nama paparan dan nama pengguna unik yang berakhir dengan `bot`. BotFather akan membalas dengan token dalam bentuk 123456789:ABCdef... — inilah kunci kepada bot anda. Simpannya dan jangan tunjukkan kepada sesiapa.

</div>

Setiap bot Telegram mempunyai token — kunci rahsia untuk mengawal bot. Token ini dikeluarkan oleh bot rasmi Telegram, @BotFather.

1.  ### Buka @BotFather

    Cari `@BotFather` dalam Telegram atau buka [t.me/BotFather](https://t.me/BotFather). BotFather yang sebenar mempunyai tanda pengesahan biru. Mulakan perbualan dengan mengetik “Start”.

2.  ### Hantar perintah /newbot

    BotFather akan meminta dua nama. Nama pertama ialah nama paparan; anda boleh memilih apa-apa nama, contohnya “Ejen Saya”. Nama kedua ialah nama pengguna: nama ini mesti unik dan berakhir dengan `bot`, contohnya `moy_agent_bot`.

3.  ### Dapatkan token

    BotFather akan menghantar mesej tahniah dan rentetan panjang dalam bentuk `123456789:ABCdefGHIjklMNOpqrSTUvwxYZ`. Inilah token bot. Salin keseluruhan rentetan itu.

<div class="aside" data-semantic="callout" role="note" aria-label="Perhatian">

Perhatian

Token memberikan kawalan penuh terhadap bot: sesiapa yang mengetahui token itu boleh mengawal bot. Jika token bocor, batalkannya serta-merta dengan perintah `/revoke` dalam perbualan anda dengan BotFather dan dapatkan token baharu.

</div>

Ada juga cara pantas yang tidak memerlukan perbualan manual dengan BotFather. Dalam papan pemuka web Hermes (`hermes dashboard`) dan aplikasi desktop, pada halaman “Messaging → Telegram”, terdapat butang “Create with QR”: imbas kod itu dengan telefon anda, dan Hermes akan mencipta bot, mengesan ID anda, menyimpan token dalam tetapan serta memulakan semula gateway. Langkah di bawah menerangkan kaedah manual; jika anda memilih QR, teruskan ke langkah menyemak sambungan.

## Bagaimanakah cara mencari ID Telegram anda, dan mengapa anda memerlukannya?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Perkara penting dalam bahagian ini">

Perkara penting

Cari ID Telegram angka anda. Inilah nombor akaun anda; nama pengguna dengan tanda @ tidak akan berfungsi dalam senarai akses. Hermes menggunakan ID tersebut untuk senarai akses: tanpa senarai ini, gateway tidak akan membalas sesiapa, termasuk anda.

</div>

Akaun Telegram mempunyai dua pengecam: nama pengguna awam dengan tanda @ dan ID angka dalaman. Hermes menggunakan nombor tersebut.

Catatkan nombor itu bersama token.



## Bagaimanakah cara memberikan token kepada Hermes Agent dan memulakan gateway?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Perkara penting dalam bahagian ini">

Perkara penting

Jalankan wizard persediaan dengan `hermes gateway setup` dan pilih Telegram: wizard itu akan meminta token dan ID anda, kemudian menyimpan semuanya. Kaedah manual menggunakan dua baris dalam fail `~/.hermes/.env`. Selepas itu, mulakan gateway dengan `hermes gateway`, dan bot akan beroperasi dalam beberapa saat.

</div>

|  | Wizard persediaan | Secara manual |
|----|----|----|
| Perkara yang dijalankan | `hermes gateway setup` | Editor dengan fail `~/.hermes/.env` |
| Perkara yang dimasukkan | Token dan ID sebagai jawapan kepada gesaan wizard | Dua pemboleh ubah secara manual |
| Lokasi simpanan | Wizard menyimpannya sendiri dalam tetapan | Tetapan dimasukkan terus ke dalam `.env` |
| Untuk siapa | Semua orang; kaedah yang disyorkan | Mereka yang biasa mengurus konfigurasi atau membuat persediaan dengan skrip |

1.  ### Jalankan wizard persediaan

    ```bash
    hermes gateway setup
    ```

    Jalankan perintah ini pada mesin tempat Hermes dipasang. Wizard akan memaparkan senarai aplikasi pemesejan.

2.  ### Pilih Telegram dan masukkan butiran anda

    Wizard akan meminta token bot dan ID yang dibenarkan (anda boleh memasukkan beberapa ID, dipisahkan dengan koma) lalu menyimpan semuanya sendiri dalam tetapan.

3.  ### Mulakan gateway

    ```bash
    hermes gateway
    ```

    Gateway akan bermula dan bersambung ke Telegram. Selepas beberapa saat, hantar apa-apa mesej kepada bot melalui aplikasi: jika Hermes membalas, sambungan itu sudah sedia.

Kaedah manual sebagai ganti wizard adalah seperti berikut: buka fail `~/.hermes/.env` dan tambah dua baris, gantikan nilainya dengan token daripada BotFather dan ID angka anda:

```bash
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789
```

Baris kedua membenarkan orang itu dalam sembang peribadi dan kumpulan; kebenaran sembang kumpulan berasingan juga boleh memberikan akses. Pisahkan beberapa orang dengan koma. Selepas menyimpan fail, mulakan gateway dengan perintah `hermes gateway` yang sama.

Jika bot terus senyap walaupun dalam sembang peribadi, semak log gateway dalam terminal yang sama dan pastikan dahulu token serta ID anda dalam senarai akses adalah betul; ralat lain diterangkan dalam jadual di hujung artikel.

## Apakah yang boleh dilakukan oleh bot Telegram pada telefon anda?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Perkara penting dalam bahagian ini">

Perkara penting

Bot Telegram membaca mesej teks dan suara, menerima fail dan gambar, meminta kebenaran sebelum menjalankan perintah berbahaya terus dalam sembang, serta memaparkan pilihan model sebagai butang. Secara lalai, hanya pemberitahuan untuk jawapan akhir, permintaan pengesahan dan pengesahan perintah mempunyai bunyi.

</div>

Terdapat lima keupayaan yang paling kerap anda perlukan pada telefon.

**Mesej teks dan suara.** Taip tugas dengan perkataan atau rakam mesej suara — jika pengecaman pertuturan telah dikonfigurasikan, Hermes akan mentranskripsikan dan memahaminya. Dengan penyedia tempatan, tiada kunci diperlukan; semuanya diproses pada mesin tempat ejen berjalan.

**Fail dan gambar.** Anda boleh memajukan dokumen, hamparan atau tangkapan skrin kepada bot — ejen akan menerimanya sebagai lampiran. Ejen juga boleh menghantar fail yang dijana kepada anda: minta laporan, dan ejen akan menghantarnya sebagai fail dalam sembang.

**Pengesahan untuk tindakan berbahaya.** Apabila ejen hendak melakukan sesuatu yang berisiko, seperti memadam fail, ejen akan bertanya dahulu dalam sembang: balas “yes” atau “y” untuk meneruskannya; balas “no” atau “n” untuk membatalkannya.

**Butang sebagai ganti menaip balasan.** Apabila ejen memerlukan penjelasan, ejen menghantar soalan dengan butang pilihan sebaris — ketik satu pilihan dan ejen akan meneruskan kerja. Perintah `/model` tanpa argumen memaparkan menu pemilihan model dengan butang yang sama.

**Pemberitahuan senyap.** Secara lalai, telefon anda hanya berbunyi untuk jawapan akhir, permintaan pengesahan dan pengesahan perintah. Pemberitahuan perkhidmatan seperti “memanggil alat” dan “memampatkan konteks” tiba tanpa bunyi, jadi telefon tidak berbunyi pada setiap langkah. Jika anda mahu pemberitahuan berbunyi pada setiap langkah, tukar mod dalam tetapan.

## Bagaimanakah cara mendapatkan hasil tugas latar belakang dalam sembang?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Perkara penting dalam bahagian ini">

Perkara penting

Tugas berjadual menghantar hasil ke sembang utama: buka perbualan dengan bot dan hantar perintah `/sethome`. Tugas latar belakang yang dimulakan daripada topik akan menghantar jawapannya kembali ke topik yang sama. Syarat utamanya ialah gateway mesti terus berjalan; jika tidak, bot akan senyap apabila komputer dimatikan.

</div>

**Sembang utama untuk tugas berjadual.** Hermes menyokong tugas berjadual: “setiap pagi pada 7:43, sediakan ringkasan untuk saya”. Hasilnya dihantar ke sembang utama, yang anda tetapkan sekali dengan menghantar perintah `/sethome` terus dalam perbualan dengan bot. Selagi gateway berjalan, ringkasan akan tiba secara automatik.

**Tugas latar belakang.** Anda boleh menghantar tugas yang panjang untuk dijalankan di latar belakang dan meneruskan urusan harian anda: bot akan menghantar mesej apabila tugas itu siap. Tugas yang dimulakan daripada topik akan menghantar jawapannya kembali ke topik yang sama supaya tiada apa-apa yang hilang.

Had penting: bot hanya membalas semasa gateway berjalan. Jika anda mematikan atau meletakkan komputer yang menjalankan Hermes dalam mod tidur, bot tidak akan membalas sehingga mesin itu berjalan semula. Untuk memastikan bot sentiasa dalam talian, pindahkan ejen ke pelayan: kami mempunyai panduan berasingan tentang [cara memastikan Hermes Agent berjalan sepanjang masa](https://ailoot.ai/blog/ms/hermes-agent-vps-24-7/). Secara lalai, gateway mengundi Telegram untuk mendapatkan mesej baharu; bagi platform awan yang masuk ke mod tidur apabila tiada trafik masuk, dokumentasi menawarkan mod webhook, yang membalikkan arah sambungan supaya Telegram sendiri menghantar permintaan kepada bot.

## Bagaimanakah cara menghalang orang asing daripada mengakses bot?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Perkara penting dalam bahagian ini">

Perkara penting

`TELEGRAM_ALLOWED_USERS` membenarkan ID penghantar tersenarai dalam sembang peribadi dan kumpulan. Akses kumpulan juga boleh diberikan secara berasingan: `TELEGRAM_GROUP_ALLOWED_CHATS` membenarkan setiap ahli kumpulan yang disenaraikan. Rahsiakan token; jika bocor, batalkan melalui `/revoke` dengan BotFather. Penapis sebutan mengawal bila bot membalas, bukan siapa mempunyai akses.

</div>

Bot anda boleh ditemukan melalui nama penggunanya dalam carian Telegram, jadi perlindungan bergantung pada dua perkara: senarai akses dan kerahsiaan token.

Pertama, konfigurasikan akses penghantar dengan `TELEGRAM_ALLOWED_USERS`. Untuk kumpulan, periksa juga `TELEGRAM_GROUP_ALLOWED_CHATS`: menyenaraikan sembang di situ membenarkan mana-mana ahlinya, walaupun ID penghantar tiada dalam senarai benarkan peribadi. Senarai peribadi kosong sahaja tidak membuktikan semua kumpulan tertutup.

Kedua, terdapat token. Token tidak boleh muncul dalam tangkapan skrin, mesej yang dimajukan atau repositori. Jika token bocor, batalkannya dengan perintah `/revoke` dalam BotFather. Kemudian masukkan token baharu dalam tetapan dan mulakan semula gateway.

Nota berasingan tentang kumpulan: kebenaran penghantar dan kebenaran sembang ialah perkara berbeza. Ahli kumpulan yang dibenarkan melalui `TELEGRAM_GROUP_ALLOWED_CHATS` boleh menggunakan bot walaupun IDnya tiada dalam `TELEGRAM_ALLOWED_USERS`. Jika akses mesti kekal individu, jangan berikan akses kepada seluruh kumpulan; konfigurasikan dan sahkan sekatan penghantar untuk versi dipasang. Jika anda mahu bot hanya membalas dalam kumpulan apabila dipanggil, terdapat tetapan `telegram.require_mention` — bot kemudian akan membalas sebutan @, balasan kepada mesejnya, perintah seperti `/command@yourbot` dan padanan dengan corak anda dalam `telegram.mention_patterns`, sambil mengabaikan mesej kumpulan biasa.

## Mengapa bot senyap dalam kumpulan, dan bagaimanakah cara membetulkannya?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Perkara penting dalam bahagian ini">

Perkara penting

Puncanya ialah mod privasi Telegram: secara lalai, bot dalam kumpulan hanya melihat perintah dan balasan kepada mesejnya sendiri. Matikannya melalui @BotFather: /mybots → Bot Settings → Group Privacy → Turn off. Selepas itu, anda mesti mengeluarkan bot daripada kumpulan dan menambahnya semula — Telegram mengingati tetapan lama. Sebagai alternatif, jadikan bot pentadbir kumpulan tanpa mematikan mod privasi.

</div>

Bot Telegram baharu mempunyai mod privasi yang diaktifkan secara lalai; dokumentasi Hermes menyifatkannya sebagai punca kekeliruan yang paling lazim tentang bot dalam kumpulan. Dalam mod ini, bot hanya menerima mesej yang bermula dengan perintah `/`, balasan kepada mesejnya sendiri dan pemberitahuan perkhidmatan. Bot memang tidak menerima mesej kumpulan biasa — Telegram tidak menghantarnya kepada bot dan tiada tetapan ejen yang dapat membetulkannya.

Cara membetulkannya:

1.  Buka @BotFather dan hantar `/mybots`.
2.  Pilih bot anda.
3.  Buka “Bot Settings” → “Group Privacy” → “Turn off”.
4.  Keluarkan bot daripada kumpulan dan tambahnya semula.

Langkah keempat mudah terlepas pandang, lalu bot “masih senyap”. Telegram mengingati tetapan privasi semasa bot menyertai kumpulan dan tidak mengemas kininya sehingga bot dikeluarkan daripada kumpulan dan ditambah semula.

Jika anda tidak mahu mematikan privasi secara menyeluruh, ada pilihan kedua: jadikan bot pentadbir kumpulan. Bot pentadbir menerima semua mesej dalam apa-apa mod privasi.

## Ralat sambungan lazim dan tindakan yang perlu diambil

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Perkara penting dalam bahagian ini">

Perkara penting

Mula-mula, semak sama ada gateway berjalan serta token dan ID dalam senarai akses adalah betul. Untuk kumpulan, semak mod privasi; untuk pengecaman suara, semak penyedia STT; dan untuk balasan suara melalui Edge TTS, semak sama ada ffmpeg tersedia.

</div>

| Gejala | Punca | Tindakan |
|----|----|----|
| Bot langsung tidak membalas | Token tidak betul atau gateway tidak berjalan | Semak token dalam `.env`, mulakan semula `hermes gateway` dan semak log dalam terminal yang sama |
| Bot membalas “unauthorized” | ID anda tiada dalam senarai akses | Sahkan ID anda, tambahkannya pada `TELEGRAM_ALLOWED_USERS` dan mulakan semula gateway |
| Membalas dalam sembang peribadi tetapi senyap dalam kumpulan | Mod privasi | Pilih “Turn off” melalui BotFather, kemudian keluarkan bot daripada kumpulan dan tambahnya semula, atau jadikannya pentadbir |
| Mesej suara tidak ditranskripsikan | Pengecaman pertuturan belum dikonfigurasikan | Pengecaman tempatan dipasang dengan pakej faster-whisper; pilihan awan memerlukan kunci masing-masing |
| Balasan suara melalui Edge TTS tiba sebagai fail dan bukannya mesej suara biasa | ffmpeg tiada | Pasang ffmpeg — Edge TTS memerlukannya untuk menukar kepada format mesej suara Telegram |
| Token berhenti berfungsi | Token telah dibatalkan | Dapatkan token baharu melalui `/revoke` dan `/newbot` (atau `/token`) dengan BotFather, gantikan nilainya dalam `.env` dan mulakan semula gateway |

## Apakah lagi yang ditanyakan orang tentang Hermes Agent dalam Telegram?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Perkara penting dalam bahagian ini">

Perkara penting

Pelayan tidak diperlukan, tetapi bot hanya aktif semasa gateway berjalan. Sambungan adalah percuma; anda hanya membayar untuk model. Beberapa orang boleh disambungkan melalui senarai ID. Bot tidak dapat melihat sembang peribadi. Fail yang melebihi 20 MB memerlukan persediaan tambahan.

</div>

<div class="section">

### Soalan lazim

Adakah pelayan diperlukan untuk bot berfungsi?

Tidak, untuk bermula, komputer yang mempunyai Hermes terpasang sudah mencukupi. Ingat: bot aktif semasa gateway berjalan. Matikan komputer atau letakkannya dalam mod tidur, dan bot akan senyap sehingga mesin itu berjalan semula. Apabila anda mahu bot berjalan sepanjang masa, pindahkan ejen ke pelayan — kami mempunyai panduan berasingan tentang perkara itu.

Berapakah kos untuk menghubungkan bot?

Sambungan adalah percuma. Telegram tidak mengenakan bayaran untuk bot, dan Hermes Agent ialah projek sumber terbuka. Kos berasingan mungkin dikenakan untuk model yang disambungkan kepada ejen dan pelayan jika anda mahu bot berjalan sepanjang masa.

Bolehkah saya menghubungkan isteri atau pasukan saya kepada bot?

Ya. Dalam senarai `TELEGRAM_ALLOWED_USERS`, ID dipisahkan dengan koma, dan semua orang dalam senarai boleh menghantar mesej peribadi kepada bot. Jika anda turut membenarkan sembang itu sendiri melalui `TELEGRAM_GROUP_ALLOWED_CHATS`, mana-mana ahli kumpulan tersebut boleh menggunakan bot — begitulah cara senarai sembang yang dibenarkan berfungsi menurut dokumentasi.

Bolehkah bot melihat perbualan peribadi saya?

Tidak. Bot API hanya memberikan bot mesej yang ditujukan kepadanya dalam sembang peribadi, manakala mod privasi Telegram terpakai dalam kumpulan seperti yang dibincangkan dalam bahagian tentang kumpulan. Bot tidak mempunyai akses kepada perbualan anda dengan orang lain.

Mengapa bot enggan menerima mesej suara yang besar?

Bot API awam mempunyai had muat turun fail sebanyak 20 MB; fail yang lebih besar akan ditolak. Dokumentasi Hermes menerangkan penyelesaian menggunakan pelayan Bot API tempatan, yang meningkatkan had kepada 2 GB. Anda hanya memerlukannya jika merancang untuk menerima fail yang melebihi 20 MB; pautan ke dokumentasi terdapat dalam bahagian “Sumber” di hujung artikel.

Bolehkah saya menambah keupayaan baharu kepada bot?

Ya. Hermes mempunyai skills dan plugin — keupayaan siap guna untuk ejen. Cara memasang plugin dalam bot ejen AI seperti ini diterangkan secara berasingan: cara memasang plugin dalam bot ejen AI di Telegram.

</div>

<div class="section" role="doc-bibliography" aria-label="Sumber">

### Sumber

- [Hermes Agent: persediaan Telegram](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram) — sumber utama bagi panduan asal, disemak oleh pengarangnya pada 12.09.2026
- [Hermes Agent: gateway pemesejan](https://hermes-agent.nousresearch.com/docs/user-guide/messaging)
- [Hermes Agent: pemasangan](https://hermes-agent.nousresearch.com/docs/getting-started/installation)
- [Hermes Agent: panduan mula pantas](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart)
- [Hermes Agent: tugas berjadual](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron)
- [BotFather](https://t.me/BotFather) — bot rasmi Telegram untuk mencipta bot

</div>





Apabila anda bersedia, kenali [Ailoot](https://ailoot.ai/).

## Soalan lazim: Cara Menghubungkan Hermes Agent ke Telegram dan Mengurus Tugas dari Telefon

### Adakah senarai benarkan peribadi menyekat orang tidak tersenarai dalam kumpulan dibenarkan?

Tidak apabila seluruh sembang dibenarkan melalui TELEGRAM_GROUP_ALLOWED_CHATS: mana-mana ahli kumpulan itu dibenarkan. TELEGRAM_ALLOWED_USERS membenarkan penghantar individu; periksa kedua-dua tetapan sebelum membuka bot kepada kumpulan.

### Adakah mewajibkan sebutan @ menjadikan kumpulan peribadi untuk pengguna terpilih?

Tidak. Tetapan sebutan dan corak menentukan mesej yang mencetuskan respons. Ia tidak membatalkan akses yang diberikan kepada setiap ahli sembang dibenarkan.


## Ailoot · Syarikat dan portfolio projeknya

Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.

Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.

Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.