跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tlon 是建構於 Urbit 之上的去中心化通訊軟體。OpenClaw 會連線到你的 Urbit ship，並可 回應私訊和群組聊天室訊息。群組回覆預設需要 @ 提及，且可 透過允許清單進一步限制。 狀態：隨附 Plugin。支援私訊、群組提及、討論串回覆、富文字格式，以及 圖片上傳。尚不支援反應和投票。

​
隨附 Plugin

Tlon 在目前的 OpenClaw 版本中作為隨附 Plugin 提供，因此一般封裝 建置不需要另外安裝。 如果你使用的是較舊的建置，或排除 Tlon 的自訂安裝，請在發布 目前的 npm 套件後安裝它： 透過 CLI 安裝（npm registry，在目前套件存在時）： 
openclaw plugins install @openclaw/tlon
如果 npm 回報 OpenClaw 擁有的套件已淘汰，請使用目前封裝的 OpenClaw 建置，或在較新的 npm 套件發布前使用本機 checkout 路徑。 本機 checkout（從 git repo 執行時）： 
openclaw plugins install ./path/to/local/tlon-plugin
詳細資訊：Plugins

​
設定

  1. 確認 Tlon Plugin 可用。
    • 目前封裝的 OpenClaw 版本已隨附它。
    • 較舊/自訂安裝可使用上述命令手動加入。
  2. 取得你的 ship URL 和登入代碼。
  3. 設定 channels.tlon。
  4. 重新啟動 Gateway。
  5. 私訊機器人，或在群組頻道中提及它。
最小設定（單一帳號）： 
{
  channels: {
    tlon: {
      enabled: true,
      ship: "~sampel-palnet",
      url: "https://your-ship-host",
      code: "lidlut-tabwed-pillex-ridrup",
      ownerShip: "~your-main-ship", // recommended: your ship, always allowed
    },
  },
}

​
私有/LAN ships

OpenClaw 預設會封鎖私有/內部主機名稱和 IP 範圍，以提供 SSRF 防護。 如果你的 ship 在私有網路上執行（localhost、LAN IP 或內部主機名稱）， 你必須明確選擇啟用： 
{
  channels: {
    tlon: {
      url: "http://localhost:8080",
      allowPrivateNetwork: true,
    },
  },
}
這適用於下列 URL：
  • http://localhost:8080
  • http://192.168.x.x:8080
  • http://my-ship.local:8080
⚠️ 只有在你信任本機網路時才啟用此設定。此設定會停用 對你的 ship URL 發出請求時的 SSRF 防護。

​
群組頻道

預設啟用自動探索。你也可以手動固定頻道： 
{
  channels: {
    tlon: {
      groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"],
    },
  },
}
停用自動探索： 
{
  channels: {
    tlon: {
      autoDiscoverChannels: false,
    },
  },
}

​
存取控制

私訊允許清單（空白 = 不允許私訊，使用 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",
          },
        },
      },
    },
  },
}

​
擁有者與核准系統

設定擁有者 ship，在未授權使用者嘗試互動時接收核准請求： 
{
  channels: {
    tlon: {
      ownerShip: "~your-main-ship",
    },
  },
}
擁有者 ship 會自動在所有地方獲得授權——私訊邀請會自動接受， 頻道訊息也一律允許。你不需要將擁有者加入 dmAllowlist 或 defaultAuthorizedShips。 設定後，擁有者會收到下列私訊通知：
  • 來自不在允許清單中 ship 的私訊請求
  • 未經授權頻道中的提及
  • 群組邀請請求

​
自動接受設定

自動接受私訊邀請（適用於 dmAllowlist 中的 ships）： 
{
  channels: {
    tlon: {
      autoAcceptDmInvites: true,
    },
  },
}
自動接受群組邀請： 
{
  channels: {
    tlon: {
      autoAcceptGroupInvites: true,
    },
  },
}

​
傳遞目標（CLI/Cron）

搭配 openclaw message send 或 Cron 傳遞使用這些目標：
  • 私訊：~sampel-palnet 或 dm/~sampel-palnet
  • 群組：chat/~host-ship/channel 或 group:~host-ship/channel

​
隨附 Skills

Tlon Plugin 包含隨附的 Skills（@tloncorp/tlon-skill）， 可提供 Tlon 操作的 CLI 存取：
  • 聯絡人：取得/更新個人檔案、列出聯絡人
  • 頻道：列出、建立、張貼訊息、擷取歷程
  • 群組：列出、建立、管理成員
  • 私訊：傳送訊息、對訊息加入反應
  • 反應：對貼文和私訊新增/移除 emoji 反應
  • 設定：透過 slash commands 管理 Plugin 權限
安裝 Plugin 後，該 Skills 會自動可用。

​
功能

功能狀態
直接訊息✅ 支援
群組/頻道✅ 支援（預設需要提及）
討論串✅ 支援（在討論串中自動回覆）
富文字✅ Markdown 會轉換為 Tlon 格式
圖片✅ 上傳到 Tlon 儲存空間
反應✅ 透過隨附 Skills
投票❌ 尚不支援
原生命令✅ 支援（預設僅擁有者）

​
疑難排解

先執行這個階梯： 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
常見失敗：
  • 私訊被忽略：寄件者不在 dmAllowlist 中，且未設定 ownerShip 以供核准流程使用。
  • 群組訊息被忽略：頻道未被探索到，或寄件者未獲授權。
  • 連線錯誤：檢查 ship URL 是否可連線；對本機 ships 啟用 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：允許私訊的 ships（空白 = 無）。
  • channels.tlon.autoAcceptDmInvites：自動接受來自允許清單中 ships 的私訊。
  • channels.tlon.autoAcceptGroupInvites：自動接受所有群組邀請。
  • channels.tlon.autoDiscoverChannels：自動探索群組頻道（預設：true）。
  • channels.tlon.groupChannels：手動固定的頻道 nests。
  • channels.tlon.defaultAuthorizedShips：對所有頻道都獲授權的 ships。
  • channels.tlon.authorization.channelRules：每個頻道的驗證規則。
  • channels.tlon.showModelSignature：在訊息後附加模型名稱。

​
備註

  • 群組回覆需要提及（例如 ~your-bot-ship）才會回應。
  • 討論串回覆：如果傳入訊息位於討論串中，OpenClaw 會在討論串內回覆。
  • 富文字：Markdown 格式（粗體、斜體、程式碼、標題、清單）會轉換為 Tlon 的原生格式。
  • 圖片：URL 會上傳到 Tlon 儲存空間，並嵌入為圖片區塊。

​
相關