什麼是 Urbit，它與 Tlon 有什麼關係？

Urbit 是一個點對點計算平台，每個使用者執行自己的個人伺服器（稱為「飛船」）。Tlon 是建立在 Urbit 之上的即時通訊應用程式。可以將 Urbit 看作作業系統，Tlon 看作即時通訊應用程式。OpenClaw 連接到您的 Urbit 飛船，與 Tlon 訊息層進行互動。

我需要購買 Urbit 行星才能使用此整合嗎？

不一定。您可以使用免費的彗星（臨時身份）進行測試。但對於生產用途，建議使用行星（永久身份，如 ~sampel-palnet），因為它提供穩定、可辨識的身份。行星可以從各種 Urbit 位址空間提供者購買。

機器人能參與群組聊天嗎？

可以，但有限制。機器人在群組頻道中被 @ 提及時可以回覆。它不會回覆每則訊息——只有在被明確觸發時才會回應。您可以設定機器人監控哪些群組以及誰可以觸發它。

機器人能傳送圖片或其他媒體嗎？

目前不支援原生媒體。目前的整合僅支援純文字訊息。當 AI 代理產生媒體內容時，URL 會附加到文字中而不是作為原生附件上傳。未來的外掛程式更新可能會改善這一點。

如果我的 Urbit 飛船離線了會怎樣？

當 Urbit 飛船離線時，機器人無法傳送或接收訊息。但 Urbit 飛船被設計為持久的——一旦飛船重新上線，它會與網路同步並接收所有錯過的事件。OpenClaw Gateway 會自動重新連接到飛船的 API。

我可以在遠端 Urbit 飛船上執行機器人嗎？

可以。機器人透過 HTTP 連接到飛船，因此飛船可以在遠端伺服器上執行。只需將 url 設定指向遠端飛船的 HTTP 端點（如 https://your-ship.example.com）。確保遠端部署使用 HTTPS 保護連線安全。

OpenClaw GuideOpenClaw

立即開始

OpenClaw Tlon 頻道

去中心化

進階

將 OpenClaw 連接到 Tlon，這是一個基於 Urbit 構建的去中心化即時通訊工具。該整合使您的 AI 助手能夠在 Tlon 的點對點網路上接收和回覆私訊及群組提及——無需中心化伺服器，無需企業帳戶，只需您的 Urbit 飛船身份和認證碼。適合主權計算愛好者和重視資料所有權的組織。

快速資訊

難度進階

分類去中心化

支援功能數1 / 6

Tlon 支援功能

文字訊息

支援

媒體與檔案

不支援

表情回應

不支援

討論串

不支援

語音訊息

不支援

群組聊天

不支援

Tlon 前置條件

已安裝並執行 OpenClaw Gateway
一個正在執行的 Urbit 飛船（行星、恆星或彗星），可透過 HTTP 存取
飛船的認證碼（可從飛船的 Web 介面取得）
伺服器上已安裝 Node.js 18+

Tlon 快速設定

安裝 Tlon 外掛程式

執行 'openclaw plugins install @openclaw/tlon' 新增 Tlon 頻道。或者使用 'openclaw onboard' 或 'openclaw channels add'，然後從外掛程式清單中選擇 Tlon。安裝後重新啟動 Gateway。

設定 Urbit 飛船憑證

設定您的 Urbit 飛船識別碼（如 ~sampel-palnet）、飛船的主機 URL（如 http://localhost:8080）和認證碼作為環境變數。在 openclaw.json 設定中使用 ${URBIT_SHIP}、${URBIT_URL} 和 ${URBIT_CODE} 參照它們。

啟動並傳送測試訊息

使用 'openclaw start' 重新啟動 Gateway。在 Urbit 飛船上開啟 Tlon 應用程式，向機器人的飛船傳送一條私訊。機器人應該會自動解密、處理並回覆。

Tlon 設定範例

config.json

{
  "channels": {
    "tlon": {
      "ship": "${URBIT_SHIP}",
      "url": "${URBIT_URL}",
      "code": "${URBIT_CODE}",
      "enabled": true
    }
  }
}

Tlon 深入了解

