Tlon 플러그인으로 Urbit 메시징 자동화하기

여러 분산형 플랫폼에서 메시지를 관리하거나 봇을 설정하는 일은 꽤 번거롭죠. 특히 Urbit 같은 환경에서는 자동 응답 시스템을 구축하는 게 쉽지 않을 때가 많아요. OpenClaw의 Tlon 플러그인을 사용하면 Urbit ship을 연결해 DM과 그룹 채팅에 응답하는 과정을 간단하게 만들 수 있습니다.

필요한 것

시작하기 전에 다음 항목들이 준비되었는지 확인해 주세요.

• Urbit ship URL 및 로그인 코드
• 설치된 OpenClaw 환경
• @openclaw/tlon 플러그인

빠른 시작

5분 안에 Tlon 플러그인을 설정하고 실행하는 방법입니다.

1. 플러그인 설치

CLI를 통해 npm 레지스트리에서 플러그인을 설치합니다.

openclaw plugins install @openclaw/tlon

만약 git 저장소에서 직접 실행 중이라면 로컬 체크아웃 방식을 사용하세요.

openclaw plugins install ./extensions/tlon

2. 최소 설정 적용

channels.tlon 설정을 구성합니다. ship 정보와 로그인 코드가 필요합니다.

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

3. Gateway 재시작 및 테스트

설정을 마쳤다면 Gateway를 재시작하세요. 이제 봇에게 DM을 보내거나 그룹 채널에서 봇을 멘션하여 작동을 확인할 수 있습니다.

---

채널 및 권한 관리

그룹 채널 설정

기본적으로 자동 검색(Auto-discovery)이 활성화되어 있습니다. 특정 채널을 수동으로 고정하거나 자동 검색을 끌 수 있습니다.

{
  channels: {
    tlon: {
      groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"],
      autoDiscoverChannels: false, // 자동 검색 비활성화 시
    },
  },
}

액세스 제어

DM 허용 목록을 설정하거나 그룹별 권한을 상세하게 제어할 수 있습니다. 그룹 권한은 기본적으로 제한(restricted) 모드로 동작합니다.

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

문제 해결

설정 중 문제가 발생하면 다음 사항을 확인해 보세요.

• 그룹 메시지 응답 없음: 그룹 채널에서는 반드시 봇의 ship 이름(예: ~your-bot-ship)을 멘션해야 응답합니다.
• 미디어 전송 실패: Tlon 플러그인은 네이티브 미디어 업로드를 지원하지 않습니다. sendMedia 호출 시 텍스트와 URL이 포함된 캡션으로 대체되어 전송됩니다.
• 지원되지 않는 기능: 현재 Reactions, Polls, 네이티브 미디어 업로드는 지원되지 않는 기능입니다.

설정 과정에서 도움이 더 필요하다면 AI Setup Assistant에게 물어보세요.

다음 단계

• Plugins 상세 안내
• CLI/cron을 이용한 메시지 전송 (openclaw message send)