Tlon 插件設定指南

想要在去中心化網路建立自動化機器人，最煩人的就是處理各種非典型的通訊協定。Urbit 的架構跟傳統 Web2 完全不同，如果你正試著在 Tlon 上開發自動回覆功能，這篇教學能幫你省下不少研究時間。

OpenClaw 透過插件支援 Tlon，讓你的 Urbit ship 具備處理 DM 與群組訊息的能力。

需要準備的東西

在開始之前，請確保你已經準備好以下資訊：

已安裝好的 OpenClaw 環境
你的 Urbit ship URL
你的 Urbit 登入代碼 (login code)
Tlon 插件 (@openclaw/tlon)

快速開始

跟著這四個步驟，在 5 分鐘內完成基礎設定：

1. 安裝插件

你可以直接從 npm 安裝，或是從本地 git 倉庫安裝：

# 從 npm 安裝
openclaw plugins install @openclaw/tlon

# 或者如果你是在本地開發環境
openclaw plugins install ./extensions/tlon

2. 基礎配置

在你的設定檔中加入 channels.tlon。這是一個最簡單的單一帳號配置範例：

{
  channels: {
    tlon: {
      enabled: true,
      ship: "~sampel-palnet",
      url: "https://your-ship-host",
      code: "lidlut-tabwed-pillex-ridrup",
    },
  },
}

3. 管理群組頻道

OpenClaw 預設會自動偵測頻道，但你也可以手動指定或關閉自動偵測：

{
  channels: {
    tlon: {
      // 手動固定頻道
      groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"],
      // 關閉自動偵測
      autoDiscoverChannels: false,
    },
  },
}

4. 啟動與測試

儲存設定後重啟 Gateway。你可以直接傳送 DM 給機器人，或是在群組中 @ 提及它來測試回覆功能。

進階存取控制

如果你不希望機器人回覆所有人，可以使用白名單機制：

DM 白名單：設定 dmAllowlist，留空則代表允許所有人。
群組權限：透過 authorization 針對不同頻道設定 restricted 或 open 模式。

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

CLI 與定時任務訊息

如果你需要透過 CLI 或 cron 發送訊息，請參考以下路徑格式：

DM: 使用 ~sampel-palnet 或 dm/~sampel-palnet
群組: 使用 chat/~host-ship/channel 或 group:~host-ship/channel

疑難排解

以下是根據目前插件版本整理的常見問題與限制：

機器人在群組沒反應：在群組中，機器人預設必須被 @ 提及（例如 ~your-bot-ship）才會觸發回覆。
媒體檔案無法顯示：目前不支援原生媒體上傳、貼圖或投票。發送媒體時會自動退回到「文字 + URL」的模式。
回覆位置錯誤：如果原始訊息是在 Thread（討論串）中，OpenClaw 會自動在該 Thread 內回覆。

如果你在設定過程中遇到其他問題，可以詢問 AI Setup Assistant 獲取即時協助。

下一步

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。