𝗘𝗷𝗲𝗻 𝗣𝗲𝗻𝗴𝗲𝗸𝑜𝗱𝗮𝗻 𝗺𝗲𝗹𝗮𝗹𝘂𝗶 𝗧𝗲𝗹𝗲𝗴𝗿𝗮𝗺: 𝗗𝗮𝗿𝗶 𝗦𝗶𝗳𝗮𝗿 𝗸𝗲𝗽𝗮𝗱𝗮 𝗘𝗷𝗲𝗻 𝘆𝗮𝗻𝗴 𝗠𝗲𝗻𝗷𝗮𝘄𝗮𝗯

Berhenti membaca dan mula bertindak.

Menjelang akhir panduan ini, anda akan mempunyai satu topik Telegram di mana ejen pengekodan akan menjawab mesej anda. Ejen ini akan mengendalikan pane tmux pada mesin anda sendiri.

Ini adalah matlamat utama. Anda belum memerlukan memori, monitor, atau pelayan alatan (tool servers). Anda hanya perlu memastikan ejen tersebut dapat menjawab anda.

⏱️ Masa yang Diperlukan: 30–45 minit.

🛠️ Prasyarat

Sebelum bermula, pastikan anda telah menyediakan perkara berikut:

  • Sebuah mesin dengan akses tmux dan shell.
  • Ejen pengekodan yang berfungsi (seperti OpenCode atau Claude Code) yang sudah berjalan dalam pane tmux.
  • Sasaran tmux yang tepat untuk ejen anda (contoh: mybox:1.1).
  • Perintah yang tepat untuk melancarkan ejen anda.
  • OpenClaw runtime telah dipasang.
  • Akaun Telegram dan aplikasi Telegram.

📦 Versi yang Diperlukan

Jangan langkau bahagian ini. Versi yang salah akan menyebabkan kegagalan senyap (silent failures).

• Node.js: 24.11.1 • Package Manager: pnpm 11.2.2 • OpenClaw: Pin kepada komit tertentu.

🚀 Laluan Persediaan Pantas

Anda boleh menggunakan skrip ini untuk mengendalikan persediaan tempatan:

  1. Muat turun skrip: curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/cd0f8353aac74e47c591111b758943e9/raw/setup-openclaw.sh" -o setup-openclaw.sh curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/7cf94af3e96526f9f14d0c28b6c26b69/raw/ready-check.sh" -o ready-check.sh chmod +x setup-openclaw.sh ready-check.sh

  2. Jalankan persediaan dengan token bot anda: OPENCLAW_BOT_TOKEN="" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh

  3. Sahkan persediaan: AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh

📱 Konfigurasi Telegram

Ikuti langkah-langkah ini dalam aplikasi Telegram anda:

  • Cipta bot melalui @BotFather dan simpan token tersebut.
  • Cipta kumpulan baharu dan tambah bot anda.
  • Jadikan bot sebagai Pentadbir (Administrator). Ini membolehkannya melihat mesej anda.
  • Aktifkan "Topics" dalam tetapan kumpulan.
  • Cipta satu topik untuk projek anda.
  • Hantar satu mesej dalam topik tersebut untuk menjana Topic ID dalam log anda.

⚙️ Menghubungkannya

Gateway menggunakan konfigurasi JSON di ~/.openclaw/openclaw.json.

Gunakan Fasa 1 untuk mencari Chat ID dan Topic ID anda dengan menghantar mesej dan menyemak log gateway.

Gunakan Fasa 2 untuk mengunci kumpulan tersebut. Tukar polisi kepada "allowlist" dan tambah hanya ID Pengguna Telegram bernombor anda. Petakan Topic ID anda kepada Agent ID yang spesifik.

📝 Kontrak Ejen

Cipta fail AGENTS.md dalam ruang kerja ejen anda. Fail ini memberitahu ejen cara untuk bertindak. Anda mesti mentakrifkan:

  • Cara untuk membaca pane (tmux capture-pane).
  • Cara untuk menulis ke pane (tmux send-keys).
  • Cara untuk mengendalikan arahan khusus seperti "status", "send", atau "restart".

✅ Ujian Kesediaan

Anda hanya dianggap selesai apabila anda melepasi lima semakan ini:

  1. Bot membalas dalam topik Telegram anda.
  2. Prompt anda sampai ke pane tmux.
  3. Ejen pengekodan mula bekerja pada prompt tersebut.
  4. Fail log membuktikan ejen telah mengendalikan topik anda.
  5. Kumpulan dikunci kepada ID Pengguna anda sahaja.

Sumber: https://dev.to/jerilk/coding-agents-over-telegram-part-2-from-zero-to-an-agent-that-answers-2777

Komuniti pembelajaran pilihan: https://t.me/GyaanSetuAi