MCP

• menjalankan OpenClaw sebagai server MCP dengan openclaw mcp serve
• mengelola definisi server MCP keluar yang dikelola OpenClaw dengan list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload, dan unset

• serve adalah OpenClaw yang bertindak sebagai server MCP
• subperintah lainnya adalah OpenClaw yang bertindak sebagai registri sisi klien MCP untuk server MCP yang mungkin dikonsumsi runtime-nya nanti

​

Pilih jalur MCP yang tepat

​

OpenClaw sebagai server MCP

​

Kapan menggunakan serve

• Codex, Claude Code, atau klien MCP lain harus berbicara langsung dengan percakapan kanal yang didukung OpenClaw
• Anda sudah memiliki Gateway OpenClaw lokal atau jarak jauh dengan sesi yang dirutekan
• Anda menginginkan satu server MCP yang bekerja di seluruh backend kanal OpenClaw alih-alih menjalankan bridge terpisah per kanal

​

Cara kerjanya

​

Pilih mode klien

​

Apa yang diekspos serve

• channel
• metadata penerima atau tujuan
• accountId opsional
• threadId opsional

• mencantumkan percakapan terbaru yang dirutekan
• membaca riwayat transkrip terbaru
• menunggu peristiwa masuk baru
• mengirim balasan kembali melalui rute yang sama
• melihat permintaan persetujuan yang tiba saat bridge terhubung

​

Penggunaan

openclaw mcp serve

openclaw mcp serve --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

openclaw mcp serve --url wss://gateway-host:18789 --password-file ~/.openclaw/gateway.password

openclaw mcp serve --verbose
openclaw mcp serve --claude-channel-mode off

​

Alat bridge

​

Model peristiwa

• message
• exec_approval_requested
• exec_approval_resolved
• plugin_approval_requested
• plugin_approval_resolved
• claude_permission_request

​

Notifikasi kanal Claude

• notifications/claude/channel
• notifications/claude/channel/permission

• pesan transkrip user masuk diteruskan sebagai notifications/claude/channel
• permintaan izin Claude yang diterima melalui MCP dilacak dalam memori
• jika pemilik perintah dalam percakapan tertaut kemudian mengirim yes abcde atau no abcde, bridge mengonversinya menjadi notifications/claude/channel/permission
• notifikasi ini hanya untuk sesi langsung; jika klien MCP terputus, tidak ada target push

​

Konfigurasi klien MCP

{
  "mcpServers": {
    "openclaw": {
      "command": "openclaw",
      "args": [
        "mcp",
        "serve",
        "--url",
        "wss://gateway-host:18789",
        "--token-file",
        "/path/to/gateway.token"
      ]
    }
  }
}

​

Opsi

​

Keamanan dan batas kepercayaan

• allowlist pengirim, pairing, dan kepercayaan tingkat channel tetap menjadi bagian dari konfigurasi channel OpenClaw yang mendasarinya
• messages_send hanya dapat membalas melalui route tersimpan yang sudah ada
• status persetujuan hanya live/di memori untuk sesi bridge saat ini
• auth bridge harus menggunakan kontrol token atau kata sandi Gateway yang sama dengan yang Anda percayai untuk klien Gateway jarak jauh lainnya

​

Pengujian

pnpm test:docker:mcp-channels

• memulai kontainer Gateway dengan seed
• memulai kontainer kedua yang menjalankan openclaw mcp serve
• memverifikasi penemuan percakapan, pembacaan transkrip, pembacaan metadata lampiran, perilaku antrean event live, dan perutean pengiriman keluar
• memvalidasi notifikasi channel dan izin bergaya Claude melalui bridge MCP stdio nyata

​

Pemecahan masalah

​

OpenClaw sebagai registri klien MCP

​

Definisi server MCP tersimpan

• openclaw mcp list
• openclaw mcp show [name]
• openclaw mcp status [--verbose]
• openclaw mcp doctor [name] [--probe]
• openclaw mcp probe [name]
• openclaw mcp add <name> [flags]
• openclaw mcp set <name> <json>
• openclaw mcp configure <name> [flags]
• openclaw mcp tools <name> [--include csv] [--exclude csv] [--clear]
• openclaw mcp login <name> [--code code]
• openclaw mcp logout <name>
• openclaw mcp reload
• openclaw mcp unset <name>

