OpenClaw: apa itu, cara memasangnya dan menyambungkannya ke Telegram

OpenClaw muncul dalam suapan saya pada musim sejuk lalu, ketika projek itu menukar namanya dua kali dalam seminggu dan memperoleh ratusan ribu bintang di GitHub. Sejak itu, semakin ramai orang mencari “pemasangan OpenClaw” dan “OpenClaw Telegram”.

Di bawah, saya meneliti dokumentasi rasmi: apakah benda ini, bagaimana ia berbeza daripada Claude Code, cara memasangnya pada Windows, macOS atau Linux, cara memilih model dan menyambungkan bot Telegram. Saya juga membincangkan keselamatan secara berasingan kerana OpenClaw terlibat dalam beberapa insiden berprofil tinggi.

Ketahui cara menggunakan perkhidmatan ini dalam dokumentasi Ailoot.

Apakah OpenClaw dalam bahasa mudah?#

OpenClaw menyambungkan model AI kepada bot Telegram anda. Dengan alat dan kebenaran berkaitan dikonfigurasikan, ia boleh meringkaskan mesej atau menjadualkan peringatan. Proses gateway dan konfigurasi setempatnya berjalan pada komputer atau pelayan anda. Ini tidak menjadikan semua perbualan setempat: apabila anda memilih model awan, permintaan dan konteks perbualan berkaitan dihantar kepada penyedia itu. Jika anda menyambung melalui Ailoot, permintaan melalui Ailoot ke penyedia model yang dipilih. Inferens setempat memerlukan model setempat tanpa fallback awan; mesej Telegram tetap melalui Telegram dan alat diaktifkan mungkin menghubungi perkhidmatan lain.

Projek ini dibangunkan oleh komuniti sumber terbuka OpenClaw. Repositori GitHub dicipta pada 24 November 2025, dan setakat 22 Ogos 2026, ia mempunyai 387 ribu bintang dan 81 ribu fork—antara projek terbuka yang paling pesat berkembang pada tahun itu. Bahasa yang digunakan ialah TypeScript.

Projek ini mempunyai sejarah nama yang menarik, dan elok mengetahuinya supaya anda tidak keliru dengan artikel lama. Ia bermula sebagai Warelay, sebuah gerbang untuk WhatsApp. Kemudian namanya menjadi Clawdbot. Pada Januari 2026, Anthropic meminta nama itu ditukar kerana isu tanda dagangan, dan projek itu menggunakan nama Moltbot selama beberapa hari. Pada 30 Januari 2026, ia mendapat nama muktamad: OpenClaw. Jadi, jika anda menemui arahan tentang “Clawdbot” atau “Moltbot”, itu projek yang sama; artikel tersebut ditulis sebelum penukaran nama.

Maskot projek ini ialah Molty si udang kara, dan “bersalin kulit” menjadi metafora rasmi bagi setiap penukaran nama.

Apakah perbezaan OpenClaw dengan Claude Code dan Hermes Agent?#

Saya kerap ditanya tentang perbezaan ini kerana dari luar, semuanya kelihatan seperti “ejen AI”. Berikut ialah jadual perbandingan:

Cara membaca jadual ini. Saya menggunakan Claude Code untuk pembangunan: alat ini paling kuat apabila anda memerlukan model berkuasa dan bekerja dengan kod. OpenClaw dan Hermes pula untuk perkara lain: ejen yang sentiasa berjalan, berada dalam Telegram, mengingati perbualan semalam dan melaksanakan tugasan mengikut jadual. Pilihan antara OpenClaw dengan Hermes lebih rumit; sudah ada panduan Hermes dengan arahan pemasangan dan persediaan.

Jika anda cuma sedang memilih alat, mulakan dengan gambaran keseluruhan: alat yang digunakan orang untuk menulis kod pada 2026 dan tugasan yang patut diserahkan kepada ejen AI. Saya juga mempunyai artikel berasingan tentang pemasangan Claude Code.

Apakah yang diperlukan sebelum memasang OpenClaw?#

Semak versi Node anda lebih awal—ini satu-satunya keperluan yang ketat:

node --version

Versi 22.22.3+, 24.15+ dan 25.9+ disokong; Node 26 disyorkan. Jika arahan itu memulangkan “command not found” atau versinya lama, jangan risau: pemasang rasmi akan memuat turun versi Node yang terkini untuk anda, jadi anda tidak perlu memasang apa-apa secara manual.