架構概覽

Tlon 是一個基於 Urbit 構建的即時通訊應用程式，Urbit 是一個點對點計算平台，每個使用者執行自己的伺服器（稱為「飛船」）。與中心化平台不同，您的資料儲存在您自己的飛船上，完全由您控制。訊息流程如下： 1. 使用者在 Tlon 群組聊天中傳送私訊或 @ 提及機器人 2. 訊息透過 Urbit 的 Ames 網路協定傳遞到機器人的飛船 3. OpenClaw 透過飛船的 HTTP API 接收訊息 4. Gateway 透過您的 AI 代理處理訊息，並透過同一 API 發回回應由於 Urbit 是一個點對點網路，沒有可以被關閉或審查的中央伺服器。每個飛船維護自己的狀態，訊息透過 Ames 協定在飛船之間直接傳遞。

機器人作為 Urbit 飛船的伴隨程序執行——它透過飛船的本地 HTTP API 連線，而非透過任何外部服務。

Urbit 飛船具有持久身份：像 ~sampel-palnet 這樣的行星是您在網路上的永久地址。

外掛程式安裝

Tlon 頻道作為可選的 OpenClaw 外掛程式分發，而非內建於核心 Gateway 中。這使得基礎安裝保持輕量，同時允許您在需要時新增 Tlon/Urbit 支援。安裝方式： • **npm（建議）：** 執行 'openclaw plugins install @openclaw/tlon' 安裝穩定版本。 • **本地開發：** 複製外掛程式儲存庫，使用 'openclaw plugins install ./extensions/tlon' 從本地目錄安裝。 • **互動式設定：** 執行 'openclaw onboard' 或 'openclaw channels add'，然後從清單中選擇 Tlon。安裝後重新啟動 Gateway 使外掛程式生效。

執行 'openclaw plugins list' 驗證 Tlon 外掛程式已安裝並處於作用中狀態。

Urbit 飛船設定與認證

要將 OpenClaw 連接到 Tlon，您需要從 Urbit 飛船取得三項資訊： 1. **飛船識別碼** — 您的 Urbit 身份（如 ~sampel-palnet）。這是將作為機器人的飛船。 2. **主機 URL** — 飛船可存取的 HTTP 端點。Urbit 預設使用 80 連接埠，若 80 連接埠被佔用則回退到 8080（如 http://localhost:8080）。請查看飛船啟動日誌確認實際連接埠。 3. **認證碼** — 用於認證 API 請求的金鑰。您可以在飛船的 Web 介面的設定中找到，或在 Dojo（Urbit 的命令列）中執行 '+code' 取得。 OpenClaw 使用這些憑證透過飛船的 HTTP API 進行認證並訂閱傳入訊息。

openclaw.json

{
  "channels": {
    "tlon": {
      "ship": "${URBIT_SHIP}",
      "url": "${URBIT_URL}",
      "code": "${URBIT_CODE}"
    }
  }
}

切勿將認證碼直接寫死在 openclaw.json 中。始終使用環境變數（如 ${URBIT_CODE}），並透過 'export URBIT_CODE="sampel-ticlyt-migfun-falmel"' 在 shell 或 .env 檔案中設定。

自動探索與頻道固定

預設情況下，OpenClaw 會自動探索 Urbit 飛船上的群組頻道，允許機器人在其加入的任何群組中回應提及。您可以停用自動探索，改為手動固定特定頻道。 Tlon 中的頻道路徑格式為：chat/~host-ship/channel-name。例如，'chat/~host-ship/general' 指的是由 ~host-ship 託管的 'general' 聊天頻道。停用自動探索後，只有固定的頻道會被監控。當您希望機器人只參與特定對話而不在每個群組中被觸發時，這很有用。

openclaw.json

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

自動探索預設啟用。設定 autoDiscovery: false 將機器人限制在固定頻道中。

頻道路徑使用格式 chat/~host-ship/channel-name。請在 Tlon 應用程式中查看每個頻道的確切路徑。

私訊策略

