Tlon

Tlon は Urbit 上に構築された分散型メッセンジャーです。OpenClaw は Urbit ship に接続し、 DM とグループチャットのメッセージに応答します。グループでの返信にはデフォルトで @ メンションが必要で、 さらに認可ルールとオーナー承認フローが適用されます。

状態: バンドル済み Plugin。DM、グループメンション、スレッド、リッチテキスト、画像のアップロードとダウンロード、 およびオーナー承認システムに対応しています。リアクションと投票には対応していません。

バンドル済み Plugin

現在の OpenClaw リリースには Tlon がバンドルされているため、パッケージ版ビルドでは個別にインストールする必要はありません。

Tlon を含まない古いビルドまたはカスタムインストールでは、npm からインストールします。

openclaw plugins install @openclaw/tlon

現在のリリースタグを追跡するには、バージョンなしのパッケージ名を使用します。バージョンを固定する （@openclaw/tlon@x.y.z）のは、再現可能なインストールが必要な場合のみにしてください。

ローカルチェックアウトからインストールする場合:

openclaw plugins install ./path/to/local/tlon-plugin

詳細: Plugin

セットアップ

openclaw channels add --channel tlon --ship ~sampel-palnet --url https://your-ship-host --code lidlut-tabwed-pillex-ridrup

または、設定を直接編集します。

