05 · Gateway & channels · ~90–150 menit

Gateway & channels

Saluran chat membuat Gateway berguna dari HP. Telegram biasanya paling cepat untuk sukses pertama.

Daftar isi

Ingat peran Gateway
Telegram langkah demi langkah
WhatsApp (overview)
Slack & Discord
Lab checklist
Skenario latihan
FAQ

Fakta terverifikasi

Telegram: buat token bot → isi pengaturan → jalankan Gateway → setujui pengirim baru (pairing)
WhatsApp: scan QR; data login tersimpan di disk
Aturan chat pribadi (dmPolicy) bawaan: pairing — orang baru harus diizinkan dulu
Izinkan pengirim lewat perintah openclaw pairing

Ingat peran Gateway

Channel = pintu chat (Telegram, WhatsApp, …). Gateway = resepsionis. Orang baru harus dapat izin masuk (pairing) sebelum boleh bicara ke asisten AI.

Analogi: Gateway adalah resepsionis hotel. Channel adalah pintu masuk. Pairing adalah “minta badge tamu”.

Channel	Catatan pemula
Telegram	Sering paling cepat (bot token)
WhatsApp	Scan QR untuk sambung; lebih banyak data tersimpan di disk
Discord / Slack	Setup bot di workspace; masukkan ID tetap ke daftar putih (allowlist)
WebChat / layar kontrol	Baik untuk uji di komputer tanpa HP

Telegram langkah demi langkah

1) Buat bot token

Chat BotFather di Telegram (pastikan handle tepat).
Jalankan /newbot dan simpan token.
Jangan tempel token di chat publik / git.

2) Config

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      groups: { "*": { requireMention: true } }
    }
  }
}

Cadangan lewat variabel lingkungan akun bawaan: TELEGRAM_BOT_TOKEN. Akun bernama memakai botToken atau file token (sama artinya: kunci bot).

Info

Telegram tidak memakai login QR seperti WhatsApp. Isi token, lalu jalankan Gateway.

3) Izinkan chat pribadi (pairing)

openclaw gateway
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

Pairing = orang baru dapat kode. Kamu harus setujui dulu. Kode berlaku sekitar 1 jam; antrian menunggu dibatasi.

4) User ID numerik

Dari balasan pairing bot, atau
Dari logs (cari senderUserId).
Untuk daftar yang diizinkan (allowFrom): pakai ID angka — bukan nama pengguna.

5) Group (opsional)

Tambah bot ke group; ambil chat ID (sering -100…).
Masukkan di channels.telegram.groups.
Privacy mode BotFather bisa membatasi pesan; sesuaikan sesuai docs.
Bawaan requireMention: bot hanya jawab kalau disebut/di-mention.

Peringatan

Izin chat pribadi (pairing) tidak otomatis mengizinkan perintah di grup.

WhatsApp (overview)

Login QR; credentials di ~/.openclaw/credentials/.
Kunci dengan aturan chat pribadi (dmPolicy) / daftar putih (allowFrom); di grup wajib sebut bot.
Pertimbangkan nomor terpisah dari nomor pribadi.
Detail langkah QR: docs channel WhatsApp.

Slack dan Discord (ringkas)

Butuh app/bot token di sisi platform + config OpenClaw.
Daftar putih per server/channel; bawaan: perlu mention.
Kalau semua orang di workspace bisa chat pribadi ke bot, risiko alat berbahaya tinggi — pisahkan Gateway pribadi vs tim.

Lab checklist

Bot Telegram lab dibuat; token tidak di-commit Aturan chat pribadi = pairing (orang baru harus diizinkan) Chat pribadi pertama sudah diizinkan Balasan muncul di Telegram Cek saluran (channels status --probe) sehat (Opsional) di grup bot hanya jawab kalau disebut

Skenario latihan

DM bot dari akun kedua yang belum di-pair — harus ditolak sampai approve.
Setujui pairing lalu kirim pertanyaan sederhana.
Tambah bot ke group lab dengan requireMention.
Uji pesan tanpa mention (harus diam) dan dengan mention (harus jawab).

Kuis singkat

Mengapa Telegram sering dipilih untuk first win?
Apa fungsi pairing untuk chat pribadi?
Apa risiko group tanpa mention gate?

Kunci:

Setup bot token relatif sederhana.
Pengirim asing tidak diproses sampai di-approve.
Siapa saja di group bisa memicu agent (dan tools-nya).

FAQ

getMe 401 — Token salah atau di-revoke; buat ulang di BotFather.

409 getUpdates — Ada poller lain memakai token yang sama.

Bot diam di grup — Cek apakah harus @sebut, daftar putih grup, mode privasi, dan apakah bot sudah jadi anggota.

Lanjut ke Modul 06 — Keamanan (wajib).