Perkara seterusnya ialah model. OpenClaw tidak berfikir sendiri: ia memanggil model pilihan anda. Berikut ialah pilihan kosnya: kunci Anthropic, OpenAI atau Google—anda membayar penyedia berdasarkan penggunaan sebenar; atau model setempat melalui Ollama—percuma dari segi wang, tetapi memerlukan perkakasan yang berkuasa. Saya menerangkan kedua-dua pilihan ini di bawah dalam bahagian berasingan.

Bagaimanakah cara memasang OpenClaw pada macOS dan Linux?#

Cara yang disyorkan ialah menggunakan pemasang rasmi:

1. Jalankan pemasang

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   Skrip ini mengesan OS anda, menyemak Node (dan memasangnya jika perlu), memasang OpenClaw, kemudian membuka wizard persediaan. Jika anda mahu melihat-lihat sebelum menjalankan wizard, tambah bendera: bash -s -- --no-onboard.

2. Pastikan semuanya berjaya dipasang

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Arahan pertama memaparkan versi, arahan kedua menyemak konfigurasi dan arahan ketiga mengesahkan bahawa gerbang sedang berjalan serta mendengar pada port 18789.

Jika anda menggunakan npm dan mahu mengurus pemasangan sendiri:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Terdapat perangkap baru-baru ini di sini, yang dibincangkan dalam bab berasingan dokumentasi. npm 12 menyekat skrip pemasangan pakej secara lalai, dan tanpa bendera --allow-scripts=openclaw, pemasangan akan terhenti dengan mesej allowScripts. Pada npm 11.15 dan versi terdahulu, bendera itu tidak diperlukan—sekatan tersebut belum wujud. Semak versi anda dengan: npm --version.

Bendera --install-daemon dalam arahan kedua menetapkan autostart: pada macOS, ia ialah LaunchAgent; pada Linux, perkhidmatan systemd. Ia memulakan gateway selepas but semula atau log masuk, tertakluk pada syarat pengurus perkhidmatan. Ia tidak menghalang tidur atau mengekalkan gateway ketika komputer dimatikan. Balasan Telegram memerlukan hos berjaga dan bersambung rangkaian; gunakan pelayan sentiasa aktif jika memerlukan balasan ketika komputer riba tidur atau dimatikan.

Bagaimanakah cara memasang OpenClaw pada Windows?#

Pilihan pertama sesuai untuk mereka yang lebih suka tetingkap berbanding terminal. Windows Hub ialah aplikasi OpenClaw asli untuk Windows 10 (20H2+) dan Windows 11, dan kini masih dalam beta. Pergi ke halaman keluaran Windows Hub dan muat turun pemasang untuk pemproses anda: OpenClawCompanion-Setup-x64.exe untuk komputer biasa, atau arm64 untuk ARM. Selepas pemasangan, OpenClaw Companion akan muncul dalam menu Start, dengan ikon dulang sistem, tetingkap sembang dan tetapan.

Semasa pelancaran pertama, aplikasi itu akan menawarkan “Set up locally”—terimanya. Aplikasi itu akan mencipta persekitaran WSL khusus bernama OpenClawGateway, memasang gerbang di dalamnya dan menyambungkannya. Ia tidak akan mengusik pemasangan Ubuntu sedia ada anda, jika ada.

Pilihan kedua ialah melalui PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw gateway install

Baris pertama memasang OpenClaw; baris kedua mendaftarkan autostart melalui Windows Task Scheduler. Jika dasar komputer anda menyekat penciptaan tugasan, OpenClaw akan bertukar sendiri kepada pilihan sandaran: pintasan dalam folder Startup, supaya gerbang bermula apabila anda log masuk.

Pilihan ketiga ialah WSL2, yang dianggap oleh dokumentasi sebagai persekitaran masa jalan paling serasi pada Windows. Pasang Ubuntu, aktifkan systemd, kemudian ikut arahan Linux daripada bahagian sebelumnya:

wsl --install -d Ubuntu-24.04

Di dalam WSL, aktifkan systemd dalam /etc/wsl.conf (bahagian [boot], baris systemd=true), mulakan semula WSL dengan menjalankan wsl --shutdown daripada PowerShell, kemudian pasang OpenClaw menggunakan arahan Linux. Jika istilah “distribusi” dan “systemd” tidak bermakna bagi anda, gunakan Windows Hub; ia melakukan semua ini untuk anda.