{  channels: {    tlon: {      enabled: true,      ship: "~sampel-palnet",      url: "https://your-ship-host",      code: "lidlut-tabwed-pillex-ridrup",      ownerShip: "~your-main-ship", // 推奨: 自分の ship。常に認可される    },  },}

設定を直接編集した後は Gateway を再起動します。その後、ボットに DM を送るか、グループ チャンネルで @ メンションします。

プライベート/LAN の ship

OpenClaw は SSRF 対策として、デフォルトでプライベート/内部ホスト名と IP 範囲をブロックします。ship が プライベートネットワーク（localhost、LAN IP、内部ホスト名）上で動作している場合は、明示的に許可します。

{  channels: {    tlon: {      url: "http://localhost:8080",      network: {        dangerouslyAllowPrivateNetwork: true,      },    },  },}

http://localhost:8080、http://192.168.x.x:8080、 http://my-ship.local:8080 などの接続先に適用されます。信頼できる ship URL に対してのみ有効にしてください。 そのアカウントの HTTP リクエストに対する SSRF 保護が無効になります。

グループチャンネル

チャンネルを手動で固定するか、自動検出を有効にします。

{  channels: {    tlon: {      groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"],      autoDiscoverChannels: true,    },  },}

autoDiscoverChannels は設定されていない場合、デフォルトで false になります。セットアップウィザードでは プロンプトのデフォルトが「はい」に設定され、true が明示的に書き込まれます。有効にすると、OpenClaw は起動時に 参加済みグループを scry し、グループへの招待が承認された際に新しいチャンネルを監視し、2 分ごとに再確認します。

アクセス制御

DM 許可リスト（空の場合、送信者が ownerShip でない限り DM は許可されません）:

{  channels: {    tlon: {      dmAllowlist: ["~zod", "~nec"],    },  },}

グループの認可は、チャンネルごとにデフォルトで restricted です。基準となる defaultAuthorizedShips を設定し、チャンネル nest ごとに上書きします。

{  channels: {    tlon: {      defaultAuthorizedShips: ["~zod"],      authorization: {        channelRules: {          "chat/~host-ship/general": {            mode: "restricted",            allowedShips: ["~zod", "~nec"],          },          "chat/~host-ship/announcements": {            mode: "open",          },        },      },    },  },}

ボットがスレッド内で一度返信すると、以降は再度メンションしなくても、そのスレッドの後続メッセージに 応答し続けます。

オーナーと承認システム

{  channels: {    tlon: {      ownerShip: "~your-main-ship",    },  },}

オーナー ship はあらゆる場所で認可されます。DM 招待とグループ招待は常に自動承認され、 チャンネルメッセージは常に認可を通過します。オーナーを dmAllowlist、 defaultAuthorizedShips、groupInviteAllowlist に追加する必要はありません。

ownerShip が設定されている場合、未認可のリクエストは単に破棄されるのではなく、保留中の 承認としてキューに入り、オーナーへ DM で通知されます。

• dmAllowlist に含まれない ship からの DM リクエスト
• 送信者が認可されていないチャンネルでのメンション
• groupInviteAllowlist に含まれない ship からのグループ招待（自動承認が無効な場合、または有効でも 招待者が許可リストに含まれていない場合）

オーナーは DM で返信してリクエストを処理します。

ownerShip が設定されていない場合、未認可の DM とチャンネルメンションは破棄されてログに記録されるだけで、 承認プロンプトは表示されません。

自動承認設定

dmAllowlist にすでに含まれる ship からの DM 招待を自動承認します（このフラグに関係なく、 オーナーは常に自動承認されます）。

{  channels: {    tlon: {      autoAcceptDmInvites: true,    },  },}

許可リストに基づいてグループ招待を自動承認します（安全側で拒否します。autoAcceptGroupInvites: true で groupInviteAllowlist が空の場合、オーナー以外からの招待は一切承認されません）。

{  channels: {    tlon: {      autoAcceptGroupInvites: true,      groupInviteAllowlist: ["~zod"],    },  },}

Urbit 設定ストアによるホットリロード

上記の設定の大半（dmAllowlist、groupInviteAllowlist、groupChannels、 defaultAuthorizedShips、autoDiscoverChannels、autoAcceptDmInvites、 autoAcceptGroupInvites、ownerShip、showModelSignature）は、初回実行時に ship の %settings エージェント（desk moltbot、bucket tlon）へミラーされ、その後はそこからリアルタイムで 読み込まれます。そのため、Landscape クライアントまたはバンドル済みスキルの設定コマンドから行った変更は、 Gateway を再起動しなくても適用されます。channelRules と保留中の承認も JSON としてそこに永続化されます。 設定ストアへ一度も書き込まれていない値については、ファイル設定が引き続き信頼できる唯一の情報源です。

配信先（CLI/Cron）

openclaw message send または Cron 配信で使用します。

• DM: ~sampel-palnet または dm/~sampel-palnet
• グループ: chat/~host-ship/channel または group:~host-ship/channel

バンドル済みスキル

この Plugin には、Urbit を直接操作するための CLI である @tloncorp/tlon-skill がバンドルされており、 Plugin のインストール後に自動的に利用可能になります。

• アクティビティ: メンション、返信、未読
• チャンネル: 一覧表示、作成、名前変更
• 連絡先: プロフィールの一覧表示、取得、更新
• グループ: 作成、参加、招待/リクエストフロー、ロール
• フック: チャンネルフックの管理
• メッセージ: 履歴、検索
• DM: 送信、リアクション、承認/拒否
• 投稿: リアクション、削除
• ノートブック: 日記チャンネルへの投稿
• 設定: 上記の設定ストアを通じた Plugin 設定のホットリロード

機能

トラブルシューティング

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor

よくある問題:

• DM が無視される: 送信者が dmAllowlist に含まれておらず、承認フロー用の ownerShip も設定されていません。
• グループメッセージが無視される: チャンネルが検出または固定されていないか、送信者が認可されておらず、 承認をキューに入れるための ownerShip も設定されていません。
• 接続エラー: ship URL に到達できることを確認してください。ローカルの ship には network.dangerouslyAllowPrivateNetwork を設定します。
• 認証エラー: ログインコードはローテーションされます。ship から現在のコードをコピーしてください。

設定リファレンス

完全な設定: 設定

注記

• ボットがすでにそのスレッドへ参加している場合を除き、グループでの返信には @ メンション （例: ~your-bot-ship）が必要です。
• スレッドへの返信はスレッド内に投稿されます。また、エージェントにはスレッドコンテキストの直近 10 件の メッセージが先頭に追加されます。
• リッチテキスト（太字、斜体、コード、見出し、リスト）は Tlon のネイティブ形式に変換されます。
• チャンネルの要約を求める受信メッセージ（例: 「このチャンネルを要約して」）を送信すると、 通常の返信フローではなく、組み込みの履歴要約が実行されます。

関連項目

• チャンネル概要 — 対応しているすべてのチャンネル
• ペアリング — DM の認証とペアリングフロー
• グループ — グループチャットの動作とメンションによる制限
• チャンネルルーティング — メッセージのセッションルーティング
• セキュリティ — アクセスモデルと堅牢化