Server Migration Center:SMC AI Agent Edition Client (Public Preview)

1. Adım: Ortamı hazırlama

1. Bir sunucu hazırlayın.

   • Linux: Alibaba Cloud SMC'ye ve seçtiğiniz büyük dil modeli (LLM) API'sine ulaşmak için genel ağ erişimi. x86_64 mimarisi, kernel 5.10 veya üzeri, Python 3.9 veya üzeri. Alibaba Cloud Linux 3, Ubuntu 22.04, Rocky Linux 9 veya sonraki sürümleri önerilir.

   • Windows: Alibaba Cloud SMC'ye ve seçtiğiniz LLM API'sine ulaşmak için genel ağ erişimi. x86_64 mimarisi, Windows Server 2016 veya üzeri. Windows Server 2016, Windows 10 veya sonraki sürümleri önerilir.

2. SMC etkinleştirilmiş bir Alibaba Cloud hesabı hazırlayın. SMC'nin kendisi ücretsizdir ancak geçiş sırasında kullanılan ara örnekler, cloud diskler ve ağ trafiği ücretlendirmeye tabi olabilir.

3. Bir LLM API anahtarı hazırlayın. Alibaba Cloud (Qwen Cloud) Token Plan veya Coding Plan önerilir.

2. Adım: İndirme ve yükleme

3. Adım: İstemciyi yapılandırma

1. LLM'yi yapılandırın.

   Tek tıkla kurulum (önerilen)

   Aşağıdaki örneklerde Coding Plan (Global) ve qwen/qwen3.7-plus modeli kullanılmıştır. Daha fazla plan ve model için bkz. Diğer model yapılandırmaları .

   Yalnızca bir plan kullanın. Tek bir setup komutunda birden çok model anahtarı belirtmeyin.

   Parametre	Açıklama
   <AccessToken ID>	SMC etkinleştirme kodunun AccessToken ID'si. Bunu elde etmek için bkz. etkinleştirme kodu alma.
   <AccessToken Code>	SMC etkinleştirme kodunun AccessToken Code'u. Bunu elde etmek için bkz. etkinleştirme kodu alma.
   <API_KEY>	Global API anahtarı için bkz. İlk API çağrısı.
   --model	Kullanılacak model, sağlayıcı/model biçiminde. Örneğin, --model "qwen/qwen3.7-plus".

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

   Önemli

   Etkinleştirme kodu hassas bir kimlik bilgisidir. Komutta doğrudan girmek kabuk geçmişinize kaydedilmesine neden olabilir. Kimlik bilgilerini güvenlik gereksinimlerinize göre yönetin.

   onboard ile etkileşimli kurulum

   Aşağıdaki örneklerde Coding Plan (Global) ve qwen/qwen3.7-plus modeli kullanılmıştır.

   1. Etkileşimli kurulumu başlatın.

      <AccessToken ID> ve <AccessToken Code> değerlerini elde etmek için bkz. etkinleştirme kodu alma.

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

      Önemli

      Etkinleştirme kodu hassas bir kimlik bilgisidir. Komutta doğrudan girmek kabuk geçmişinize kaydedilmesine neden olabilir. Kimlik bilgilerini güvenlik gereksinimlerinize göre yönetin.

   2. İstemleri takip edin:

      • Kurulum modu: OneClick

      • Model/kimlik doğrulama sağlayıcısı: Qwen Cloud (listede yoksa More seçeneğini belirleyin.)

      • Qwen Cloud kimlik doğrulama yöntemi: Global/Uluslararası için Coding Plan API Anahtarı

      • API anahtarı: Coding Plan API anahtarınızı girin.

      • Varsayılan model: qwen/qwen3.7-plus gibi bir model seçin.

2. smcclaw gateway status komutunu çalıştırın. running durumu, Gateway hizmetinin başladığı anlamına gelir.

4. Adım: Sohbet başlatma

Gateway varsayılan olarak 127.0.0.1:18789 adresini dinler ve üç sohbet giriş noktası sunar.

smcclaw tui

Migrate this server to the Alibaba Cloud Beijing region.
I need to migrate another cloud host over SSH.
I have an on-premises Windows server with no remote connection.

Zamanlanmış görevler

Geçiş başladığında SMCClaw varsayılan olarak belirtilen geçiş görevini izlemek için bir zamanlanmış görev oluşturur. Konuşma yoluyla özel zamanlanmış görevler de oluşturabilirsiniz:

Start migration task j-bp1xxx tonight at 22:00 and notify me when it finishes.
Check the status of all migration sources daily at 9:00 and alert me on anomalies.

Oluşturduğunuz zamanlanmış görevleri pano konsolunda görüntüleyebilirsiniz.

Yaygın yönetim komutları

# List all scheduled tasks
smcclaw cron list

# View details of a task
smcclaw cron get <jobId>

