Tutorial: Multi-Account Routing dengan OpenClaw

18 menit baca - Intermediate

Lo punya subscription Claude Max. Dapat 5 seats. Lo cuma pake 1.

Tim lo 4 orang. Instead of beli 4 API plan terpisah, lo mau semuanya akses Claude Max lewat subscription yang udah ada.

Atau lo punya beberapa bisnis. Tiap bisnis butuh AI assistant sendiri dengan personality sendiri, conversation history sendiri, tools sendiri. Tapi lo gak mau bayar 4 akun AI terpisah.

Atau lo agency. Kelola 12 clients. Tiap client butuh AI assistant sendiri. Semua harus isolated satu sama lain.

OpenClaw solve semua ini dengan built-in multi-agent system-nya.

Apa Sebenarnya Multi-Account Routing

Ada dua masalah berbeda yang sering orang campur aduk.

Masalah 1: Multiple AI Personas. Lo mau AI assistants berbeda untuk keperluan berbeda. Coding assistant. Marketing assistant. Research assistant. Tiap satu dengan personality dan memory sendiri.

Masalah 2: Multiple AI Accounts. Lo punya beberapa subscription seats dan mau distribute load di antaranya. Atau lo punya API keys berbeda untuk tiap client dan perlu billing terpisah.

OpenClaw handle kedua-duanya.

Gimana Cara Kerjanya

Agents

Agent itu adalah AI brain yang lengkap. Waktu lo install OpenClaw, lo dapet satu agent disebut main. Itu agent utama yang handle semua messages.

Tapi lo bisa create lebih banyak agents.

# Lihat agents yang lo punya
openclaw agents list

# Tambah agent baru untuk kerjaan
openclaw agents add work \
  --workspace ~/.openclaw/workspace-work

# Tambah agent untuk client
openclaw agents add client1 \
  --workspace ~/.openclaw/workspace-client1

Tiap agent dapet workspace directory sendiri. Di dalam workspace itu lo bisa taruh:

• SOUL.md - personality agent
• AGENTS.md - operating rules
• USER.md - context tentang siapa yang dilayanin
• Skills spesifik untuk agent itu
• Memory files

Workspace-workspace ini terpisah sepenuhnya. Even kalau lo accidentally expose file di satu workspace, agents lain gak bisa baca.

Channel Accounts

Tiap messaging channel (Telegram, Discord, WhatsApp) bisa punya beberapa accounts.

For Telegram, lo create beberapa bot tokens lewat BotFather. Tiap bot token jadi satu account.

# Set up work Telegram bot
openclaw channels login --channel telegram --account work

# Set up client Telegram bot
openclaw channels login --channel telegram --account client1

Sekarang lo punya dua Telegram accounts jalan bareng di Gateway yang sama.

Bindings

Bindings connect channel account ke agent.

# Route work Telegram bot ke work agent
openclaw agents bind \
  --agent work \
  --bind telegram:work

# Route client Telegram bot ke client1 agent
openclaw agents bind \
  --agent client1 \
  --bind telegram:client1

Waktu seseorang kirim message ke work bot lo, work agent yang handle. Waktu seseorang message client bot, client1 agent yang handle.

Verify bindings lo:

openclaw agents list --bindings

Lo harus lihat tabel yang nunjukin channel mana yang connected ke agent mana.

Contoh Setup Real: Agency Use Case

Ini cara small agency setup.

Step 1: Create Agent Workspaces

# Main agent - agency owner
# Udah ada sebagai 'main'

# Agent untuk client work
openclaw agents add client-ops \
  --workspace ~/.openclaw/workspace-client-ops

# Agent untuk internal tasks
openclaw agents add internal \
  --workspace ~/.openclaw/workspace-internal

Step 2: Set Up Channel Accounts

# Client-facing Telegram bot
openclaw channels login --channel telegram --account client-ops

# Internal team bot
openclaw channels login --channel telegram --account internal

# Discord untuk community
openclaw channels login --channel discord --account community

Step 3: Configure Bindings

openclaw agents bind --agent client-ops --bind telegram:client-ops
openclaw agents bind --agent internal --bind telegram:internal
openclaw agents bind --agent main --bind discord:community

Step 4: Configure Per-Agent Auth Profiles

Tiap agent butuh credentials API sendiri.

For the client-ops agent, lo set up API keys yang belong ke client itu. Waktu client-ops agent bikin AI request, dia pake client API key. Billing terpisah.

Auth profiles ada di:

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

File-file ini per-agent. Gak share credentials kecuali lo explicitly copy satu ke yang lain.

Step 5: Configure Per-Agent Skills

Lo mungkin mau skills berbeda tersedia untuk agents berbeda.

{
  "agents": {
    "defaults": {
      "skills": ["gmail-automation", "google-calendar-automation"]
    },
    "list": [
      {
        "id": "client-ops",
        "skills": ["crm-integration", "client-reporting", "gmail-automation"]
      },
      {
        "id": "internal",
        "skills": ["gitlab-automation", "jira-automation", "gmail-automation"]
      }
    ]
  }
}

defaults.skills nentuin apa yang semua agents dapet. Tiap agent di list dapet itu plus additions sendiri.

