Server Migration Center:Klien Edisi SMC AI Agent (Pratinjau Publik)

Langkah 1: Siapkan lingkungan

1. Siapkan server.

   • Linux: Akses jaringan publik untuk menjangkau Alibaba Cloud SMC dan API large language model (LLM) pilihan Anda. Arsitektur x86_64, kernel 5.10 atau lebih baru, Python 3.9 atau lebih baru. Kami merekomendasikan Alibaba Cloud Linux 3, Ubuntu 22.04, Rocky Linux 9, atau versi lebih baru.

   • Windows: Akses jaringan publik untuk menjangkau Alibaba Cloud SMC dan API LLM pilihan Anda. Arsitektur x86_64, Windows Server 2012 R2 atau lebih baru. Kami merekomendasikan Windows Server 2016, Windows 10, atau versi lebih baru.

2. Siapkan Akun Alibaba Cloud dengan SMC yang telah diaktifkan. SMC sendiri gratis, tetapi instansi perantara, disk cloud, dan lalu lintas jaringan yang digunakan selama migrasi dapat dikenai biaya.

3. Siapkan kunci API LLM. Kami merekomendasikan Token Plan Alibaba Cloud (Qwen Cloud) atau Coding Plan.

Langkah 2: Unduh dan instal

Langkah 3: Konfigurasi klien

1. Konfigurasi LLM.

   Pengaturan sekali klik (direkomendasikan)

   Contoh berikut menggunakan Coding Plan (Global) dengan model qwen/qwen3.7-plus. Untuk rencana dan model lainnya, lihat Konfigurasi model lainnya.

   Gunakan hanya satu rencana. Jangan berikan beberapa kunci model dalam satu perintah setup.

   Parameter	Deskripsi
   <AccessToken ID>	ID AccessToken dari kode aktivasi SMC. Untuk mendapatkannya, lihat mendapatkan kode aktivasi.
   <AccessToken Code>	Kode AccessToken dari kode aktivasi SMC. Untuk mendapatkannya, lihat mendapatkan kode aktivasi.
   <API_KEY>	Untuk kunci API Global, lihat Panggilan API pertama.
   --model	Model yang digunakan, dalam format provider/model. Contohnya, --model "qwen/qwen3.7-plus".

   smcclaw setup --modelstudio-api-key "<API_KEY>" --model "qwen/qwen3.7-plus" --accesstokenid "<AccessToken ID>" --accesstokencode "<AccessToken Code>"

   Penting

   Kode aktivasi merupakan kredensial sensitif. Memasukkannya langsung dalam perintah dapat menyimpannya ke riwayat shell Anda. Kelola kredensial sesuai kebutuhan keamanan Anda.

   Pengaturan interaktif dengan onboard

   Contoh berikut menggunakan Coding Plan (Global) dengan model qwen/qwen3.7-plus.

   1. Mulai pengaturan interaktif.

      Untuk mendapatkan <AccessToken ID> dan <AccessToken Code>, lihat mendapatkan kode aktivasi.

      smcclaw onboard --accesstokenid "<AccessToken ID>" --accesstokencode "<AccessToken Code>"

      Penting

      Kode aktivasi merupakan kredensial sensitif. Memasukkannya langsung dalam perintah dapat menyimpannya ke riwayat shell Anda. Kelola kredensial sesuai kebutuhan keamanan Anda.

   2. Ikuti petunjuk:

      • Mode pengaturan: OneClick

      • Penyedia model/auth: Qwen Cloud (jika tidak tercantum, pilih More.)

      • Metode autentikasi Qwen Cloud: Coding Plan API Key untuk Global/Intl

      • Kunci API: Masukkan kunci API Coding Plan Anda.

      • Model default: Pilih model, seperti qwen/qwen3.7-plus.

2. Jalankan smcclaw gateway status. Status running berarti layanan Gateway telah dimulai.

Langkah 4: Mulai percakapan

Gateway mendengarkan pada 127.0.0.1:18789 secara default dan menyediakan tiga titik masuk percakapan.

smcclaw tui

Tugas terjadwal

Saat migrasi dimulai, SMCClaw secara default membuat tugas terjadwal untuk memantau tugas migrasi tertentu. Anda juga dapat membuat tugas terjadwal kustom melalui percakapan:

Mulai tugas migrasi j-bp1xxx malam ini pukul 22:00 dan beri tahu saya saat selesai.
Periksa status semua sumber migrasi setiap hari pukul 9:00 dan beri peringatan jika ada anomali.

