OpenClawSkills
GitHub
通道 • 5 分钟阅读

Tlon

Tlon/Urbit 通道:支持状态、能力与配置

Tlon 是基于 Urbit 的去中心化聊天应用。OpenClaw 连接到你的 Urbit ship,可以响应私信与群聊消息。群聊默认需要 @mention 才会回复,也可以通过 allowlists 进一步限制。 状态:通过插件支持。支持私信、群聊 mentions、线程内回复,以及"文本兜底"的媒体发送(把 URL 追加到 caption)。不支持 reactions、投票,以及原生媒体上传。

Tutorial.step

需要安装插件

Tlon 以插件形式提供,不随 core 安装打包。

通过 CLI 安装(npm registry):

Bash
openclaw plugins install @openclaw/tlon

本地安装(当你从 git 仓库运行时):

Bash
openclaw plugins install ./extensions/tlon

详情:''/plugin''

Tutorial.step

设置

1. 安装 Tlon 插件。

2. 准备 ship URL 与登录 code。

3. 配置 ''channels.tlon''。

4. 重启 gateway。

5. 私信 bot,或在群频道中 @mention 它。

最小配置(单账号):

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

群频道(Group channels)

默认启用自动发现。你也可以手动固定频道列表:

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

禁用自动发现:

Json5
{
  channels: {
    tlon: {
      autoDiscoverChannels: false,
    },
  },
}
Tutorial.step

访问控制

私信 allowlist(为空表示允许所有):

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

群聊授权(默认是 restricted):

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

投递目标(CLI/cron)

在 ''openclaw message send'' 或 cron 投递中使用:

- 私信:''~sampel-palnet'' 或 ''dm/~sampel-palnet''

- 群聊:''chat/~host-ship/channel'' 或 ''group:~host-ship/channel''

Tutorial.step

备注

- 群聊回复需要 mention(例如 ''~your-bot-ship'')。

- 线程回复:若入站消息在 thread 内,OpenClaw 会在 thread 内回复。

- 媒体:''sendMedia'' 会退化为"文本 + URL"(不做原生上传)。