Sebelum Kita Mula: Memahami Apa yang Anda Bina
Kebanyakan panduan pemasangan AI memperlakukan perisian sebagai kotak hitam: muat turun, pasang, lupakan. clawbot berbeza kerana anda bukan memasang aplikasi—anda membina infrastruktur. Fikirkan ini seperti menyediakan pelayan e-mel peribadi anda sendiri, kecuali daripada menguruskan mesej, anda mengorkestrasi AI yang benar-benar boleh mengawal persekitaran digital anda.
Panduan ini menerangkan apa yang dilakukan setiap langkah dan mengapa ia penting. Memahami seni bina menjadikan penyelesaian masalah intuitif dan penyesuaian mudah.
Apa yang Anda Akan Ada Selepas 30 Minit
- Perkhidmatan Gateway yang berjalan berterusan pada peranti anda, menyelaraskan semua aktiviti AI
- Sambungan ke model AI pilihan anda (Claude, GPT-4, atau Ollama tempatan percuma)
- Sekurang-kurangnya satu saluran pemesejan (WhatsApp, Telegram, dll.) dipautkan ke AI anda
- Automasi yang berfungsi yang menunjukkan kawalan sistem tulen
- Pemahaman tentang cara melanjutkan, menyesuaikan, dan menyelesaikan masalah persediaan anda
Prasyarat: Apa yang Anda Sebenarnya Perlukan
Sebelum memuat turun apa-apa, sahkan sistem anda memenuhi keperluan ini. Setiap satu mempunyai tujuan tertentu:
Keperluan Perkakasan
- Sistem Pengendalian: macOS 11+, Linux (Ubuntu 20.04+, Debian 11+), atau Windows 10+ dengan WSL2
- RAM: Minimum 2GB tersedia (4GB disyorkan untuk operasi yang lebih lancar)
- Ruang Cakera: 500MB untuk pemasangan teras ditambah ruang untuk caching model AI
- Rangkaian: Sambungan internet yang stabil untuk panggilan API AI (kecuali menggunakan Ollama tempatan)
Kebergantungan Perisian
clawbot memerlukan Node.js 22 atau lebih tinggi. Mengapa versi khusus ini? Versi Node.js yang lebih baharu termasuk peningkatan prestasi kritikal dan tampalan keselamatan yang bergantung kepada komunikasi masa nyata clawbot. Pemasang biasanya menguruskan ini, tetapi pemasangan manual memerlukannya diprapasang.
Akses Model AI (Pilih Satu)
Analisis Kos-Faedah: Model AI Mana yang Patut Anda Pilih?
Pilihan 1: Anthropic Claude (Disyorkan untuk kebanyakan pengguna)
- Kos: ~$20-40/bulan untuk penggunaan peribadi biasa
- Kelebihan: Penaakulan luar biasa, kesedaran keselamatan yang kuat, tetingkap konteks panjang
- Dapatkan kunci API: console.anthropic.com
Pilihan 2: OpenAI GPT-4
- Kos: ~$25-50/bulan bergantung pada corak penggunaan
- Kelebihan: Pangkalan pengetahuan yang luas, cemerlang untuk tugas kreatif
- Dapatkan kunci API: platform.openai.com
Pilihan 3: Model Ollama Tempatan (Percuma sepenuhnya)
- Kos: $0 (berjalan sepenuhnya pada perkakasan anda)
- Kelebihan: Tiada kos berterusan, privasi lengkap, operasi luar talian
- Kelemahan: Respons lebih perlahan, memerlukan perkakasan yang lebih berkuasa (8GB+ RAM disyorkan)
- Persediaan: ollama.ai
Langkah 1: Muat Turun Pakej yang Betul untuk Platform Anda
clawbot mengedarkan pemasang khusus platform yang menggabungkan semua yang diperlukan. Mengapa pelbagai format? Sistem pengendalian yang berbeza mengendalikan perkhidmatan latar belakang secara berbeza—pemasang mengkonfigurasi ini dengan betul.
Pemasangan macOS
Muat turun pemasang DMG untuk pengalaman paling mudah:
curl -fsSL https://github.com/steipete/clawbot/releases/download/v2026.1.23/clawbot-2026.1.23.dmg -o clawbot.dmg
Atau muat turun terus dari Keluaran GitHub.
Apa yang dilakukan pemasang:
- Memasang perkhidmatan Gateway ke
/Applications/clawbot.app - Mencipta direktori konfigurasi di
~/.clawbot/ - Mengkonfigurasi kebenaran sistem untuk keupayaan automasi
- Pilihan untuk menyediakan lancar-semasa-permulaan (disyorkan)
Pemasangan Linux
Pasang melalui npm (disyorkan) atau Docker:
npm install -g clawbot@latest
Kemudian mulakan konfigurasi:
clawbot init
Menyediakan sebagai perkhidmatan systemd (pilihan tetapi disyorkan):
clawbot install-service
Ini memastikan clawbot bermula secara automatik semasa but dan dimulakan semula jika ia ranap.
Pemasangan Windows (WSL2)
Windows memerlukan WSL2 (Windows Subsystem for Linux). Jika tidak dipasang:
wsl --install
Kemudian ikuti arahan Linux di dalam persekitaran WSL2 Ubuntu anda.
Sokongan Windows Asli
Sokongan Windows asli (tanpa WSL2) adalah eksperimen. WSL2 menyediakan keserasian yang lebih baik dengan integrasi sistem Node.js dan pelaksanaan arahan shell.
Penggunaan Docker
Untuk keserasian merentas platform atau penggunaan pelayan:
docker pull ghcr.io/steipete/clawbot:latest
Jalankan dengan konfigurasi berterusan:
docker run -d \
--name clawbot \
-v ~/.clawbot:/root/.clawbot \
-p 18789:18789 \
ghcr.io/steipete/clawbot:latest
Memahami bendera Docker:
-d: Menjalankan kontena di latar belakang (mod daemon)-v ~/.clawbot:/root/.clawbot: Mengekalkan konfigurasi antara mula semula-p 18789:18789: Mendedahkan port WebSocket Gateway untuk klien tempatan
Langkah 2: Pasang dan Lancarkan Gateway
Gateway adalah jantung clawbot—proses Node.js yang berterusan yang tidak pernah tidur. Fikirkan ia sebagai sistem saraf pusat: saluran menghantar mesej ke Gateway, yang menghalakannya ke model AI yang sesuai, menerima respons, dan menyampaikannya kembali.
Jalankan Pemasang
macOS: Buka DMG yang dimuat turun dan seret clawbot ke Applications. Lancarkannya.
Linux/WSL: Selepas pemasangan npm, mulakan Gateway:
clawbot gateway start
Sahkan ia berjalan:
clawbot gateway status
Anda sepatutnya melihat: Gateway is running on ws://127.0.0.1:18789
Apa yang Berlaku di Sebalik Tabir
Gateway mencipta pelayan WebSocket pada port 18789 (boleh disesuaikan). Pelayan tempatan sahaja ini menerima sambungan dari:
- Plugin saluran (WhatsApp, Telegram, dll.) yang memajukan mesej pengguna
- Klien nod (aplikasi mudah alih, antara muka web) untuk interaksi langsung
- Kemahiran dan alat yang melanjutkan fungsi
Semua komunikasi kekal pada mesin anda kecuali anda mengkonfigurasi akses jauh secara eksplisit (diliputi dalam panduan lanjutan).
Langkah 3: Sambungkan Otak AI Anda
Dengan Gateway berjalan, ia memerlukan model AI untuk menjana respons. Langkah ini mengkonfigurasi model mana yang akan anda gunakan dan mengesahkan akses API.
Konfigurasikan Penyedia AI
Buka fail konfigurasi:
clawbot config edit
Atau edit secara manual ~/.clawbot/clawbot.json. Tambah kelayakan API anda:
{
"aiProviders": {
"anthropic": {
"apiKey": "sk-ant-kunci-api-anda-di-sini",
"model": "claude-3-5-sonnet-20250219",
"enabled": true
}
},
"defaultProvider": "anthropic"
}
Untuk Ollama tempatan sebaliknya:
{
"aiProviders": {
"ollama": {
"baseURL": "http://localhost:11434",
"model": "llama3.1:8b",
"enabled": true
}
},
"defaultProvider": "ollama"
}
Amalan Terbaik Keselamatan: Pengurusan Kunci API
Jangan sekali-kali komit clawbot.json ke kawalan versi jika ia mengandungi kunci API. Pertimbangkan menggunakan pembolehubah persekitaran untuk penggunaan pengeluaran:
export ANTHROPIC_API_KEY="kunci-anda-di-sini"
clawbot secara automatik membaca dari pembolehubah persekitaran jika ada.
Langkah 4: Pautkan Saluran Komunikasi Anda
Saluran adalah cara anda berinteraksi dengan AI anda—WhatsApp untuk mudah alih, Telegram untuk desktop, Discord untuk kolaborasi pasukan. Setiap saluran menyambung secara bebas ke Gateway, dan clawbot mengekalkan sejarah perbualan bersatu merentasi semuanya.
Sambungkan Saluran Pertama Anda: Contoh WhatsApp
Pasang plugin saluran WhatsApp:
clawbot channel add whatsapp
Ini melancarkan persediaan interaktif:
- Kod QR muncul di terminal anda
- Buka WhatsApp pada telefon anda → Tetapan → Peranti Dipautkan → Pautkan Peranti
- Imbas kod QR
- clawbot mengesahkan sambungan dan menyimpan kelayakan sesi
Cara ia berfungsi: clawbot menggunakan protokol WhatsApp Web (melalui pustaka Baileys) untuk membina sambungan berterusan. Telefon anda kekal sebagai peranti "utama"; clawbot bertindak sebagai peranti sekunder yang dipautkan—sama seperti WhatsApp Web di pelayar anda.
Keselamatan Akaun WhatsApp
Syarat perkhidmatan WhatsApp melarang penggunaan bot. Walaupun clawbot melaksanakan pengehadan kadar dan corak tingkah laku seperti manusia, kami mengesyorkan menggunakan nombor telefon sekunder berbanding akaun WhatsApp peribadi utama anda. Pertimbangkan:
- Mendapatkan Google Voice atau nombor maya yang serupa
- Menggunakan kad SIM lama yang anda tidak gunakan secara aktif
- Cuba Telegram sebaliknya (menyokong bot secara rasmi)
Saluran Alternatif
Setiap saluran mempunyai keperluan persediaan unik. Pilihan popular:
Telegram (Disyorkan untuk pemula):
clawbot channel add telegram
Ikuti gesaan untuk mengesahkan dengan nombor telefon anda. Telegram menyokong bot secara rasmi, menjadikan ini pilihan paling selamat.
Discord (Bagus untuk pasukan):
clawbot channel add discord
Memerlukan penciptaan aplikasi bot Discord di discord.com/developers. Salin token bot apabila diminta.
Dokumentasi saluran penuh: docs.clawd.bot/channels
Langkah 5: Laksanakan Tugas Autonomi Pertama Anda
Dengan semuanya dikonfigurasi, mari sahkan clawbot benar-benar boleh mengawal sistem anda—bukan sekadar bertindak balas dengan teks.
Uji Integrasi Sistem
Buka saluran pemesejan yang disambungkan (WhatsApp, Telegram, dll.) dan hantar mesej ini:
"Cipta fail teks bernama test.txt dalam folder Dokumen saya dengan tarikh hari ini dan petikan motivasi."
Apa yang sepatutnya berlaku:
- clawbot menerima mesej anda melalui saluran
- Gateway menghalakannya ke model AI yang dikonfigurasi
- AI menjana pelan respons termasuk arahan shell
- clawbot melaksanakan:
echo "..." > ~/Documents/test.txt - Anda menerima pengesahan: "Dicipta test.txt dengan..."
- Semak folder Dokumen anda—fail wujud
Anda Baru Menunjukkan Automasi AI Tulen
Apa yang membezakan clawbot daripada ChatGPT atau Siri: ia tidak hanya memberitahu anda cara mencipta fail—ia sebenarnya menciptanya. Keupayaan yang sama ini meluas kepada:
- Menguruskan kalendar anda dan menghantar jemputan mesyuarat
- Memantau fail log dan memberitahu anda tentang ralat
- Menarik data dari API dan menjana laporan
- Mengawal peranti rumah pintar melalui Home Assistant
- Menjalankan aliran kerja pembangunan (ujian, binaan, penggunaan)
Apa yang Perlu Dibina Seterusnya
Infrastruktur AI anda beroperasi. Berikut adalah cara untuk melanjutkan keupayaannya:
1. Pasang Kemahiran dari ClawdHub
Kemahiran adalah modul automasi pra-bina. Layari pasaran:
clawbot skills browse
Kemahiran permulaan popular:
- google-calendar: Pengurusan kalendar bahasa semula jadi
- home-assistant: Integrasi kawalan rumah pintar
- github-assistant: Pengurusan repositori dan semakan PR
- daily-briefing: Ringkasan pagi kalendar, cuaca, berita
2. Cipta Automasi Tersuai
Kemahiran hanyalah folder dengan fail SKILL.md. Cipta milik anda sendiri:
mkdir -p ~/.clawbot/skills/automasi-saya
echo "# Kemahiran Tersuai Saya" > ~/.clawbot/skills/automasi-saya/SKILL.md
Panduan penuh: docs.clawd.bot/skills/creating
3. Konfigurasikan Tingkah Laku Proaktif
Tidak seperti AI tradisional, clawbot boleh memulakan hubungan. Dayakan pemantauan degupan jantung:
clawbot config set heartbeat.enabled true
clawbot config set heartbeat.interval "every day at 8am"
Sekarang clawbot akan secara proaktif menghantar taklimat pagi kepada anda tanpa diminta.
4. Gunakan ke Awan (Pilihan)
Menjalankan clawbot pada komputer riba anda berfungsi, tetapi penggunaan awan memastikan ketersediaan 24/7. Panduan tersedia untuk:
- DigitalOcean Droplets ($6/bulan)
- AWS EC2 Free Tier (12 bulan percuma)
- Hetzner Cloud (€4/bulan)
- Raspberry Pi Rumah (kos perkakasan sekali)
Isu Biasa dan Penyelesaian
Gateway Tidak Bermula
Gejala: Error: EADDRINUSE: address already in use
Punca: Proses lain menggunakan port 18789.
Penyelesaian: Cari dan bunuh proses yang bercanggah:
lsof -ti:18789 | xargs kill -9
Atau konfigurasikan clawbot untuk menggunakan port berbeza dalam clawbot.json.
Model AI Mengembalikan Ralat
Gejala: "API authentication failed" atau "Invalid model specified"
Punca: Kunci API atau nama model tidak betul dalam konfigurasi.
Penyelesaian: Sahkan kunci API anda sah:
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: KUNCI_ANDA" \
-H "anthropic-version: 2023-06-01"
Semak nama model di dokumentasi penyedia (Anthropic, OpenAI).
WhatsApp Sering Terputus
Gejala: Pengesahan kod QR diperlukan setiap beberapa hari.
Punca: Kelayakan sesi tidak berterusan dengan betul.
Penyelesaian: Pastikan ~/.clawbot/channels/whatsapp/ mempunyai kebenaran tulis:
chmod 700 ~/.clawbot/channels/whatsapp/
Juga sahkan telefon anda kekal disambungkan ke internet—WhatsApp memerlukan peranti utama dalam talian.
Anda Kini Menjalankan Infrastruktur AI Anda Sendiri
Apa yang anda bina bukan sekadar chatbot—ia adalah platform automasi peribadi yang menggabungkan kecerdasan model AI frontier dengan keupayaan kawalan sistem tempatan. Tidak seperti perkhidmatan awan yang mengekang apa yang AI boleh lakukan, pemasangan clawbot anda mempunyai akses yang sama ke persekitaran digital anda seperti anda.
Kuasa ini datang dengan tanggungjawab: clawbot boleh melaksanakan sebarang arahan yang anda luluskan. Sistem kotak pasir dan kebenaran melindungi daripada kerosakan tidak sengaja, tetapi akhirnya anda memberikan AI kawalan yang bermakna. Mulakan dengan automasi mudah, fahami bagaimana keputusan dibuat, dan secara beransur-ansur luaskan keupayaan semasa anda membina kepercayaan.
Bersedia untuk Mendalami?
Terokai konfigurasi lanjutan, pembangunan kemahiran, dan pendalaman seni bina