OpenClaw Integration: Akses SatuTim dari WhatsApp/Telegram/dll

OpenClaw = personal AI assistant open-source yang bisa connect ke 50+ channel (WhatsApp, Telegram, Slack, Discord, LINE, Zalo, WeChat). Install satutim skill di OpenClaw kamu. Saat ini skill SatuTim untuk OpenClaw belum bisa membuat task dan belum bisa menampilkan "task hari ini", karena API SatuTim menolak permintaan dari skill versi sekarang. Yang sudah jalan: melihat daftar proyek, membuat dan melihat brief (di workspace pertama di akunmu; paket yang dibutuhkan bisa dicek di "Billing & Paket"), dan mengubah status task kalau kamu tahu ID task-nya (dari alamat app.satutim.id/tasks/<ID>).

  1. 1

    Apa itu OpenClaw + use case Indonesia

    OpenClaw adalah personal AI assistant open-source (215K+ GitHub stars, launched Feb 2026, awalnya namanya Clawdbot/Moltbot). Dijalankan di komputer/server sendiri, connect ke channel apa pun yang sering kamu pakai: WhatsApp, Telegram, Slack, Discord, LINE, Zalo, WeChat, dll. Kelebihan untuk konteks Indonesia: tim kerja kebanyakan udah pakai WhatsApp untuk koordinasi. Saat ini skill SatuTim untuk OpenClaw belum bisa membuat task dan belum bisa menampilkan "task hari ini", karena API SatuTim menolak permintaan dari skill versi sekarang. Yang sudah jalan: melihat daftar proyek, membuat dan melihat brief (di workspace pertama di akunmu; paket yang dibutuhkan bisa dicek di Billing & Paket), dan mengubah status task kalau kamu tahu ID task-nya (dari alamat app.satutim.id/tasks/<ID>). Cocok terutama untuk: agency yang sering ngomong via WA dengan klien (instant capture jadi task), founder/manager yang banyak meeting (voice memo → task), tim remote yang udah punya workflow chat-first.

    • OpenClaw bukan replacement SatuTim, dia gateway buat akses workspace dari channel lain
    • Token API SatuTim bertindak atas nama akunmu: token ini bisa mengakses semua workspace tempat kamu jadi anggota, sesuai peranmu di sana. Perlakukan seperti password, dan kalau bocor segera Revoke di halaman "API & Integrations".
    • Open-source: bisa self-host di laptop, VPS, atau di cloud, gak perlu trust third-party
  2. 2

    Install OpenClaw di komputer / server

    Install OpenClaw sendiri di luar scope tutorial ini, ikut docs resmi mereka di https://docs.openclaw.ai/install. Quick path: kalau pakai Mac, jalankan brew install openclaw/tap/openclaw. Linux: lihat installer script di GitHub repo openclaw/openclaw. Windows: WSL2 + ikut linux instructions. Setelah install, jalankan openclaw start, OpenClaw run sebagai background service. Connect channel pertama (WhatsApp paling common) lewat openclaw connect whatsapp, scan QR code dengan WA kamu, selesai.

    • Untuk produksi: deploy OpenClaw di VPS murah ($5/bulan) supaya 24/7 online
    • Multi-device: 1 instance OpenClaw bisa handle banyak channel sekaligus
    • Backup: simpan ~/.openclaw/workspace config supaya gampang restore
    Pastikan komputer / server yang jalanin OpenClaw selalu online, kalau offline, channel terputus (WhatsApp Web behavior).
  3. 3

    Connect channel pertama: WhatsApp / Telegram

    Setelah OpenClaw running, hubungkan ke channel chat kamu:

    • WhatsApp: openclaw connect whatsapp → tampil QR code di terminal → buka WA di HP → Settings → Linked Devices → Link a device → scan QR. Setelah itu OpenClaw sudah bisa baca dan balas pesan kamu.

    • Telegram: lebih simple, openclaw connect telegram → bakal kasih bot username untuk start chat dengan. /start ke bot itu, OpenClaw langsung terkoneksi.

    • Slack: login aman via web, openclaw connect slack → browser kebuka untuk authorize workspace Slack kamu.

    • Discord: bot token-based, daftar bot di Discord Developer Portal, paste token ke OpenClaw.

    Full list 50+ channels di docs.openclaw.ai/channels.

  4. 4

    Install satutim skill: ONE-LINER dari terminal

    Cara TERMUDAH (recommended): one-liner installer dari app.satutim.id. Buka terminal, jalankan:

    curl -sSL https://app.satutim.id/skills/install-openclaw.sh | SATUTIM_SKILL_URL=https://app.satutim.id/skills/satutim-openclaw.tar.gz bash

    Apa yang script lakukan:

    1. ✅ Cek dependencies (curl, tar, jq), kalau jq missing, kasih command brew/apt buat install
    2. 📥 Download satutim-openclaw.tar.gz dari app.satutim.id
    3. 📦 Extract ke ~/.openclaw/workspace/skills/satutim/
    4. 🔐 Set permission executable buat tools/*.sh
    5. 📋 Print 4 langkah next, buat API token, export env var, restart OpenClaw, test

    Kalau sudah ada install lama, otomatis di-backup ke .bak.<timestamp>, gak perlu uninstall manual.

    Alternative MANUAL (kalau gak mau pakai installer script):

    # Download + extract
mkdir -p ~/.openclaw/workspace/skills
curl -sSL https://app.satutim.id/skills/satutim-openclaw.tar.gz | \
  tar -xz -C ~/.openclaw/workspace/skills/
chmod +x ~/.openclaw/workspace/skills/satutim/tools/*.sh

    Direktori akhir setelah install:

    ~/.openclaw/workspace/skills/satutim/
├── SKILL.md          ← frontmatter + skill prompt (OpenClaw bacain ini)
├── README.md         ← user-facing docs
├── LICENSE           ← MIT-0
├── .clawhubignore
└── tools/
    ├── _common.sh    ← shared curl wrapper
    ├── satutim_help.sh
    ├── satutim_create_task.sh
    ├── satutim_list_tasks.sh
    ├── satutim_my_tasks_today.sh
    ├── satutim_update_task_status.sh
    ├── satutim_complete_task.sh
    ├── satutim_list_projects.sh
    ├── satutim_create_brief.sh
    ├── satutim_list_briefs.sh
    ├── satutim_create_topic.sh
    └── satutim_search.sh
    • Ukuran bundle sekitar 15 KB, download super cepat
    • OpenClaw auto-detect SKILL.md begitu file ditaruh di skills/ dir, gak perlu restart langsung
    • Custom install dir? Set env var sebelum jalankan installer: `OPENCLAW_SKILLS_DIR=/custom/path bash ...`
    Pastikan path ~/.openclaw/workspace/skills/ udah ada (OpenClaw bikin otomatis saat first run). Kalau belum, jalankan `openclaw start` dulu sekali.
  5. 5

    Buat API token SatuTim

    satutim skill butuh personal access token untuk akses workspace kamu. Cara:

    1. Login ke https://satutim.id → buka workspace yang mau di-akses
    2. Halaman API & Integrations belum ada di menu. Buka langsung https://app.satutim.id/settings/api (link satutim.id/settings/api juga diarahkan ke sana)
    3. Gulir syarat & ketentuan sampai paling bawah, lalu nyalakan switch Saya sudah membaca dan setuju dengan syarat & ketentuan (v2026-05-19).
    4. Klik tombol Aktifkan API. (Kalau kamu sudah punya token, tombol ini tidak muncul; pakai Regenerate untuk membuat token baru.)
    5. Token format stm_<random> muncul SEKALI. SALIN sekarang juga (clipboard), gak akan ditampilkan ulang.
    6. Belum bisa memberi nama atau label pada token. Token tampil sebagai Playground key dengan awalan token dan info Dipakai terakhir.

    Token bertindak atas nama akunmu dan bisa mengakses semua workspace tempat kamu jadi anggota. Token gak ada expiry default, kalau perlu rotasi, klik "Regenerate" buat key baru + revoke yang lama otomatis.

    JANGAN share token via channel publik. Treat kayak password. Kalau bocor, langsung revoke di settings/api.
  6. 6

    Setup env var di shell

    Export token sebagai env var supaya skill bisa baca:

    Mac/Linux (zsh/bash):

    echo 'export SATUTIM_API_KEY=stm_your_token_here' >> ~/.zshrc
source ~/.zshrc

    Windows (PowerShell):

    [Environment]::SetEnvironmentVariable('SATUTIM_API_KEY', 'stm_your_token_here', 'User')

    Then restart OpenClaw supaya pick up env var: openclaw restart.

    Optional env vars:
    • SATUTIM_API_BASE, default https://api.satutim.id/api/v1. Set kalau pakai self-hosted SatuTim atau staging.
    • SATUTIM_SKILL_HOST, default "openclaw", set ke nama host kamu kalau asistennya beda.

    Test setup: bash ~/.openclaw/workspace/skills/satutim/tools/satutim_list_projects.sh. Kalau muncul "SATUTIM_API_KEY belum di-set", env var belum terbaca, coba new terminal atau source ~/.zshrc lagi. Kalau muncul "ERROR: API key tidak valid", tokennya salah. Kalau daftar proyek tampil, setup sudah benar.

  7. 7

    First test: buat task pertama

    Dari channel yang udah connected (mis. WhatsApp), chat ke OpenClaw:

    > "Buatkan task: review proposal klien BCA, due besok, urgent"

    OpenClaw akan: (1) parse intent, detect ini "create task" command, (2) ambil tools dari satutim skill. Saat ini membuat task lewat skill OpenClaw belum berhasil. API SatuTim membalas error 400 karena skill belum mengirim proyek, tim dan workspace. Untuk sementara, buat task langsung di aplikasi SatuTim.

    • OpenClaw LLM smart enough to extract args dari natural language, gak perlu format ketat
    • Indonesian + English both work, "create task review proposal due tomorrow urgent" juga jalan
    • Multi-line: "buat task. judul: review proposal. deadline besok. priority urgent." juga ok
  8. 8

    Daftar 11 tools yang tersedia

    satutim skill expose 11 tools. Categorized:

    📋 TASKS (5 tools):
    • create_task, buat task baru
    • list_tasks, list task
    • my_tasks_today, task hari ini + overdue, grouped
    • update_task_status, ubah status
    • complete_task, shortcut mark done

    📝 BRIEFS (2 tools):
    • create_brief, buat brief baru dengan objective + deliverables
    • list_briefs, list briefs dengan filter

    📁 PROJECTS (1 tool):
    • list_projects, daftar semua project workspace

    💬 DISCUSSIONS (1 tool):
    • create_topic, post topik baru di discussion channel

    🔍 SEARCH + INFO (2 tools):
    • search, universal search di tasks/briefs/projects
    • help, print self-doc dengan semua tool

    Status tool saat ini: list_projects, create_brief, list_briefs, update_task_status, complete_task (butuh ID task), list_tasks (hanya kalau diberi project_id, dan filter assignee belum jalan) serta help bisa dipakai. create_task, my_tasks_today, search dan create_topic masih ditolak API.

    Full signature + arg lengkap: tanya OpenClaw "skill satutim bisa apa aja?", akan run satutim_help.sh.

  9. 9

    Sample workflows: template prompts

    Beberapa template prompt yang efektif:

    Morning standup (set as daily reminder):
    > "Task gw hari ini apa aja? Termasuk overdue."
    → Contoh "task hari ini" ini belum bisa dipakai lewat skill versi sekarang.

    Quick inbox capture (saat ide muncul):
    > "Catat: review desain banner Lebaran, due jumat, normal priority"
    → Membuat task lewat skill belum berhasil (lihat langkah First test). Catatan: skill hanya mengerti tanggal format YYYY-MM-DD, "hari ini", "besok", "lusa" dan "minggu depan".

    Client capture from WA chat:
    > "Klien minta tambahan revisi LP halaman utama, masukin task ke proyek redesign website"
    → list_projects bisa menampilkan proyek beserta ID-nya, tapi membuat task lewat skill masih gagal. Buat task-nya di aplikasi SatuTim.

    EOD wrap-up:
    > "Task review proposal udah done. Task design banner masih in progress."
    → Contoh "tandai selesai" ini belum bisa dipakai lewat skill versi sekarang. Untuk menandai selesai, kamu perlu ID task (dari alamat app.satutim.id/tasks/<ID>), lalu minta "tandai task <ID> selesai".

    Brief planning session:
    > "Buatkan brief kampanye Lebaran. Deliverables: banner sosmed, landing page, video 30 detik. Timeline 2 minggu mulai 1 Maret. Budget 50 juta."
    → Skill bisa membuat brief di workspace pertama (terlama) di akunmu (paket yang dibutuhkan bisa dicek di Billing & Paket). Sebelum menjalankan AI Triage, buka brief itu di aplikasi dan hubungkan ke Proyek dan Tim dulu.

    Quick search:
    > "Cari semua yang ngomong banner sosmed"
    → Contoh "cari …" ini belum bisa dipakai lewat skill versi sekarang.

  10. 10

    Multi-workspace handling

    Skill belum mendukung pemilihan workspace. Brief selalu masuk ke workspace pertama (terlama) di akunmu, dan daftar proyek menampilkan proyek dari semua workspace-mu. Saat ini mengganti token tidak memindahkan skill ke workspace lain. Kalau perlu bekerja di workspace lain, lakukan langsung di aplikasi SatuTim.

  11. 11

    Security best practices

    Token SatuTim sensitive, perlakukan kayak password:

    Rotasi reguler:
    Untuk rotasi berkala, buka halaman API & Integrations dan klik ikon Regenerate pada token. Token baru dibuat dan token lama langsung mati. Setelah itu update env var-mu.

    Revoke kalau perangkat hilang:
    Laptop hilang? Langsung ke /settings/api dari device lain → klik tombol revoke pada token yang dipakai laptop hilang. Token langsung dinonaktifkan, sisa request dari laptop hilang akan langsung ditolak.

    Audit log monitoring:
    Belum ada log aktivitas API per token. Yang bisa kamu pantau adalah info Dipakai terakhir pada token di halaman API & Integrations. Kalau token terlihat dipakai padahal bukan kamu, segera Revoke. (Audit Trail di Pengaturan → Fitur Business butuh paket Business dan hanya mencatat aksi admin tertentu.)

    Scope limit:
    Token yang bocor bisa dipakai mengakses semua workspace tempat kamu jadi anggota, jadi segera Revoke kalau curiga bocor. Tetap minimalistik usage: kalau OpenClaw kamu cuma butuh akses tasks (gak briefs), pembatasan akses per-fitur belum tersedia (rencana fase berikutnya). Untuk sekarang, scope token = scope akunmu.

    Env var safety:
    Jangan commit SATUTIM_API_KEY ke git. Jangan share screenshot terminal yang exposed env var. Pakai .env file dengan .gitignore.

    Rate limit:
    Saat ini belum ada batas jumlah request khusus per token API. Pesan "ERROR: Terlalu banyak request — slow down…" hanya muncul kalau server sedang membatasi permintaan (HTTP 429). Tunggu sebentar lalu coba lagi.

    Pantau info "Dipakai terakhir" pada token secara berkala. Token yang bocor bisa dipakai mengakses semua workspace tempat kamu jadi anggota, jadi segera Revoke kalau curiga bocor.
  12. 12

    Troubleshooting

    Common issues + fix:

    "ERROR: SATUTIM_API_KEY belum di-set"
    → Env var belum keload di OpenClaw process. Cek: echo $SATUTIM_API_KEY di terminal harus return value. Restart OpenClaw: openclaw restart.

    "ERROR: API key tidak valid"
    → Token salah, expired, atau di-revoke. Generate baru di /settings/api → update env var.

    "ERROR: Akses ditolak"
    → Pesannya berbentuk ERROR (403): <alasan>. Penyebab umum: kamu bukan anggota workspace itu, atau fiturnya butuh paket lebih tinggi (mis. fitur Brief; cek paket yang dibutuhkan di Billing & Paket). Cek plan workspace.

    "ERROR: Workspace tidak ditemukan untuk token ini"
    → Token valid tapi user gak punya workspace assigned. Cek di satutim.id user udah join workspace minimal 1.

    "ERROR: Terlalu banyak request, slow down"
    → Pesan ini muncul kalau server membalas 429 (terlalu banyak permintaan dalam waktu singkat). Tunggu sebentar lalu coba lagi atau combine multiple commands jadi satu prompt.

    "OpenClaw gak ngerti commandnya / panggil tool yang salah"
    → Update OpenClaw ke versi terbaru, LLM-side parsing improvements. Atau prompt lebih eksplisit: "use tool satutim_create_task: title=X, due=tomorrow".

    "jq: command not found"
    → Install jq. Mac: brew install jq. Ubuntu: apt install jq. ClawHub auto-install seharusnya, tapi kalau missing, manual install.

    "WhatsApp di-disconnect tiba-tiba"
    → WA Web protocol limitation, hanya 1 device aktif. Kalau buka WhatsApp Web di browser lain, OpenClaw di-disconnect. Reconnect via QR scan.

    Kalau masih stuck, hubungi support di /support/new dengan: error message lengkap, OpenClaw version, OS, skill version.

    OpenClaw skill = free buat semua plan (cuma butuh API token). Tapi feature SatuTim yang di-call ngikut plan workspace, mis. Brief management butuh Pro+.