Tlon (플러그인)

Tlon은 Urbit 기반의 분산형 메신저입니다. OpenClaw는 Urbit ship에 연결하여 DM 및 그룹 채팅 메시지에 응답할 수 있습니다. 그룹 답장은 기본적으로 @ 멘션이 필요하며 allowlist를 통해 추가로 제한할 수 있습니다.

상태: 플러그인을 통해 지원됩니다. DM, 그룹 멘션, 스레드 답장 및 텍스트 전용 미디어 폴백 (URL이 캡션에 추가됨)을 지원합니다. 리액션, 투표 및 네이티브 미디어 업로드는 지원되지 않습니다.

플러그인 필요

Tlon은 플러그인으로 제공되며 코어 설치에 포함되어 있지 않습니다.

CLI를 통한 설치 (npm 레지스트리):

openclaw plugins install @openclaw/tlon

로컬 체크아웃 (git 저장소에서 실행 시):

openclaw plugins install ./extensions/tlon

자세한 내용: Plugins

설정

  1. Tlon 플러그인을 설치합니다.
  2. ship URL과 로그인 코드를 수집합니다.
  3. channels.tlon을 구성합니다.
  4. Gateway를 재시작합니다.
  5. 봇에 DM을 보내거나 그룹 채널에서 멘션합니다.

최소 구성 (단일 계정):

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

그룹 채널

자동 검색이 기본적으로 활성화되어 있습니다. 수동으로 채널을 고정할 수도 있습니다:

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

자동 검색 비활성화:

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

접근 제어

DM allowlist (비어 있음 = 모두 허용):

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

전달 대상 (CLI/cron)

openclaw message send 또는 cron 전달과 함께 사용:

  • DM: ~sampel-palnet 또는 dm/~sampel-palnet
  • Group: chat/~host-ship/channel 또는 group:~host-ship/channel

참고사항

  • 그룹 답장은 응답하기 위해 멘션(예: ~your-bot-ship)이 필요합니다.
  • 스레드 답장: 수신 메시지가 스레드에 있으면 OpenClaw는 스레드 내에서 답장합니다.
  • 미디어: sendMedia는 텍스트 + URL로 폴백합니다 (네이티브 업로드 없음).
← 문서로 돌아가기