Bina Infrastruktur AI Peribadi Anda

Ubah komputer anda menjadi pusat arahan AI autonomi. Panduan ini membimbing anda melalui pemasangan, konfigurasi, dan tugas automatik pertama anda—tanpa mengandaikan anda seorang pentadbir sistem.

Anggaran Masa: 30 minit

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.

macOS
Linux
Windows
Docker
1

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)
1

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.

1

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.

1

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.

2

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.

3

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.

4

Sambungkan Saluran Pertama Anda: Contoh WhatsApp

Pasang plugin saluran WhatsApp:

clawbot channel add whatsapp

Ini melancarkan persediaan interaktif:

  1. Kod QR muncul di terminal anda
  2. Buka WhatsApp pada telefon anda → Tetapan → Peranti Dipautkan → Pautkan Peranti
  3. Imbas kod QR
  4. 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.

5

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:

  1. clawbot menerima mesej anda melalui saluran
  2. Gateway menghalakannya ke model AI yang dikonfigurasi
  3. AI menjana pelan respons termasuk arahan shell
  4. clawbot melaksanakan: echo "..." > ~/Documents/test.txt
  5. Anda menerima pengesahan: "Dicipta test.txt dengan..."
  6. 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

Panduan Penggunaan Lengkap Seni Bina Teknikal Amalan Terbaik Keselamatan