OpenClaw & AI Operasional

Error @larksuiteoapi/node-sdk di OpenClaw v2026.4.21: Cara Fix Cepat

Tutorial cepat memperbaiki error Cannot find module @larksuiteoapi/node-sdk di OpenClaw v2026.4.21, lengkap dengan penyebab, issue resmi GitHub, dan langkah fix praktis di server.
Featured image

Error Cannot find module '@larksuiteoapi/node-sdk' di OpenClaw v2026.4.21: Cara Fix Cepat

Kalau OpenClaw habis update ke v2026.4.21 lalu berhenti di wizard atau setup model dengan error seperti ini:

Error: Cannot find module '@larksuiteoapi/node-sdk'
Require stack:
- .../openclaw/dist/extensions/feishu/client-*.js

masalahnya hampir pasti bukan di model yang Anda pilih, tapi di dependency plugin bawaan yang tidak ikut terpasang rapi pada paket npm global.

Ini bug yang memang sempat kena di jalur rilis OpenClaw v2026.4.21, dan sudah dilaporkan resmi di GitHub OpenClaw.

Intinya apa?

Pada sebagian install global npm install -g [email protected], beberapa dependency runtime untuk extension bawaan seperti Feishu/Lark dan Nostr bisa hilang. Akibatnya, saat OpenClaw memuat extension terkait -- bahkan ketika user sedang setup provider lain -- proses bisa crash dengan error Cannot find module ....

Fakta resmi dari issue tracker

Dari issue resmi OpenClaw:

  • #70198 menyebut ada missing dependencies untuk extension seperti Feishu dan Nostr di global install 2026.4.21.
  • #70398 menunjukkan error @larksuiteoapi/node-sdk bahkan bisa muncul meskipun user tidak sedang memakai Feishu.
  • #70457 mengonfirmasi bug ini masih relevan pada jalur install global terbaru dan bisa mengenai environment fresh di macOS maupun Ubuntu.

Artinya, ini bug packaging/runtime dependency, bukan salah config model seperti zai/glm-5.1, Ollama, atau provider lain yang sedang dipilih saat error muncul.

Kenapa bisa terjadi?

Secara praktis, runtime OpenClaw mencoba memuat extension bawaan dari bundle dist/extensions/..., tetapi module yang dibutuhkan extension tersebut tidak selalu tersedia di global install aktif.

Contoh yang paling sering muncul:

  • @larksuiteoapi/node-sdk
  • nostr-tools

Di beberapa laporan user, modul lain juga ikut nyangkut tergantung jalur plugin yang ikut termuat.

Cara fix cepat

1) Pasang module yang hilang

Untuk kasus yang paling umum, jalankan:

npm install -g @larksuiteoapi/node-sdk

Kalau setelah itu muncul error lain untuk nostr-tools, lanjutkan:

npm install -g nostr-tools

Dalam beberapa environment, ada juga jalur runtime lain yang butuh dependency tambahan. Kalau error berikutnya menyebut modul lain, pasang modul itu juga secara global sesuai nama package di pesan error.

Fix yang lebih aman untuk environment yang sering kena

Kalau Anda ingin sekalian menutup beberapa jalur dependency yang paling sering muncul di keluarga bug ini, bisa pasang beberapa package runtime yang umum dilaporkan sekaligus:

npm install -g @larksuiteoapi/node-sdk nostr-tools @slack/web-api @whiskeysockets/baileys

Ini bukan akar fix resmi dari maintainer, tetapi cukup efektif sebagai workaround di host yang sudah terlanjur memakai paket 2026.4.21 dari npm global install.

2) Restart gateway OpenClaw

Setelah package terpasang, restart service/gateway:

openclaw gateway restart

Kalau OpenClaw dijalankan sebagai service, pastikan servicenya memang balik aktif.

3) Verifikasi hasilnya

Cek minimal tiga hal ini:

openclaw --version
openclaw gateway status
openclaw health

Hasil yang dicari:

  • versi tetap terbaca normal,
  • gateway status = running,
  • health check = ok,
  • wizard/setup tidak lagi jatuh di Cannot find module '@larksuiteoapi/node-sdk'.

Kalau error masih pindah ke modul lain

Kalau setelah memasang @larksuiteoapi/node-sdk error pindah ke modul lain, jangan panik. Itu biasanya berarti host Anda kena varian bug yang sama, hanya extension yang gagal dimuat berbeda.

Pola baca error-nya sederhana:

  1. lihat nama package yang hilang di pesan Cannot find module '...'
  2. install package itu secara global
  3. restart gateway
  4. tes lagi

Apakah ini sudah fixed resmi?

Ya, tapi pada saat artikel ini ditulis, fix-nya sudah disebut maintainer sebagai fixed di main, sementara rilis npm yang terdampak (v2026.4.21) masih bisa kena.

Jadi kalau Anda sedang pakai 2026.4.21 dan melihat error ini, itu masih konsisten dengan laporan resmi upstream.

Kesimpulan operasional

Kalau habis update ke OpenClaw v2026.4.21 lalu setup berhenti di error @larksuiteoapi/node-sdk, fokus dulu ke dependency runtime extension, bukan ke model/provider.

Urutan aman yang paling praktis:

  1. install @larksuiteoapi/node-sdk
  2. kalau perlu install nostr-tools
  3. restart gateway
  4. verifikasi gateway status dan health

Kalau Anda mengelola beberapa server, simpan workaround ini sebagai playbook sementara sampai rilis OpenClaw berikutnya membawa fix resmi ke paket npm publik.

Baca juga

Referensi resmi

31 Views
0 Likes
0 Shares
Estimasi waktu baca: 3 menit

Tentang Penulis

Rama Aditya

Rama Aditya

Digital Marketing Strategist
Fullstack Engineer
Business Consultant

Profesional dengan pengalaman 15+ tahun dalam digital marketing, fullstack development, dan konsultasi bisnis. Fokus membantu bisnis Indonesia membangun sistem yang efisien, scalable, dan berdampak langsung ke pertumbuhan bisnis.

Pelajari Tentang Kami
RD
Rama Digital

Spesialis integrasi sistem marketing dan modernisasi aplikasi untuk pebisnis Indonesia. Membantu UMKM dan perusahaan scale dengan teknologi modern.

Contact

  • [email protected]
  • +62 851-2617-8958
  • Park 23 Creative Hub, 3rd Floor
    Jl. Kediri, Tuban, Kuta, Badung
    Bali 80361
  • 9:00 - 18:00 WIB

Mulai Project

Siap optimasi bisnis Anda dengan teknologi modern? Konsultasi gratis sekarang.

Konsultasi Gratis