私訊策略控制誰可以透過 Tlon 與您的 AI 助手互動。由於 Urbit 飛船具有持久身份，存取控制基於飛船地址。 OpenClaw 為 Tlon 頻道支援以下私訊策略： • **open（預設）** — 任何飛船都可以向機器人傳送私訊。由於 Tlon 私訊要求雙方都在 Urbit 網路上，這相對安全。 • **allowlist** — 只有 allowFrom 中列出的飛船才能向機器人傳送訊息。其他飛船將被忽略。當 allowFrom 設定為空陣列時，所有飛船都被允許（等同於 open 模式）。新增特定飛船地址以限制存取。

openclaw.json

{
  "channels": {
    "tlon": {
      "allowFrom": [
        "~sampel-palnet",
        "~timluc-miptev"
      ]
    }
  }
}

群組存取控制

Tlon 中的群組頻道有自己的存取控制層。預設情況下，群組是受限的——機器人只會在明確列出授權飛船的群組中回應。每個群組頻道可以設定： • **authorized** — 可以在此群組中觸發機器人的飛船地址清單 • **mode** — 'restricted'（僅授權飛船可觸發）或 'open'（任何群組成員可觸發）在群組中，機器人僅在被 @ 提及時才會回應。這防止機器人在繁忙的群組聊天中回覆每則訊息。

openclaw.json

{
  "channels": {
    "tlon": {
      "groups": {
        "chat/~host-ship/general": {
          "mode": "restricted",
          "authorized": ["~sampel-palnet"]
        },
        "chat/~host-ship/public": {
          "mode": "open"
        }
      }
    }
  }
}

在受限模式下，只有 'authorized' 中列出的飛船才能觸發機器人回應。

群組回應需要 @ 提及——即使在開放模式下，機器人也不會回應普通訊息。

投遞目標（CLI 和排程任務）

OpenClaw 支援透過 CLI 或排程任務傳送主動訊息。對於 Tlon 頻道，您可以針對私訊和群組頻道。私訊投遞目標： • ~sampel-palnet — 向此飛船傳送私訊 • dm/~sampel-palnet — 明確私訊格式群組投遞目標： • chat/~host-ship/channel — 傳送到特定群組頻道 • group:~host-ship/channel — 替代群組格式這對於向特定飛船或群組頻道傳送排程通知、警報或定期報告非常有用。

CLI examples

# Send a DM to a specific ship
openclaw send tlon ~sampel-palnet "Your daily report is ready."

# Post to a group channel
openclaw send tlon chat/~host-ship/general "System status: all clear."

媒體處理限制

目前的 Tlon 整合僅支援文字訊息。由於外掛程式的 Urbit API 整合限制，不支援表情回應、投票和原生媒體上傳。當 AI 代理產生包含媒體（圖片、檔案等）的回應時，外掛程式退回到純文字傳遞： • 圖片 — URL 附加到訊息文字中，而非內嵌顯示 • 檔案 — 文字回應中包含下載連結 • 表情回應 — 不支援；機器人無法對訊息做出回應 • 討論串 — 不支援；所有回覆都傳送到主對話未來的外掛程式更新可能會隨著 Tlon 平台的發展新增原生媒體支援。

如果您的 AI 代理經常產生圖片回應，請考慮在系統提示中說明 Tlon 頻道僅支援文字。

訊息中的 URL 在 Tlon 應用程式中可點擊——使用者可以點擊在瀏覽器中檢視媒體內容。

Tlon 設定參考

Key	Type	Default	Description
ship	string	(required)	您的 Urbit 飛船識別碼（如 ~sampel-palnet）。這是作為機器人的飛船。
url	string	"http://localhost:8080"	Urbit 飛船可存取的 HTTP 端點
code	string	(required)	Urbit 飛船 HTTP API 的認證碼。使用環境變數參照。
enabled	boolean	true	啟用或停用 Tlon 頻道
name	string	""	此頻道實例的顯示名稱
autoDiscovery	boolean	true	自動探索並監控飛船上的所有群組頻道
channels	string[]	[]	停用 autoDiscovery 時要監控的群組頻道路徑清單（如 chat/~host-ship/general）
allowFrom	string[]	[]	允許向機器人傳送私訊的飛船地址清單。空陣列允許所有飛船。
groups	object	{}	每個群組的存取控制設定，包含模式和授權飛船清單
groups.<path>.mode	string	"restricted"	群組存取模式：'restricted'（僅授權飛船）或 'open'（任何群組成員）
groups.<path>.authorized	string[]	[]	在此群組中被授權觸發機器人的飛船地址清單（當模式為 'restricted' 時）