Bagaimanakah cara memilih model dan melengkapkan persediaan awal?#

Model ialah enjin pembantu. Wizard persediaan akan memberikan senarai penyedia; berikut tiga pilihan yang praktikal:

Anthropic mempunyai satu ciri menarik: jika Claude Code sudah dipasang pada mesin anda dan anda sudah log masuk, OpenClaw boleh menggunakan log masuk itu. Mula-mula, jalankan claude auth login pada mesin tersebut, kemudian beritahu OpenClaw supaya menggunakannya:

openclaw models auth login --provider anthropic --method cli --set-default

Jika gerbang berjalan sebagai perkhidmatan latar belakang (seperti yang berlaku dengan --install-daemon), kunci itu mesti tersedia kepada perkhidmatan tersebut. Untuk itu, letakkannya dalam ~/.openclaw/.env—wizard akan menguruskannya untuk anda, jadi anda tidak perlu menyunting fail secara manual. Selepas apa-apa perubahan, mulakan semula dan semak:

openclaw gateway restart
openclaw models status

Jika sukar untuk membayar, gunakan model setempat daripada bahagian Ollama.

Bagaimanakah cara menyambungkan OpenClaw ke Telegram?#

Telegram ialah saluran paling pantas untuk disambungkan: anda hanya memerlukan token bot, tanpa pengesahan akaun perniagaan. Dokumentasi menyebutnya sebagai cara paling mudah untuk mula menghantar mesej kepada pembantu anda daripada telefon. Berikut proses lengkapnya:

1. Cipta bot dengan BotFather

   Buka sembang Telegram dengan @BotFather (pastikan nama pengguna itu tepat—terdapat banyak akaun palsu), hantar /newbot, kemudian pilih nama dan nama pengguna yang berakhir dengan bot. Anda akan menerima token seperti 123456789:ABCdef... sebagai balasan—token itu ialah kunci kepada bot anda, jadi simpan seperti kata laluan.

2. Masukkan token dalam OpenClaw

   Cara paling mudah ialah melalui wizard: jalankan openclaw configure dan pilih saluran Telegram. Alternatif manualnya ialah tetapan channels.telegram.botToken atau pemboleh ubah persekitaran TELEGRAM_BOT_TOKEN. Dokumentasi menyatakan secara khusus bahawa arahan openclaw channels login telegram tidak wujud; Telegram hanya disambungkan melalui token.

3. Mulakan gerbang dan mesej bot

   openclaw gateway
   

   Buka bot anda dalam Telegram dan hantar sesuatu kepadanya. Bot itu akan membalas dengan kod pemadanan lapan aksara. Ini langkah perlindungan: mesej tidak akan diproses sehingga anda meluluskan pengirim.

4. Luluskan diri anda

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Kod itu sah selama satu jam, jadi jangan tunggu terlalu lama. Pengirim pertama yang diluluskan akan menjadi pemilik arahan istimewa secara automatik.

Terdapat dua perkara rumit yang sering dihadapi orang.

Yang pertama ialah kumpulan. OpenClaw menyekat semua kumpulan secara lalai: anda perlu membenarkan bot secara jelas dalam tetapan channels.telegram.groups dan mengekalkan mod requireMention: true dalam kumpulan. Kemudian, bot itu hanya membalas apabila dipanggil dengan nama penggunanya, dan tidak akan menyampuk perbualan umum. Telegram juga mempunyai mod privasi bot sendiri: dalam kumpulan, bot hanya melihat arahan secara lalai. Matikannya dengan /setprivacy melalui @BotFather. Selepas menukarnya, anda perlu mengeluarkan bot daripada kumpulan dan menambahkannya semula; jika tidak, Telegram tidak akan menggunakan tetapan itu.

Yang kedua ialah jangan membuka akses kepada semua orang. Tetapan itu merangkumi mod dmPolicy: "open" dengan tanda asterisk dalam senarai akses: sesiapa sahaja yang menemui bot melalui nama penggunanya boleh memberikan arahan. Bagi pembantu peribadi, ini membuka laluan terus kepada orang lain untuk mengawal mesin anda. Kekalkan pemadanan melalui kod atau masukkan ID angka anda dalam allowFrom.

Bagaimanakah cara menjalankan OpenClaw dengan model setempat melalui Ollama?#