# Run a task once immediately
smcclaw cron run <jobId>

# View the execution history of a task
smcclaw cron runs --id <jobId>

# Enable a disabled task
smcclaw cron enable <jobId>

# Disable a task (pause without deleting)
smcclaw cron disable <jobId>

# Delete a task permanently
smcclaw cron remove <jobId>

Yaygın Cron ifadeleri

Güvenlik ilkeleri

• Gateway bağlama: Gateway varsayılan olarak yalnızca yerel geri dönüş adresine bağlanır. Uzaktan erişim için önce bir SSH tüneli kullanın.

• Gateway belirteci: Gateway belirteci ve belirteci içeren herhangi bir pano URL'si hassas kimlik bilgileridir. Bunları paylaşmayın veya kısaltılmamış ekran görüntülerinde tutmayın.

• Etkinleştirme kodu: SMC etkinleştirme kodu hassas bir kimlik bilgisidir. Bunu yalnızca yerel bir TUI'de veya özel bir pano oturumunda sağlayın ve belgeleri, ekran görüntülerini ve günlükleri düzenli olarak temizleyin.

• Komut kaynağı: Bilinmeyen kaynaklardan gelen komutları yapay zekaya göndermeyin. Yıkıcı bir işlemi çalıştırmadan önce tam komutu ve hedef yolu doğrulayın.

• Yürütme ilkesi: Varsayılan ilke allowlist + on-miss şeklindedir: izin listesi dışındaki herhangi bir komut onay gerektirir. Etkin bırakmanızı öneririz.

Güvenlik yapılandırmasını görüntülemek için şunu çalıştırın:

smcclaw config get tools.exec

Hizmeti başlatma ve durdurma

# Start the service
smcclaw gateway start

# Stop the service
smcclaw gateway stop

# Restart the service
smcclaw gateway restart

# Check the service status
smcclaw gateway status

İstemciyi kaldırma

• Linux: İstemciyi kaldırmak için aşağıdaki komutları çalıştırın.

  # Remove the Gateway service first
  smcclaw gateway uninstall
  
  # Then delete the program files
  bash /opt/smcclaw/install.sh --uninstall

  Önemli

  Yükleme sırasında özel bir dizin kullandıysanız, kaldırmak için aynı --prefix dizinini belirtin. Aksi takdirde temizleme başarısız olur. Örneğin: bash /usr/local/smcclaw/install.sh --prefix /usr/local/smcclaw --uninstall

• Windows: Gateway hizmetini kaldırmak için smcclaw gateway uninstall komutunu çalıştırın, ardından çıkarılan SMCClaw dizinini silin.

Yapılandırmayı ve verileri temizleme

Yapılandırmayı veya çalışma dizinini yedeklemek ve silmek için aşağıdaki komutları çalıştırın:

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

smcclaw uninstall komutu Gateway hizmetini ve seçilen yerel verileri kaldırır. CLI program dosyalarını silmez. CLI program dosyalarını silmek için bkz. istemciyi kaldırma.

Durum sorgulama ve tanılama

# View the SMCClaw runtime status and configuration
smcclaw status

# Run self-diagnostics to check the runtime environment
smcclaw doctor

# View the SMCClaw runtime logs
smcclaw logs --follow

# View the current AI model configuration status
smcclaw models status

# View the message channel connection status
smcclaw channels status

Etkinleştirme kodunu nasıl alırım?

1. SMC konsolundaki Sunucu Geçiş sayfasına gidin.

2. Server Migration sayfasında Import Source Servers öğesine tıklayın.

3. Import Source Servers sayfasında Use Client to Import Server öğesine tıklayın.

4. Import Migration Source sayfasında Client Import seçeneğini belirleyin.

5. Description bölümünde işletim sistemi türünü seçin, ardından Generate öğesine tıklayın.

6. Oluşturulan Access Token ID ve Access Token Code değerlerini kopyalayın.

Linux'ta yükleme dizinini nasıl özelleştiririm?

Varsayılan olarak yükleme betiği:

• /opt/smcclaw konumuna yüklenir.

• /usr/local/bin/smcclaw konumunda sembolik bir bağlantı oluşturur.

• SMC geçiş becerileri için Python bağımlılıklarını yüklemeye çalışır.

Yükleme dizinini özelleştirmek için şunu çalıştırın:

<version> değerini sürüm numarasıyla değiştirin. Örneğin, 2026.9.5.

bash ./smcclaw-<version>-linux-x64/install.sh --prefix /usr/local/smcclaw

Diğer model yapılandırmaları

Önerilen: Alibaba Cloud (Qwen Cloud)

Qwen sağlayıcısı yerleşiktir. İlk kurulum sırasında npm'den bir eklenti indirmeniz istenmez. Qwen eklentisini otomatik olarak indiren eski bir sürümden yükseltme yaptıysanız, eski eklenti yükleme kaydını temizlemek için önce smcclaw doctor --fix komutunu çalıştırın. Planınıza ve sitenize göre bir komut seçin:

Diğer ana akım modeller

Yapılandırmadan sonra durumu kontrol edin:

smcclaw models status
smcclaw doctor

Model kullanımını nasıl kontrol ederim?

Her modelin API belirteci kullanımını ve maliyetini görüntülemek için http://127.0.0.1:18789/usage adresindeki pano kullanım sayfasını açın.

Panoda bağlantı hatası gösteriliyor. Ne yapmalıyım?

"The browser cannot complete the Gateway connection. Check the target and transport before you retry the credentials" mesajını görürseniz Gateway belirtecinin doğru olup olmadığını kontrol edin.

Yapay zeka yanıtı "Agent failed before reply." hatasıyla başarısız oluyor. Ne yapmalıyım?

Model yapılandırmasının doğru olduğunu doğrulayın. Yanlış model API anahtarı veya provider/model adı kullanıp kullanmadığınızı kontrol edin.

Gateway bağlantısı başarısız oluyor. Ne yapmalıyım?

1. Hizmet durumunu onaylayın.

   Gateway'in çalışıp çalışmadığını kontrol etmek için smcclaw gateway status komutunu çalıştırın.

2. Dinleme bağlantı noktasını kontrol edin.

   Gateway varsayılan olarak 18789 numaralı bağlantı noktasını dinler. Bağlantı noktasının kullanımda olup olmadığını, bir güvenlik duvarı tarafından engellenip engellenmediğini veya Gateway tarafından dinlenip dinlenmediğini kontrol edin.

3. Ortam kendi kendini tanılama işlemini çalıştırın.

   Ortam yapılandırmasında sorun olup olmadığını kontrol etmek için smcclaw doctor komutunu çalıştırın.

4. Bağlantı hatasının nedenini bulmak için çalışma zamanı günlüklerini görüntüleyin. smcclaw logs --follow komutunu çalıştırın.

Model çağrısı başarısız oluyor. Ne yapmalıyım?

1. Model durumunun normal olup olmadığını kontrol edin.

   smcclaw models status

2. Ortam kendi kendini tanılama işlemini çalıştırın.

   smcclaw doctor

3. Çalışma zamanı günlüklerini görüntüleyin.

   smcclaw logs --follow

4. API anahtarını doğrulayın.

   AccessKey'in geçerli, süresi dolmuş veya devre dışı bırakılmış olup olmadığını kontrol edin.

Zamanlanmış bir görev çalışmadı. Nasıl sorun gideririm?

1. Görev listesini görüntüleyin.

   smcclaw cron list

   Görevin oluşturulduğunu, etkin olduğunu ve doğru zamanlamaya sahip olduğunu onaylayın.

2. Tek bir görevin ayrıntılarını görüntüleyin.

   smcclaw cron get <jobId>

   Zamanlama kuralını, son çalışma zamanını, bir sonraki planlanan çalışma zamanını ve yapılandırmayı kontrol edin.

3. Gateway durumunu onaylayın.

   smcclaw gateway status

   Zamanlanmış görevler Gateway tarafından planlanır. Gateway çalışmıyorsa veya anormal durumdaysa hiçbir zamanlanmış görev tetiklenmez.

4. Sunucu saat dilimini kontrol edin.

   Görev çalışma zamanları sunucu saat dilimine bağlıdır. Saat dilimi beklediğinizden farklıysa görevler yanlış zamanda çalışır ve çalışmamış gibi görünür.

5. Yürütme geçmişini görüntüleyin.

   smcclaw cron runs --id <jobId>

Windows'ta smcclaw'ı sistem PATH'ine nasıl eklerim?

Komut satırından genel olarak çağırmak için smcclaw yürütülebilir dosyasının yolunu PATH ortam değişkenine ekleyin. Aşağıdaki

Örnek, Windows Server 2022 kullanır.

1. öğesine sağ tıklayın ve System seçeneğini belirleyin.

2. Sol gezinme bölmesinde View advanced system settings öğesini arayıp açın.

3. System Properties penceresinin Advanced sekmesinde Environment Variables öğesine tıklayın.

4. System variables altında Path değişkenini bulun. Seçin, Edit öğesine tıklayın, New öğesine tıklayın ve C:\smcclaw\smcclaw-<version>-win32-x64\bin yolunu ekleyin.

   değerini sürüm numarasıyla değiştirin. Örneğin, 2026.9.5.

5. Ortam değişkeninin doğru yapılandırılıp yapılandırılmadığını test edin.

   • öğesine sağ tıklayın ve Run seçeneğini belirleyin. Yeni bir PowerShell penceresi açmak için PowerShell girin.

   • smcclaw --version komutunu çalıştırın. Araç sürümü görünüyorsa ortam değişkeni doğru yapılandırılmıştır.