• list mengurutkan nama server.
• show tanpa nama mencetak objek server MCP lengkap yang dikonfigurasi.
• status mengklasifikasikan transport yang dikonfigurasi tanpa terhubung. --verbose menyertakan detail launch, timeout, OAuth, filter, dan panggilan paralel yang telah di-resolve.
• doctor melakukan pemeriksaan statis tanpa terhubung. Tambahkan --probe ketika perintah juga harus memverifikasi bahwa server yang diaktifkan dapat terhubung.
• probe terhubung dan melaporkan jumlah tool, dukungan resource/prompt, dukungan perubahan daftar, dan diagnostik.
• add menerima flag stdio seperti --command, --arg, --env, dan --cwd, atau flag HTTP seperti --url, --transport, --header, --auth oauth, TLS, timeout, dan flag pemilihan tool.
• set mengharapkan satu nilai objek JSON pada baris perintah.
• configure memperbarui pengaktifan, filter tool, timeout, OAuth, TLS, dan petunjuk panggilan tool paralel tanpa mengganti seluruh definisi server.
• tools memperbarui filter tool per server. Entri include/exclude adalah nama tool MCP dan glob * sederhana.
• login menjalankan alur OAuth untuk server HTTP yang dikonfigurasi dengan auth: "oauth". Run pertama mencetak URL otorisasi; jalankan ulang dengan --code setelah persetujuan.
• logout menghapus kredensial OAuth tersimpan untuk server bernama tanpa menghapus definisi server yang tersimpan.
• reload membuang runtime MCP dalam proses yang di-cache. Proses Gateway atau agen di proses lain tetap memerlukan jalur reload atau restart mereka sendiri.
• Gunakan transport: "streamable-http" untuk server MCP Streamable HTTP. openclaw mcp set juga menormalkan type: "http" native CLI ke bentuk konfigurasi kanonis yang sama untuk kompatibilitas.
• unset gagal jika server bernama tidak ada.

openclaw mcp list
openclaw mcp show context7 --json
openclaw mcp status --verbose
openclaw mcp doctor --probe
openclaw mcp probe context7 --json
openclaw mcp add memory --command npx --arg -y --arg @modelcontextprotocol/server-memory
openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'
openclaw mcp tools context7 --include 'resolve-library-id,get-library-docs'
openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'
openclaw mcp configure docs --timeout 20 --connect-timeout 5 --include 'search,read_*'
openclaw mcp configure docs --auth oauth --oauth-scope 'docs.read'
openclaw mcp login docs
openclaw mcp logout docs
openclaw mcp unset context7

​

Resep server umum

openclaw mcp add files \
  --command npx \
  --arg -y \
  --arg @modelcontextprotocol/server-filesystem \
  --arg "$HOME/Documents" \
  --include 'read_file,list_directory,search_files'
openclaw mcp doctor files --probe

openclaw mcp add memory \
  --command npx \
  --arg -y \
  --arg @modelcontextprotocol/server-memory
openclaw mcp probe memory --json

openclaw mcp add local-tools \
  --command node \
  --arg ./dist/mcp-server.js \
  --cwd /srv/openclaw-tools \
  --env API_BASE=https://internal.example
openclaw mcp status --verbose

openclaw mcp add docs \
  --url https://mcp.example.com/mcp \
  --transport streamable-http \
  --auth oauth \
  --oauth-scope docs.read \
  --timeout 20 \
  --connect-timeout 5 \
  --include 'search,read_*'
openclaw mcp doctor docs --probe

openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
openclaw mcp tools cua-driver --include 'list_apps,observe,click,type'
openclaw mcp doctor cua-driver --probe

​

Bentuk keluaran JSON

{
  "path": "/home/user/.openclaw/openclaw.json",
  "servers": [
    {
      "name": "docs",
      "configured": true,
      "enabled": true,
      "ok": true,
      "transport": "streamable-http",
      "launch": "streamable-http https://mcp.example.com/mcp",
      "auth": "oauth",
      "authStatus": {
        "hasTokens": true,
        "hasClientInformation": true,
        "hasCodeVerifier": false,
        "hasDiscoveryState": true,
        "hasLastAuthorizationUrl": false
      },
      "requestTimeoutMs": 20000,
      "connectionTimeoutMs": 5000,
      "toolFilter": {
        "include": ["search", "read_*"],
        "exclude": []
      },
      "supportsParallelToolCalls": true
    }
  ]
}

