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, lalu manage workspace SatuTim langsung dari chat: "buatin task review proposal", "task gw hari ini apa?", dll.

  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, dengan OpenClaw + satutim skill, kamu bisa create/update task langsung dari WA tanpa buka app SatuTim. 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 SatuTim scope per-workspace, gak ke seluruh akun, relatively safe kalau bocor
    • 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 satutim.id. Buka terminal, jalankan:

    curl -sSL https://satutim.id/skills/install-openclaw.sh | 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 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
curl -sSL https://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
    • Tarball size ~6KB, 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. Sidebar: Settings → "API & Integrations" (atau langsung https://satutim.id/settings/api)
    3. Accept Terms of Service kalau pertama kali, scroll baca, centang setuju
    4. Klik tombol "Buat token baru"
    5. Token format stm_<random> muncul SEKALI. SALIN sekarang juga (clipboard), gak akan ditampilkan ulang.
    6. Optional: kasih label untuk inget (mis. "OpenClaw, laptop kerja")

    Token scope: workspace-level (cuma akses workspace ini, bukan multi-workspace). 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_help.sh, harus tampil list semua tool. Kalau error "SATUTIM_API_KEY belum di-set", env var belum keload, coba new terminal atau source ~/.zshrc lagi.

  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, (3) invoke satutim_create_task.sh "review proposal klien BCA" "" "@me" "besok" "urgent", (4) reply ke kamu dengan ✅ Task tercipta + URL.

    Klik URL di chat → langsung buka task di satutim.id. Verify task ter-create di workspace + assigned ke kamu + due date besok + priority urgent.

    • 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 dengan filter (status/assignee/project)
    • 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

    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."
    → invokes satutim_my_tasks_today.sh → grouped overdue + today list.

    Quick inbox capture (saat ide muncul):
    > "Catat: review desain banner Lebaran, due jumat, normal priority"
    → creates task with proper due date parsing.

    Client capture from WA chat:
    > "Klien minta tambahan revisi LP halaman utama, masukin task ke proyek redesign website"
    → list_projects → pick "Redesign Website" → create_task dengan project_id.

    EOD wrap-up:
    > "Task review proposal udah done. Task design banner masih in progress."
    → search → complete_task untuk yang done, update_task_status untuk in_progress.

    Brief planning session:
    > "Buatkan brief kampanye Lebaran. Deliverables: banner sosmed, landing page, video 30 detik. Timeline 2 minggu mulai 1 Maret. Budget 50 juta."
    → creates structured brief, lalu kamu bisa buka URL untuk run AI Triage.

    Quick search:
    > "Cari semua yang ngomong banner sosmed"
    → universal search → list hasil.

  10. 10

    Multi-workspace handling

    Token SatuTim scope per-workspace, jadi satu skill instance = satu workspace. Kalau punya multi-workspace:

    Option 1, Manual switch via env var:

    # Switch ke workspace A
export SATUTIM_API_KEY=stm_workspaceA_token
openclaw restart

# Later, switch ke workspace B
export SATUTIM_API_KEY=stm_workspaceB_token
openclaw restart

    Downside: tedious, gak bisa parallel.

    Option 2, OpenClaw profiles (advanced):
    OpenClaw support multiple profiles via OPENCLAW_PROFILE env var. Buat 2 profile (workA, workB), masing-masing dengan SATUTIM_API_KEY berbeda. Switch profile via openclaw use workA. Skill aktif sesuai profile.

    Option 3, Skill instance per workspace (cleanest, recommended):
    Install skill 2x dengan nama beda:

    clawhub install satutim --as satutim-workA
clawhub install satutim --as satutim-workB

    Masing-masing skill instance pakai env var beda. Saat ngomong ke OpenClaw, spesifikasi: "buatkan task di workspace A: ..."

    • Recommendation: option 3, paling clean untuk frequent multi-workspace user
    • Workspace name harus unique slug, gak boleh ada karakter aneh
  11. 11

    Security best practices

    Token SatuTim sensitive, perlakukan kayak password:

    Rotasi reguler:
    Every 90 days, generate token baru di /settings/api → revoke yang lama. Update env var.

    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:
    Workspace owner bisa lihat /settings/audit, semua aktivitas API kelihatan: waktu, perangkat, dan jenis aksi. Kalau ada aktivitas mencurigakan dari perangkat gak dikenal, revoke token.

    Scope limit:
    Token scope workspace-level, kompromi cuma 1 workspace, bukan akun penuh. 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 workspace.

    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:
    Default 100 request/jam per token, fair use untuk normal interaction. Kalau melebihi limit, OpenClaw akan kasih pesan "terlalu banyak request".

    Workspace owner harus monitor audit log secara berkala, bocor token = bocor whole workspace access.
  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"
    → Permission denied. Common cause: user gak member workspace, atau feature plan-gated (mis. Brief = Pro+). 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"
    → Rate limit kena (100/jam). Tunggu 1 menit 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+.