ship

Type: stringDefault: (required)

您的 Urbit 飛船識別碼（如 ~sampel-palnet）。這是作為機器人的飛船。

url

Type: stringDefault: "http://localhost:8080"

Urbit 飛船可存取的 HTTP 端點

code

Type: stringDefault: (required)

Urbit 飛船 HTTP API 的認證碼。使用環境變數參照。

enabled

Type: booleanDefault: true

啟用或停用 Tlon 頻道

name

Type: stringDefault: ""

此頻道實例的顯示名稱

autoDiscovery

Type: booleanDefault: true

自動探索並監控飛船上的所有群組頻道

channels

Type: string[]Default: []

停用 autoDiscovery 時要監控的群組頻道路徑清單（如 chat/~host-ship/general）

allowFrom

Type: string[]Default: []

允許向機器人傳送私訊的飛船地址清單。空陣列允許所有飛船。

groups

Type: objectDefault: {}

每個群組的存取控制設定，包含模式和授權飛船清單

groups.<path>.mode

Type: stringDefault: "restricted"

群組存取模式：'restricted'（僅授權飛船）或 'open'（任何群組成員）

groups.<path>.authorized

Type: string[]Default: []

在此群組中被授權觸發機器人的飛船地址清單（當模式為 'restricted' 時）

Tlon 常見問題

Tlon 故障排除

機器人啟動但收不到任何訊息

飛船 URL 或認證碼可能不正確，或者飛船未在執行。

透過在瀏覽器中開啟 URL 驗證飛船是否可存取。檢查認證碼是否正確（在 Dojo 中執行 '+code'）。確保環境變數已正確匯出：'echo $URBIT_URL' 和 'echo $URBIT_CODE'。

錯誤：認證失敗

認證碼已過期或不正確。Urbit 飛船可以輪換認證碼。

從飛船的 Web 介面（設定）或在 Dojo 中執行 '+code' 取得新的認證碼。更新 URBIT_CODE 環境變數並重新啟動 Gateway。

機器人回覆私訊但不回覆群組頻道

自動探索可能已停用且群組頻道未被固定，或群組存取控制阻止了傳送者。

檢查 autoDiscovery 是否設定為 false——如果是，將群組頻道新增到 channels 陣列中。驗證傳送者的飛船是否在群組的 authorized 清單中（受限模式下）。記住群組回應需要 @ 提及。

安裝後找不到外掛程式

外掛程式安裝後未重新啟動 Gateway，或安裝靜默失敗。

執行 'openclaw plugins list' 驗證 Tlon 外掛程式已安裝。如未列出，重新執行 'openclaw plugins install @openclaw/tlon'。安裝後使用 'openclaw start' 重新啟動 Gateway。

連線頻繁中斷

由於網路問題或飛船負載過重，Urbit 飛船的 HTTP API 可能無法存取。

檢查到飛船的網路連線。如果是遠端執行，確保 HTTP 連接埠未被防火牆封鎖。考慮在與飛船相同的機器上執行機器人以最小化延遲。檢查飛船的 Dojo 中的錯誤訊息。

檢視完整文件返回所有頻道

OpenClaw Tlon 頻道

Tlon 支援功能

Tlon 前置條件

Tlon 快速設定

安裝 Tlon 外掛程式

設定 Urbit 飛船憑證

啟動並傳送測試訊息

Tlon 設定範例

Tlon 深入了解

架構概覽

外掛程式安裝

Urbit 飛船設定與認證

自動探索與頻道固定

私訊策略

群組存取控制

投遞目標（CLI 和排程任務）

媒體處理限制

Tlon 設定參考

Tlon 常見問題

Tlon 故障排除

相關頻道

Matrix

Nostr