All Products
Search

This Product

    Alibaba Cloud Linux:Penerapan satu perintah Openclaw/Claude Code

    Document Center

    Alibaba Cloud Linux:Penerapan satu perintah Openclaw/Claude Code

    Last Updated:Mar 28, 2026

    Latar Belakang

    • OpenClaw adalah framework agen AI sumber terbuka yang terhubung ke saluran komunikasi seperti DingTalk dan model bahasa besar seperti Qwen dari Model Studio melalui plugin.

    • Claude Code adalah asisten pengkodean berbasis AI dari Anthropic yang memungkinkan Anda berinteraksi dengan kode menggunakan bahasa alami di terminal.

    • Menginstal dan mengonfigurasi alat-alat ini pada instans ECS Agentic OS bisa menjadi tantangan karena beberapa alasan:

      1. OpenClaw memiliki struktur file konfigurasi yang tidak didokumentasikan, DingTalk bukan saluran resmi yang didukung, dan gerbang (gateway) memerlukan urutan inisialisasi yang ketat.

      2. Tutorial resmi Claude Code ditujukan untuk macOS dan Ubuntu, yang dapat menyebabkan masalah kompatibilitas dan error izin npm pada Alinux.

      3. Dokumentasi tentang cara mengonfigurasi kunci API DashScope tidak tersedia untuk kedua alat tersebut.

    • Dengan Skill, agen dapat menyelesaikan penerapan end-to-end hanya dalam satu perintah. Hal ini mengurangi proses yang biasanya sulit diotomatisasi atau memerlukan trial and error menjadi hanya beberapa menit.

    Kasus Penggunaan 1: Penerapan satu perintah OpenClaw

    Prasyarat

    • Anda memiliki instans ECS Agentic OS dengan RAM minimal 4 GB dan akses internet.

    • Anda telah membuat aplikasi enterprise internal di DingTalk Developer Console dan memperoleh AppKey serta AppSecret.

    Penting: Di DingTalk Developer Console, aktifkan Bot Capability untuk aplikasi Anda dan atur Message Reception Mode ke Stream mode. Anda juga harus mengaktifkan izin berikut: Card.Streaming.Write, Card.Instance.Write, dan qyapi_robot_sendmsg.

    • Anda telah memperoleh kunci API DashScope dari Konsol Model Studio.

    • Anda dapat mengaktifkan mode YOLO untuk menghindari konfirmasi manual perintah shell (/approval-mode yolo).

    Prosedur

    Langkah 1: Jalankan perintah penerapan

    1. Di terminal Agentic OS, kirim perintah berikut ke agen:

    Install OpenClaw with AppKey <appkey>, AppSecret <appsecret>, and API key <dashscope apikey>

    1. Agen secara otomatis melakukan tindakan berikut:

      • Mendeteksi dan menginstal lingkungan runtime Node.js.

      • Menginstal OpenClaw dan plugin DingTalk melalui npm, secara otomatis menambahkan registri npmmirror untuk mempercepat unduhan di Tiongkok daratan.

      • Menginisialisasi struktur proyek dan file konfigurasi OpenClaw.

      • Mengonfigurasi mode gerbang (gateway.mode).

      • Menjalankan openclaw doctor --fix untuk menghasilkan token otentikasi.

    Penting: Urutan inisialisasi gerbang sangat kritis. Konfigurasi gateway.mode harus ditulis sebelum Anda menjalankan openclaw doctor --fix. Skill telah menyertakan urutan ini, sehingga tidak diperlukan intervensi manual.

    Langkah 2: Validasi penerapan

    1. Setelah penerapan selesai, temukan bot di DingTalk dan kirim pesan uji coba.

    2. Balasan yang benar dari bot menandakan penerapan end-to-end berhasil.

    Catatan

    • Jika gerbang gagal dimulai selama penerapan, periksa apakah urutan inisialisasi sudah benar.

    • Jika bot DingTalk tidak merespons, verifikasi bahwa semua izin aplikasi yang diperlukan, seperti Card.Instance.Write dan Card.Streaming.Write, telah diaktifkan.

    Kasus Penggunaan 2: Penerapan satu perintah Claude Code

    Prasyarat

    • Anda memiliki instans ECS Agentic OS dengan RAM minimal 4 GB dan akses internet.

    Penting: Claude Code memiliki beban memori tinggi saat waktu proses. Pastikan instans ECS Anda memiliki RAM minimal 4 GB.

    • Anda telah memperoleh kunci API DashScope dari Konsol Model Studio (jika Anda perlu mengonfigurasi API pihak ketiga).

    • Anda dapat mengaktifkan mode YOLO untuk menghindari konfirmasi manual perintah shell (/approval-mode yolo).

    Prosedur

    Langkah 1: Jalankan perintah instalasi

    1. Di terminal Agentic OS, kirim perintah berikut ke agen:

    Install Claude Code and configure the DashScope API key: <dashscope apikey>

    1. Agen secara otomatis mendeteksi lingkungan sistem Anda dan memilih metode instalasi terbaik dalam urutan berikut:

      • Instalasi native: Mencoba menginstal menggunakan manajer paket native sistem terlebih dahulu.

      • Instalasi npm: Jika instalasi native tidak tersedia, menginstal secara global melalui npm dan secara otomatis memperbaiki masalah izin EACCES.

      • Instalasi nvm: Jika instalasi npm gagal, menggunakan nvm untuk menginstal lingkungan Node.js terisolasi sebelum menginstal.

    Catatan: Proses instalasi secara otomatis beralih melalui metode-metode ini tanpa intervensi manual. Skill menangani masalah kompatibilitas pada Alinux 4, termasuk perbaikan izin EACCES.

    Langkah 2: Validasi instalasi

    Agen menjalankan perintah berikut untuk memverifikasi instalasi:

    claude --version

    image.png

    Langkah 3: Konfigurasi kunci API DashScope

    1. Agen secara otomatis mengonfigurasi kunci API DashScope untuk Claude Code.

    2. Jalankan Claude Code dan uji apakah Anda dapat berinteraksi dengan model.

    image.png

    Catatan

    • Peroleh kunci API DashScope Anda dari Konsol Alibaba Cloud Model Studio dan aktifkan layanan yang diperlukan terlebih dahulu.

    • Jika semua metode instalasi gagal, periksa konektivitas jaringan dan versi Node.js Anda. Kami merekomendasikan menggunakan versi 18 atau lebih baru.