Multi-Account AI Routing: Pakai Subscription Seats

Bagian di atas itu channel account routing. Tapi gimana dengan AI provider side?

Kalau lo punya Claude Code Max subscription dengan 5 seats, lo mau semua 5 seats terpakai. Di sini proxy layer bantu.

CLIProxy: Rotate Across Multiple Subscription Accounts

CLIProxy nongkrong di antara OpenClaw dan AI providers. Dia terima requests terus distribute ke beberapa accounts.

Gimana CLIProxy works:

1. Lo configure dengan 5 Claude Code accounts dari Max subscription lo
2. Tiap account dapet API endpoint (localhost:3001, localhost:3002, dll)
3. CLIProxy rotate requests, atau route by API key hash
4. OpenClaw pointing ke CLIProxy sebagai AI backend
5. Subscription Max lo serve semua 5 agents

Setup:

# Install CLIProxy
npm install -g cliproxy

# Configure dengan 5 Claude Code accounts
cliproxy add-account --name seat1 --api-key "sk-ant-..."
cliproxy add-account --name seat2 --api-key "sk-ant-..."
cliproxy add-account --name seat3 --api-key "sk-ant-..."
cliproxy add-account --name seat4 --api-key "sk-ant-..."
cliproxy add-account --name seat5 --api-key "sk-ant-..."

# Start the proxy
cliproxy start --port 8080 --strategy round-robin

Then pointing OpenClaw ke CLIProxy:

# Set API base URL ke CLIProxy
export OPENAI_BASE_URL="http://localhost:8080/v1"
# Atau untuk Claude
export ANTHROPIC_BASE_URL="http://localhost:8080/v1"

Sekarang setiap OpenClaw agent route lewat CLIProxy. Proxy distribute load di 5 subscription seats lo secara otomatis.

Pakai API Keys Berbeda untuk Clients Berbeda

Kalau lo handle billing untuk beberapa clients, lo probably perlu tiap client billing terpisah.

# Set up CLIProxy dengan client-specific endpoints
cliproxy add-pool --name client-a \
  --endpoint http://localhost:3001 \
  --api-key "sk-ant-client-a..."

cliproxy add-pool --name client-b \
  --endpoint http://localhost:3002 \
  --api-key "sk-ant-client-b..."

Then di OpenClaw config, tiap agent pointing ke pool berbeda:

{
  "agents": {
    "list": [
      {
        "id": "client-a-ops",
        "model": "anthropic/claude-sonnet-4",
        "apiKey": "sk-ant-client-a..."
      },
      {
        "id": "client-b-ops", 
        "model": "anthropic/claude-sonnet-4",
        "apiKey": "sk-ant-client-b..."
      }
    ]
  }
}

Client A never touches client B's API key. Clean separation.

Troubleshooting

Messages pergi ke agent yang salah

Jalankan openclaw agents list --bindings dan check bindings lo. Most common issue adalah binding missing atau pointing ke agent yang salah.

Also check bot token Telegram lo bener. Kalau lo set up channel dengan bot token yang salah, binding bener tapi bot gak respond.

Agent gak respond sama sekali

Check workspace agent exists dan punya files yang diperlukan.

# Check if workspace exists
ls ~/.openclaw/workspace-<agent-name>/

# Check agent status
openclaw agents list

Kalau workspace kosong, agent mungkin fail to initialize. Check logs:

openclaw logs --lines 50

Auth errors dari AI provider

Tiap agent baca dari auth profiles sendiri. Kalau lo copy auth profiles dari satu agent ke yang lain, make sure API key valid dan belum expired.

Channel accounts gak routing dengan benar

For Telegram, make sure bot token match account name yang lo pake di binding.

# Check channel accounts
openclaw channels status

Kalau account menunjukkan disconnected, re-run login:

openclaw channels login --channel telegram --account work

Checklist: Setting Up Multi-Account Routing

Butuh VPS buat Jalankan Multiple Agents?

Lo butuh VPS yang nyala terus biar semua agents lo jalan 24/7 tanpa manage infrastructure sendiri.

Dapat SumoPod VPS - VPS hosting yang support multi-agent setups dan API proxy configuration, perfect buat agency atau team yang butuh beberapa AI assistants sekaligus.

Versi English yang lebih teknis available di GitHub:

Read English Version on GitHub - Full technical guide dengan diagram, troubleshooting, dan setup steps yang lebih detail.

Referensi

• Official OpenClaw Multi-Agent Routing Docs
• Agents CLI Reference
• Model Providers Configuration
• Channel Routing

Related Tutorials

• OpenClaw Gateway Setup Dari Nol - Set up Gateway lo sebelum configure multi-agent routing
• OpenClaw Session Maintenance Guide - Jaga multiple agents jalan smooth over time
• OpenClaw MCP Server Setup - Connect data sources ke multi-agent setup lo
• OpenClaw Cron Job Automation - Schedule tasks di beberapa agents sekaligus

Tutorial ini diverifikasi terhadap official OpenClaw documentation di docs.openclaw.ai.

Tutorial ini bagian dari project OpenClaw Sumopod - membuat automation accessible untuk UMKM Indonesia.

Last Updated: April 2026 Version: 1.0 Author: Radian IT Team