Pilihan ini mengekalkan inferens model pada perkakasan anda apabila laluan setempat sahaja tanpa fallback awan dipilih, dan tidak memerlukan endpoint model berbayar. Ini tidak menjadikan keseluruhan aliran kerja Telegram setempat: mesej tetap melalui Telegram dan alat dalam talian yang diaktifkan boleh menghantar data kepada perkhidmatan lain.

1. Pasang Ollama

   Muat turun pemasang daripada ollama.com/download—terdapat versi untuk macOS, Windows dan Linux.

2. Muat turun model

   ollama pull gemma4
   

3. Sambungkan Ollama kepada OpenClaw

   openclaw onboard
   

   Pilih penyedia Ollama dan mod: Local only (model anda sendiri sahaja), Cloud only (model daripada ollama.com) atau Cloud + Local. Wizard akan mencari pelayan setempat dan memaparkan model yang dipasang.

4. Semak

   openclaw models list --provider ollama
   

Berikut ialah batasan jujur yang perlu dinyatakan supaya bahagian ini tidak kedengaran seperti iklan. Dokumentasi OpenClaw menyatakan dengan jelas bahawa penggunaan ejen setempat yang selesa memerlukan perkakasan setaraf dua Mac Studio yang dilengkapi sepenuhnya, manakala kad grafik 24 GB hanya mampu mengendalikan permintaan ringan dengan kelewatan. Model yang kecil dan dimampatkan dengan ketara memendekkan konteks serta kurang tahan terhadap arahan berniat jahat yang tersembunyi dalam teks orang lain. Dalam bahasa mudah: model setempat pada komputer riba yang bagus memadai untuk “mencubanya dan memahami apa sebenarnya alat ini”, tetapi model awan masih jauh lebih boleh diharap untuk kerja harian dengan pembantu yang menggunakan alat.

Satu lagi amaran daripada dokumentasi, untuk sesiapa yang menyediakan konfigurasi WSL2 + Ollama + GPU NVIDIA: pemasang rasmi Ollama untuk Linux mengaktifkan autostart dengan dasar mula semula “always”, dan pada WSL2 dengan GPU, ini boleh menyebabkan mesin berada dalam kitaran mula semula. Penyelesaiannya ialah menyahaktifkan autostart perkhidmatan. Jika anda mengalaminya, rujuk bahagian penyelesaian masalah pada halaman Ollama dalam dokumentasi.

Sejauh manakah selamatnya menjalankan OpenClaw?#

Saya akan mulakan dengan perkara utama yang tidak difahami oleh semua orang. OpenClaw mempunyai akses kepada mesin anda: fail, arahan dan pelayar. Dokumentasi menyatakannya dengan jelas: projek ini direka untuk seorang pengguna yang dipercayai, dan anda tidak sepatutnya memberi orang luar akses kepada bot anda. Jika seseorang boleh menghantar mesej kepada ejen anda, mereka boleh menggunakannya untuk bertindak pada komputer anda.

Langkah minimum yang praktikal:

1. Kekalkan pemadanan melalui kod atau gunakan senarai akses—saya menerangkan cara menetapkannya dalam bahagian Telegram.
2. Jangan dedahkan gerbang kepada pihak luar melainkan anda perlu. Secara lalai, ia hanya mendengar pada mesin anda; biarkan begitu.
3. Jalankan pemeriksaan terbina dalam selepas sebarang perubahan konfigurasi:

openclaw security audit

Pemeriksaan ini mengesan akses terbuka, kebenaran alat yang terlalu luas, token lemah dan port terdedah. Dengan bendera --fix, beberapa penemuan boleh dibaiki secara automatik.

Catatan berasingan tentang penipuan—dan perkara ini bukan teori. Apabila projek itu menukar nama dengan tergesa-gesa pada Januari 2026, bot yang menceroboh nama domain mengambil alih alamat lama dalam beberapa saat dan terus menyiarkan dompet kripto; “pembangun OpenClaw” palsu mula mempromosikan penipuan token. Ini menghasilkan dua peraturan tegas. Muat turun OpenClaw hanya daripada openclaw.ai atau github.com/openclaw/openclaw. Dan projek ini tidak mempunyai mata wang kripto: apa-apa “token OpenClaw” ialah penipuan. Jangan hantar wang kepadanya dalam apa jua keadaan.

Apakah yang boleh dilakukan oleh OpenClaw selepas pemasangan?#