Anda dapat melihat tugas terjadwal yang Anda buat di konsol dasbor.

Perintah manajemen umum

# Daftar semua tugas terjadwal
smcclaw cron list

# Lihat detail tugas
smcclaw cron get <jobId>

# Jalankan tugas sekali segera
smcclaw cron run <jobId>

# Lihat riwayat eksekusi tugas
smcclaw cron runs --id <jobId>

# Aktifkan tugas yang dinonaktifkan
smcclaw cron enable <jobId>

# Nonaktifkan tugas (jeda tanpa menghapus)
smcclaw cron disable <jobId>

# Hapus tugas secara permanen
smcclaw cron remove <jobId>

Ekspresi Cron umum

Kebijakan keamanan

• Pengikatan Gateway: Gateway hanya mengikat ke alamat loopback lokal secara default. Untuk akses jarak jauh, gunakan saluran data SSH terlebih dahulu.

• Token Gateway: Token Gateway dan URL dasbor apa pun yang berisi token merupakan kredensial sensitif. Jangan bagikan atau simpan dalam tangkapan layar yang tidak disunting.

• Kode aktivasi: Kode aktivasi SMC merupakan kredensial sensitif. Berikan hanya di TUI lokal atau sesi dasbor pribadi, dan bersihkan dokumen, tangkapan layar, dan log secara berkala.

• Sumber perintah: Jangan kirimkan perintah dari sumber tidak dikenal ke AI. Verifikasi perintah lengkap dan path target sebelum menjalankan operasi destruktif.

• Kebijakan eksekusi: Kebijakan default adalah allowlist + on-miss: perintah apa pun di luar daftar izin memerlukan persetujuan. Kami merekomendasikan untuk tetap mengaktifkannya.

Untuk melihat konfigurasi keamanan, jalankan:

smcclaw config get tools.exec

Memulai dan menghentikan layanan

# Mulai layanan
smcclaw gateway start

# Hentikan layanan
smcclaw gateway stop

# Restart layanan
smcclaw gateway restart

# Periksa status layanan
smcclaw gateway status

Hapus Instalan Klien

• Linux: Jalankan perintah berikut untuk menguninstall klien.

  # Hapus layanan Gateway terlebih dahulu
  smcclaw gateway uninstall
  
  # Lalu hapus file program
  bash /opt/smcclaw/install.sh --uninstall

  Penting

  Jika Anda menggunakan direktori kustom saat instalasi, tentukan direktori --prefix yang sama saat menguninstall. Jika tidak, pembersihan akan gagal. Contoh: bash /usr/local/smcclaw/install.sh --prefix /usr/local/smcclaw --uninstall

• Windows: Jalankan smcclaw gateway uninstall untuk menghapus layanan Gateway, lalu hapus direktori SMCClaw yang diekstrak.

Bersihkan konfigurasi dan data

Jalankan perintah berikut untuk backup dan menghapus konfigurasi atau direktori kerja:

smcclaw backup create
smcclaw uninstall --dry-run
smcclaw uninstall

smcclaw uninstall menghapus layanan Gateway dan data lokal yang dipilih. Perintah ini tidak menghapus file program CLI. Untuk menghapus file program CLI, lihat menguninstall klien.

Kueri status dan diagnostik

# Lihat status runtime dan konfigurasi SMCClaw
smcclaw status

# Jalankan self-diagnostics untuk memeriksa lingkungan runtime
smcclaw doctor

# Lihat log runtime SMCClaw
smcclaw logs --follow

# Lihat status konfigurasi model AI saat ini
smcclaw models status

# Lihat status koneksi saluran pesan
smcclaw channels status

Bagaimana cara mendapatkan kode aktivasi?

1. Buka halaman Migrasi Server di konsol SMC.

2. Di halaman Server Migration, klik Import Source Servers.

3. Di halaman Import Source Servers, klik Use Client to Import Server.

4. Di halaman Import Migration Source, pilih Client Import.

5. Di Description, pilih jenis sistem operasi, lalu klik Generate.

6. Salin Access Token ID dan Access Token Code yang dihasilkan.

Bagaimana cara menyesuaikan direktori instalasi di Linux?

Secara default, skrip instalasi:

• Menginstal ke /opt/smcclaw.

• Membuat tautan simbolik di /usr/local/bin/smcclaw.

• Mencoba menginstal dependensi Python untuk kemampuan migrasi SMC.

Untuk menyesuaikan direktori instalasi, jalankan:

bash smcclaw-2026.7.1-linux-x64/install.sh --prefix /usr/local/smcclaw

Konfigurasi model lainnya

Direkomendasikan: Alibaba Cloud (Qwen Cloud)

Penyedia Qwen sudah terpasang bawaan. Pengaturan pertama tidak akan meminta Anda mengunduh plugin dari npm. Jika Anda melakukan upgrade dari versi lama yang mengunduh plugin Qwen secara otomatis, jalankan smcclaw doctor --fix terlebih dahulu untuk membersihkan catatan instalasi plugin lama. Pilih satu perintah berdasarkan rencana dan situs Anda:

Model utama lainnya

Setelah konfigurasi, periksa status:

smcclaw models status
smcclaw doctor

Bagaimana cara memeriksa penggunaan model?

Buka halaman penggunaan dasbor di http://127.0.0.1:18789/usage untuk melihat penggunaan token API dan biaya setiap model.

Dasbor menampilkan kegagalan koneksi. Apa yang harus saya lakukan?

Jika Anda melihat "Browser tidak dapat menyelesaikan koneksi Gateway. Periksa target dan transport sebelum mencoba ulang kredensial," periksa apakah token Gateway benar.

Balasan AI gagal dengan "Agent failed before reply." Apa yang harus saya lakukan?

Verifikasi bahwa konfigurasi model benar. Periksa apakah Anda menggunakan kunci API model yang salah atau nama provider/model yang salah.

Koneksi Gateway gagal. Apa yang harus saya lakukan?

1. Konfirmasi status layanan.

   Jalankan smcclaw gateway status untuk memeriksa apakah Gateway sedang berjalan.

2. Periksa port pendengar.

   Gateway mendengarkan pada port 18789 secara default. Periksa apakah port sedang digunakan, diblokir firewall, atau tidak didengarkan oleh Gateway.

3. Jalankan self-diagnostics lingkungan.

   Jalankan smcclaw doctor untuk memeriksa konfigurasi lingkungan terhadap masalah.

4. Lihat log runtime untuk menemukan penyebab kegagalan koneksi. Jalankan smcclaw logs --follow.

Panggilan model gagal. Apa yang harus saya lakukan?

1. Periksa apakah status model normal.

   smcclaw models status

2. Jalankan self-diagnostics lingkungan.

   smcclaw doctor

3. Lihat log runtime.

   smcclaw logs --follow

4. Verifikasi kunci API.

   Periksa apakah AccessKey valid, kedaluwarsa, atau dinonaktifkan.

Tugas terjadwal tidak berjalan. Bagaimana cara troubleshooting-nya?

1. Lihat daftar tugas.

   smcclaw cron list

   Konfirmasi bahwa tugas telah dibuat, diaktifkan, dan memiliki jadwal yang benar.

2. Lihat detail satu tugas.

   smcclaw cron get <jobId>

   Periksa aturan jadwal, waktu eksekusi terakhir, waktu eksekusi berikutnya, dan konfigurasi.

3. Konfirmasi status Gateway.

   smcclaw gateway status

   Tugas terjadwal dijadwalkan oleh Gateway. Jika Gateway tidak berjalan atau abnormal, tidak ada tugas terjadwal yang dipicu.

4. Periksa zona waktu server.

   Waktu eksekusi tugas bergantung pada zona waktu server. Jika zona waktu berbeda dari yang Anda harapkan, tugas berjalan pada waktu yang salah dan tampak tidak berjalan.

5. Lihat riwayat eksekusi.

   smcclaw cron runs --id <jobId>

Bagaimana cara menambahkan smcclaw ke PATH sistem di Windows?

Tambahkan path executable smcclaw ke variabel lingkungan PATH agar dapat dipanggil secara global dari command line. Berikut ini

Contoh menggunakan Windows Server 2022.

1. Klik kanan dan pilih System.

2. Cari dan buka View advanced system settings di panel navigasi kiri.

3. Di tab Advanced pada System Properties, klik Environment Variables.

4. Di bawah System variables, temukan variabel Path. Pilih, klik Edit, klik New, dan tambahkan C:\smcclaw\smcclaw-2026.7.1-win32-x64\bin.

5. Uji apakah variabel lingkungan dikonfigurasi dengan benar.

   • Klik kanan dan pilih Run. Masukkan PowerShell untuk membuka jendela PowerShell baru.

   • Jalankan smcclaw --version. Jika versi tool muncul, variabel lingkungan dikonfigurasi dengan benar.