kmsgをOpenClawとMCPクライアントへ接続

kmsgをOpenClawや他のMCPクライアントへ安全に接続する基本構成を説明します。

基本モデル

連携には2つの独立したインターフェースがあります。

リクエスト／レスポンス: kmsg mcp-server
リアルタイムイベント: kmsg watch --json

MCPサーバーはkmsg_read、kmsg_send、kmsg_send_imageを提供します。watchはMCPツールではないため、リアルタイム自動応答にはイベントをOpenClawへ渡すsupervisorが必要です。

推奨構成

kmsg watch --json
    ↓ one JSON object per event
supervisor / OpenClaw
    ↓ reasoning and approval
kmsg_send through MCP

長時間の監視ストリームと短いMCP呼び出しを分けることで、再起動やエラー処理を独立して管理できます。

事前確認

kmsg status --verbose
kmsg chats --limit 20
kmsg send "チャット名" "接続テスト" --dry-run

MCP設定

kmsg mcp-server

クライアント設定例:

{
  "mcpServers": {
    "kmsg": {
      "command": "/absolute/path/to/kmsg",
      "args": ["mcp-server"],
      "env": {
        "KMSG_MCP_TIMEOUT_SECONDS": "30",
        "KMSG_DEFAULT_LAYOUT": "preserve",
        "KMSG_DEFAULT_BACKGROUND_SAFE": "true"
      }
    }
  }
}

リアルタイム監視

kmsg watch "チャット名" --json

イベントごとに1つのJSONをstdoutへ出力し、診断ログはstderrへ分離します。supervisorは重複排除、再起動、承認ルールを担当します。

ツール契約

`kmsg_read`

{
  "name": "kmsg_read",
  "arguments": {
    "chat": "チャット名",
    "limit": 20,
    "background_safe": true
  }
}

background_safe=trueは、すでに表示されている一致ウィンドウだけを読みます。KakaoTalkの起動、アクティブ化、ログイン、検索、ウィンドウ操作は行いません。

`kmsg_send`

{
  "name": "kmsg_send",
  "arguments": {
    "chat": "チャット名",
    "message": "こんにちは",
    "confirm": true
  }
}

confirm=true: 送信せずCONFIRMATION_REQUIREDを返す
confirm=falseまたは省略: 即時送信
dry_run=true: UIを操作せず対象と内容を確認

`kmsg_send_image`

{
  "name": "kmsg_send_image",
  "arguments": {
    "chat": "チャット名",
    "image_path": "/absolute/path/image.png",
    "confirm": true
  }
}

運用モード

推奨: 下書き後に承認

kmsg_readまたはwatchイベントで文脈を取得
AIエージェントが返信案を作成
人またはポリシーエンジンが宛先と内容を確認
承認済みの呼び出しだけをconfirm=falseで送信

個人チャットでは誤送信の影響が大きいため、この流れを推奨します。

完全自動応答

許可するチャット、送信頻度、再試行回数、最大文字数、禁止語、緊急停止をsupervisor側で制限した場合だけ使用してください。

トラブルシューティング

commandには実行可能なkmsgの絶対パスを指定
kmsg status --verboseで権限とKakaoTalk状態を確認
background-safeで失敗する場合は対象チャットを先に表示
1つの接続内ではMCPフレーム方式を混在させない

全フィールドと応答例は英語版OpenClawガイドを参照してください。