Berikut perkara yang akan saya cuba, mengikut turutan:

1. Gateway dan model. Jalankan openclaw gateway status, kemudian buka openclaw dashboard. Panel yang dimuatkan mengesahkan Control UI boleh dicapai. Hantar “Balas dengan: model connection test” dalam sembangnya dan semak balasan AI tiba; memuatkan halaman sahaja tidak menguji model.
2. Telegram dan tugasan yang dikehendaki. Selepas mengkonfigurasi bot dan meluluskan pemadanan anda sendiri, hantar mesej baharu kepada bot itu dalam Telegram dan semak balasannya tiba di situ. Kemudian cuba satu tugasan terhad dengan hasil yang boleh dilihat, seperti meringkaskan folder ujian tidak sensitif yang telah anda benarkan untuk dibaca. Untuk peringatan, semak jadual tersimpan dan peringatan yang benar-benar dihantar secara berasingan. Balasan papan pemuka tidak membuktikan penghantaran Telegram atau pelaksanaan berjadual.
3. Tugasan berjadual. Pembantu boleh menjalankan kerja mengikut jadual—ringkasan pagi dalam Telegram, pemeriksaan e-mel berkala. Sebab itulah anda membiarkan gerbang berjalan sepanjang masa.
4. Ingatan. OpenClaw menyimpan ingatan jangka panjang dalam fail Markdown biasa dalam folder kerjanya: siapa anda, cara ia patut membalas anda dan perkara yang diingatinya daripada perbualan terdahulu. Anda boleh membuka fail itu dan membacanya sendiri—tiada kotak hitam.
5. Kemahiran daripada katalog projek. Projek ini mempunyai katalog kemahiran dan pemalam sedia guna dengan pemeriksaan keselamatan terbina dalam. Kemahiran orang lain ialah kod orang lain pada mesin anda, sebab itulah katalog tersebut memeriksanya.

Ada satu peraturan di sini: jangan hidupkan semuanya serentak. Mulakan dengan satu perbualan yang stabil, kemudian Telegram, kemudian jadual. Dengan cara itu, setiap kegagalan akan muncul pada langkahnya sendiri, bukannya menjadi “semuanya rosak dan saya tak tahu di mana”.

Apakah yang perlu dilakukan jika pemasangan gagal?#

Mari kita teliti tiga keadaan yang biasa berlaku.

“openclaw: command not found” sejurus selepas pemasangan. Hampir selalu ini masalah laluan: folder pakej npm global tiada dalam PATH terminal anda. Arahan diagnostik dalam dokumentasi ialah:

node -v
npm prefix -g
echo "$PATH"

Laluan daripada arahan kedua sepatutnya muncul dalam arahan ketiga. Jika tidak, tambahkannya pada tetapan shell anda atau tutup dan buka semula terminal: kadangkala laluan Node hanya muncul dalam sesi baharu selepas pemasangan.

Gerbang berjalan tetapi pembantu senyap. Gejala yang dinyatakan dalam Soalan Lazim dokumentasi: tiada balasan kepada mesej pertama dan pembilang token berada pada sifar. Ini bermaksud ejen belum bermula langsung—selalunya model belum dikonfigurasi. Semak mengikut turutan ini:

openclaw gateway restart
openclaw status
openclaw models status

Jika model sudah dikonfigurasi tetapi masih tiada balasan, openclaw logs --follow akan memaparkan log langsung dan tempat proses itu tersekat.

Bot Telegram tidak membalas. Semak mengikut turutan ini: token itu milik bot yang anda mesej; gerbang sedang berjalan (openclaw gateway status); dan pemadanan anda sudah diluluskan (openclaw pairing list telegram). Kod pemadanan sah selama satu jam—jika anda menghantar mesej kepada bot semalam, mesej sekali lagi dan luluskan kod baharu.

Jika anda benar-benar buntu, dokumentasi mencadangkan sesuatu yang tidak dijangka tetapi munasabah: berikan maklumat diagnostik kepada ejen AI setempat yang boleh melihat mesin anda. Claude Code atau Codex, jika diberikan output openclaw status --all dan openclaw doctor, boleh memahami konfigurasi dengan lebih pantas daripada sembang sokongan. Kitaran lengkap—AI membaiki AI.

Apakah lagi yang ditanya orang tentang OpenClaw?#

Kenali Ailoot.