Tlon

​

プラグインが必要

openclaw plugins install @openclaw/tlon

openclaw plugins install ./extensions/tlon

​

セットアップ

1. Tlon プラグインをインストールします。
2. ship の URL とログインコードを用意します。
3. channels.tlon を構成します。
4. ゲートウェイを再起動します。
5. ボットに DM を送信するか、グループチャネルでメンションします。

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

​

プライベート / LAN 内の ship

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

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

​

グループチャネル

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

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

​

アクセス制御

{
  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",
          },
        },
      },
    },
  },
}

​

オーナーおよび承認システム

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

• 許可リストにない ship からの DM リクエスト
• 未承認のチャネルでのメンション
• グループへの招待リクエスト

​

自動承諾設定

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

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

​

配信ターゲット (CLI/Cron)

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

​

同梱スキル

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

​

機能

​

トラブルシューティング

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

• DM が無視される: 送信者が dmAllowlist に含まれておらず、承認フロー用の ownerShip も設定されていない。
• グループメッセージが無視される: チャネルが検出されていないか、送信者が承認されていない。
• 接続エラー: ship の URL が到達可能か確認してください。ローカルの ship の場合は allowPrivateNetwork を有効にしてください。
• 認証エラー: ログインコードが最新であることを確認してください（コードは更新されることがあります）。

​

構成リファレンス

• channels.tlon.enabled: チャネルの起動を有効/無効にします。
• channels.tlon.ship: ボットの Urbit ship 名 (例: ~sampel-palnet)。
• channels.tlon.url: ship の URL (例: https://sampel-palnet.tlon.network)。
• channels.tlon.code: ship のログインコード。
• channels.tlon.allowPrivateNetwork: localhost や LAN 内の URL を許可 (SSRF バイパス)。
• channels.tlon.ownerShip: 承認システム用のオーナー ship (常に承認されます)。
• channels.tlon.dmAllowlist: DM を許可する ship (空の場合はなし)。
• channels.tlon.autoAcceptDmInvites: 許可リストにある ship からの DM を自動承諾。
• channels.tlon.autoAcceptGroupInvites: すべてのグループ招待を自動承諾。
• channels.tlon.autoDiscoverChannels: グループチャネルを自動検出 (デフォルト: true)。
• channels.tlon.groupChannels: 手動で固定されたチャネル。
• channels.tlon.defaultAuthorizedShips: すべてのチャネルで承認される ship。
• channels.tlon.authorization.channelRules: チャネルごとの認証ルール。
• channels.tlon.showModelSignature: メッセージにモデル名を付加。

​

補足事項

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