{
  "ok": false,
  "path": "/home/user/.openclaw/openclaw.json",
  "servers": [
    {
      "name": "docs",
      "ok": false,
      "issues": [
        {
          "level": "error",
          "message": "OAuth credentials are not authorized; run openclaw mcp login docs"
        }
      ]
    }
  ]
}

{
  "path": "/home/user/.openclaw/openclaw.json",
  "generatedAt": "2026-05-31T09:00:00.000Z",
  "servers": {
    "docs": {
      "launch": "streamable-http https://mcp.example.com/mcp",
      "tools": 2,
      "resources": true,
      "prompts": false,
      "listChanged": {
        "tools": true,
        "resources": false,
        "prompts": false
      }
    }
  },
  "tools": ["docs__read_page", "docs__search"],
  "diagnostics": []
}

{
  "mcp": {
    "servers": {
      "context7": {
        "command": "uvx",
        "args": ["context7-mcp"]
      },
      "docs": {
        "url": "https://mcp.example.com",
        "transport": "streamable-http",
        "timeout": 20,
        "connectTimeout": 5,
        "supportsParallelToolCalls": true,
        "auth": "oauth",
        "oauth": {
          "scope": "docs.read"
        },
        "sslVerify": true,
        "clientCert": "/path/to/client.crt",
        "clientKey": "/path/to/client.key",
        "toolFilter": {
          "include": ["search_*"],
          "exclude": ["admin_*"]
        }
      }
    }
  }
}

​

Transport Stdio

​

Transport SSE / HTTP

{
  "mcp": {
    "servers": {
      "remote-tools": {
        "url": "https://mcp.example.com",
        "auth": "oauth",
        "timeout": 20,
        "headers": {
          "Authorization": "Bearer <token>"
        }
      }
    }
  }
}

​

Alur kerja OAuth

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"docs.read"}}'

openclaw mcp login docs

openclaw mcp login docs --code abc123

openclaw mcp status --verbose
openclaw mcp doctor docs --probe

openclaw mcp logout docs

​

Transport HTTP streamable

{
  "mcp": {
    "servers": {
      "streaming-tools": {
        "url": "https://mcp.example.com/stream",
        "transport": "streamable-http",
        "connectTimeout": 10,
        "timeout": 30,
        "headers": {
          "Authorization": "Bearer <token>"
        }
      }
    }
  }
}

​

UI Kontrol

1. Buka UI Kontrol dan pilih MCP.
2. Tinjau kartu ringkasan untuk total server, server yang diaktifkan, OAuth, dan server yang difilter.
3. Gunakan setiap baris server untuk petunjuk transport, autentikasi, filter, timeout, dan perintah.
4. Alihkan pengaktifan saat Anda ingin mempertahankan definisi tetapi mengecualikannya dari penemuan runtime.
5. Edit bagian konfigurasi mcp tercakup untuk perubahan struktural seperti server baru, header, TLS, metadata OAuth, atau filter alat.
6. Pilih Simpan untuk hanya menyimpan konfigurasi, atau Simpan & Publikasikan untuk menerapkannya melalui jalur konfigurasi Gateway.
7. Jalankan openclaw mcp doctor --probe saat Anda memerlukan bukti langsung bahwa server yang diedit mulai berjalan dan mencantumkan alat.

• cuplikan perintah mengapit nama server dengan tanda kutip agar nama yang tidak biasa tetap dapat disalin ke shell
• nilai mirip URL yang ditampilkan disunting sebelum dirender saat berisi kredensial tertanam
• halaman ini tidak memulai transport MCP dengan sendirinya
• runtime aktif mungkin memerlukan openclaw mcp reload, publikasi konfigurasi Gateway, atau mulai ulang proses, bergantung pada proses mana yang memiliki klien MCP

​

Batas saat ini

• penemuan percakapan bergantung pada metadata rute sesi Gateway yang sudah ada
• belum ada protokol push generik selain adapter khusus Claude
• belum ada alat edit pesan atau reaksi
• transport HTTP/SSE/streamable-http terhubung ke satu server jarak jauh; belum ada upstream multipleks
• permissions_list_open hanya mencakup persetujuan yang diamati saat bridge terhubung

​

Terkait

• Referensi CLI
• Plugin