Configuration
チャネル位置情報の解析
OpenClaw は、チャットチャネルから共有された位置情報を次の形式に正規化します。
- 受信本文に追加される簡潔な座標テキスト
- 自動返信コンテキストペイロード内の構造化フィールド。チャネルから提供されたラベル、住所、キャプション／コメントは、ユーザー本文に直接挿入されるのではなく、共有の信頼されていないメタデータ JSON ブロックによってプロンプトにレンダリングされます。
現在サポートされているもの：
- LINE（タイトル／住所を含む位置情報メッセージ）
- Matrix（
geo_uriを含むm.location） - Telegram（位置情報ピン、会場、ライブ位置情報）
- WhatsApp（
locationMessageとliveLocationMessage）
テキスト形式
位置情報は、角括弧を使用せず、読みやすい行としてレンダリングされます。座標は小数点以下 6 桁で表示され、精度はメートル単位の整数に丸められます。
- ピン：
📍 48.858844, 2.294351 ±12m
- 名前付きの場所（同じ行。名前／住所はメタデータブロックのみに格納）：
📍 48.858844, 2.294351 ±12m
- ライブ共有：
🛰 Live location: 48.858844, 2.294351 ±12m
チャネルにラベル、住所、キャプション／コメントが含まれている場合、それらはコンテキストペイロードに保持され、フェンスで囲まれた信頼されていない JSON としてプロンプトに表示されます（存在しないフィールドは省略されます）。
位置情報（信頼されていないメタデータ）：```json{ "latitude": 48.858844, "longitude": 2.294351, "accuracy_m": 12, "source": "place", "name": "エッフェル塔", "address": "シャン・ド・マルス、パリ", "caption": "ここで会いましょう"}```コンテキストフィールド
位置情報が存在する場合、次のフィールドが ctx に追加されます。
LocationLat（数値）LocationLon（数値）LocationAccuracy（数値、メートル単位、省略可）LocationName（文字列、省略可）LocationAddress（文字列、省略可）LocationSource（pin | place | live）LocationIsLive（真偽値）LocationCaption（文字列、省略可）
チャネルでソースが明示的に設定されていない場合、OpenClaw が推測します。ライブ共有は live、名前または住所を含む位置情報は place、それ以外はすべて pin になります。
プロンプトレンダラーは LocationName、LocationAddress、LocationCaption を信頼できないメタデータとして扱い、ほかのチャネルコンテキストと同じサイズ制限付き JSON パスを介してシリアライズします。
送信ペイロード
メッセージツールと Plugin SDK は、移植可能な送信位置情報に同じ NormalizedLocation 形式を使用します。座標のみのペイロードはピンを表します。ネイティブの施設情報をサポートするチャネルでは、name と address を施設カードにマッピングできます。
Telegram では現在、message(action="send") を通じてこの機能を提供しています。最初の実装は意図的に独立したものになっています。位置情報ペイロードをテキストやメディアと組み合わせることはできず、不完全な施設情報の組み合わせは、名前や住所を暗黙に破棄するのではなくエラーになります。サポートされていないチャネルでは、位置情報パラメーターは公開されません。
チャネルに関する注記
- LINE：位置情報メッセージの
title/addressはLocationName/LocationAddressにマッピングされます。ライブ位置情報はありません。 - Matrix：
geo_uriはピン位置情報として解析されます。u（不確実性）パラメーターはLocationAccuracyにマッピングされ、イベント本文がLocationCaptionに設定されます。高度は無視され、LocationIsLiveは常に false です。 - Telegram：施設情報は
LocationName/LocationAddressにマッピングされます。ライブ位置情報はlive_periodによって検出されます。 - WhatsApp：
locationMessage.commentとliveLocationMessage.captionがLocationCaptionに設定されます。
