【最新版】TlonでOpenClawを使う方法（Urbitの分散メッセンジャー連携）

Tlon

Tlon（プラグイン）

Tlon は Urbit 上に構築された分散型メッセンジャーです。OpenClaw はあなたの Urbit ship に接続し、DM とグループチャットメッセージに応答できます。 グループ返信はデフォルトで @メンションが必要で、さらに allowlist で制限できます。

ステータス：プラグイン経由でサポート。DM、グループメンション、スレッド返信、リッチテキスト（整形）、画像アップロードに対応しています。 リアクションと投票は（このチャネル機能としては）まだ未対応です。

プラグインが必要

Tlon はプラグインとして提供され、コアインストールには同梱されていません。

CLI（npm レジストリ）でインストール：

openclaw plugins install @openclaw/tlon

ローカルチェックアウト（git リポジトリから実行している場合）：

openclaw plugins install ./extensions/tlon

詳細： Plugins

セットアップ

1. Tlon プラグインをインストールします。
2. ship の URL と login code を用意します。
3. channels.tlon を設定します。
4. Gateway を再起動します。
5. ボットに DM を送るか、グループチャンネルで @メンションします。

最小 config（シングルアカウント）

{
 channels: {
  tlon: {
   enabled: true,
   ship: "~sampel-palnet",
   url: "https://your-ship-host",
   code: "lidlut-tabwed-pillex-ridrup",
   ownerShip: "~your-main-ship", // 推奨：あなたの ship（常に許可される）
  },
 },
}

プライベート/LAN ship

デフォルトでは、OpenClaw は SSRF 対策としてプライベート/内部ホスト名や IP レンジへのアクセスをブロックします。 ship がプライベートネットワーク（localhost、LAN IP、内部ホスト名）で動いている場合、明示的に opt-in が必要です。

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

この設定は次のような URL に適用されます：

• http://localhost:8080
• http://192.168.x.x:8080
• http://my-ship.local:8080

グループチャンネル

自動検出（auto-discovery）はデフォルトで有効です。手動でチャンネルを固定（pin）することもできます：

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

自動検出を無効化：

{
 channels: {
  tlon: {
   autoDiscoverChannels: false,
  },
 },
}

アクセス制御

DM allowlist

DM allowlist（空 = DM は一切許可しない。承認フローには ownerShip を使用）：

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

グループ認可（デフォルトで制限）

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

オーナー（owner）と承認システム

未認可ユーザーがやり取りしようとしたときに承認要求を受け取るため、owner ship を設定します：

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

owner ship は すべての場所で自動的に認可 されます。 DM 招待は自動で accept され、チャンネルメッセージも常に許可されます。 そのため owner を dmAllowlist や defaultAuthorizedShips に追加する必要はありません。

owner を設定すると、owner は次の通知を DM で受け取ります：

• allowlist に含まれない ship からの DM リクエスト
• 認可されていないチャンネルでのメンション
• グループ招待リクエスト

自動 accept 設定

DM 招待の自動 accept（dmAllowlist に含まれる ship）

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

グループ招待の自動 accept

{
 channels: {
  tlon: {
   autoAcceptGroupInvites: true,
  },
 },
}

配信ターゲット（CLI / cron）

openclaw message send や cron の delivery で次を使用します：

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

同梱 skill（Bundled skill）

Tlon プラグインには、Tlon 操作に対する CLI アクセスを提供する同梱 skill（@tloncorp/tlon-skill）が含まれています。 この skill は、プラグインをインストールすると自動的に利用可能になります。

• Contacts：プロフィール取得/更新、連絡先一覧
• Channels：一覧、作成、投稿、履歴取得
• Groups：一覧、作成、メンバー管理
• DMs：メッセージ送信、メッセージへのリアクション
• Reactions：投稿/DM に絵文字リアクションを追加/削除
• Settings：スラッシュコマンドでプラグイン権限を管理

機能（Capabilities）

• Direct messages：✅ 対応
• Groups/channels：✅ 対応（デフォルトでメンション必須）
• Threads：✅ 対応（スレッド内ならスレッドに自動返信）
• Rich text：✅ Markdown を Tlon 形式に変換
• Images：✅ Tlon ストレージへアップロード
• Reactions：✅ 同梱 skill 経由
• Polls：❌ 未対応
• Native commands：✅ 対応（デフォルトで owner のみ）

トラブルシューティング

まずは次のラダーを実行します：

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor

よくある失敗：

• DM が無視される：送信者が dmAllowlist に含まれておらず、承認フロー用の ownerShip も未設定。
• グループメッセージが無視される：チャンネルが未発見（未検出）か、送信者が未認可。
• 接続エラー：ship URL が到達可能か確認。ローカル ship なら allowPrivateNetwork を有効化。
• 認証エラー：login code が最新か確認（コードはローテーションします）。

設定リファレンス

フル設定： Configuration

プロバイダオプション：

• channels.tlon.enabled：チャンネル起動の有効/無効
• channels.tlon.ship：ボットの Urbit ship 名（例：~sampel-palnet）
• channels.tlon.url：ship URL（例：https://sampel-palnet.tlon.network）
• channels.tlon.code：ship の login code
• channels.tlon.allowPrivateNetwork：localhost/LAN URL を許可（SSRF バイパス）
• channels.tlon.ownerShip：承認システムの owner ship（常に認可）
• channels.tlon.dmAllowlist：DM を許可する ship（空 = なし）
• channels.tlon.autoAcceptDmInvites：allowlisted ship からの DM を自動 accept
• channels.tlon.autoAcceptGroupInvites：すべてのグループ招待を自動 accept
• channels.tlon.autoDiscoverChannels：グループチャンネルの自動検出（デフォルト：true）
• channels.tlon.groupChannels：手動で pin するチャンネル nests
• channels.tlon.defaultAuthorizedShips：全チャンネルで認可する ship
• channels.tlon.authorization.channelRules：チャンネルごとの認可ルール
• channels.tlon.showModelSignature：メッセージにモデル名を付加

メモ（Notes）

• グループ返信はメンション必須（例：~your-bot-ship）。
• スレッド返信：受信メッセージがスレッド内なら、OpenClaw もスレッド内へ返信します。
• リッチテキスト：Markdown（太字、斜体、コード、見出し、リスト）は Tlon のネイティブ形式に変換されます。
• 画像：URL は Tlon ストレージへアップロードされ、画像ブロックとして埋め込まれます。

参考

• https://docs.openclaw.ai/channels/tlon.md