English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Developer and self-hosted

Tlon

Tlon은 Urbit 기반의 탈중앙화 메신저입니다. OpenClaw는 사용자의 Urbit ship에 연결하여 DM과 그룹 채팅 메시지에 응답할 수 있습니다. 그룹 답장은 기본적으로 @ 멘션이 필요하며, 허용 목록을 통해 더 제한할 수 있습니다.

상태: 번들 Plugin. DM, 그룹 멘션, 스레드 답장, 리치 텍스트 서식, 이미지 업로드가 지원됩니다. 반응과 투표는 아직 지원되지 않습니다.

번들 Plugin

Tlon은 현재 OpenClaw 릴리스에서 번들 Plugin으로 제공되므로, 일반 패키지 빌드에는 별도 설치가 필요하지 않습니다.

Tlon을 제외한 이전 빌드나 사용자 지정 설치를 사용 중이라면, 현재 npm 패키지를 설치하세요.

CLI(npm registry)를 통해 설치:

openclaw plugins install @openclaw/tlon

현재 공식 릴리스 태그를 따르려면 기본 패키지를 사용하세요. 재현 가능한 설치가 필요할 때만 정확한 버전을 고정하세요.

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

openclaw plugins install ./path/to/local/tlon-plugin

자세한 내용: Plugins

설정

  1. Tlon Plugin을 사용할 수 있는지 확인합니다.
    • 현재 패키지된 OpenClaw 릴리스에는 이미 번들되어 있습니다.
    • 이전/사용자 지정 설치에서는 위 명령으로 수동 추가할 수 있습니다.
  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",
      ownerShip: "~your-main-ship", // recommended: your ship, always allowed
    },
  },
}

비공개/LAN ship

기본적으로 OpenClaw는 SSRF 보호를 위해 비공개/내부 호스트 이름과 IP 범위를 차단합니다. ship이 비공개 네트워크(localhost, LAN IP 또는 내부 호스트 이름)에서 실행 중이라면 명시적으로 옵트인해야 합니다.

{
  channels: {
    tlon: {
      url: "http://localhost:8080",
      allowPrivateNetwork: true,
    },
  },
}

이는 다음과 같은 URL에 적용됩니다.

  • http://localhost:8080
  • http://192.168.x.x:8080
  • http://my-ship.local:8080

⚠️ 로컬 네트워크를 신뢰하는 경우에만 활성화하세요. 이 설정은 ship URL로 보내는 요청에 대한 SSRF 보호를 비활성화합니다.

그룹 채널

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

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

자동 검색 비활성화:

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

접근 제어

DM 허용 목록(비어 있음 = DM 허용 안 함, 승인 흐름에는 ownerShip 사용):

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

소유자 및 승인 시스템

권한이 없는 사용자가 상호작용하려고 할 때 승인 요청을 받을 소유자 ship을 설정합니다.

{
  channels: {
    tlon: {
      ownerShip: "~your-main-ship",
    },
  },
}

소유자 ship은 모든 곳에서 자동으로 권한이 부여됩니다. DM 초대는 자동 수락되며 채널 메시지는 항상 허용됩니다. 소유자를 dmAllowlist 또는 defaultAuthorizedShips에 추가할 필요가 없습니다.

설정하면 소유자는 다음에 대한 DM 알림을 받습니다.

  • 허용 목록에 없는 ship의 DM 요청
  • 권한 부여가 없는 채널의 멘션
  • 그룹 초대 요청

자동 수락 설정

DM 초대 자동 수락(dmAllowlist에 있는 ship의 경우):

{
  channels: {
    tlon: {
      autoAcceptDmInvites: true,
    },
  },
}

신뢰할 수 있는 ship의 그룹 초대 자동 수락:

{
  channels: {
    tlon: {
      autoAcceptGroupInvites: true,
      groupInviteAllowlist: ["~zod"],
    },
  },
}

autoAcceptGroupInvites는 groupInviteAllowlist가 비어 있으면 닫힌 상태로 실패합니다. 그룹 초대를 자동으로 수락할 ship으로 허용 목록을 설정하세요.

전달 대상(CLI/cron)

openclaw message send 또는 cron 전달과 함께 사용하세요.

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

번들 스킬

Tlon Plugin에는 Tlon 작업에 CLI 접근을 제공하는 번들 스킬(@tloncorp/tlon-skill)이 포함되어 있습니다.

  • 연락처: 프로필 가져오기/업데이트, 연락처 목록 표시
  • 채널: 목록 표시, 생성, 메시지 게시, 기록 가져오기
  • 그룹: 목록 표시, 생성, 멤버 관리
  • DM: 메시지 보내기, 메시지에 반응하기
  • 반응: 게시물과 DM에 이모지 반응 추가/제거
  • 설정: 슬래시 명령을 통해 Plugin 권한 관리

Plugin이 설치되면 스킬을 자동으로 사용할 수 있습니다.

기능

기능 상태
다이렉트 메시지 ✅ 지원됨
그룹/채널 ✅ 지원됨(기본적으로 멘션 게이트 적용)
스레드 ✅ 지원됨(스레드에서 자동 답장)
리치 텍스트 ✅ Markdown이 Tlon 형식으로 변환됨
이미지 ✅ Tlon 저장소에 업로드됨
반응 ✅ 번들 스킬을 통해 지원
투표 ❌ 아직 지원되지 않음
네이티브 명령 ✅ 지원됨(기본적으로 소유자 전용)

문제 해결

먼저 이 순서로 실행하세요.

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor

일반적인 실패:

  • DM 무시됨: 보낸 사람이 dmAllowlist에 없고 승인 흐름을 위한 ownerShip이 구성되지 않았습니다.
  • 그룹 메시지 무시됨: 채널이 검색되지 않았거나 보낸 사람에게 권한이 없습니다.
  • 연결 오류: ship URL에 접근 가능한지 확인하세요. 로컬 ship의 경우 allowPrivateNetwork를 활성화하세요.
  • 인증 오류: 로그인 코드가 최신인지 확인하세요(코드는 순환됩니다).

구성 참조

전체 구성: 구성

제공자 옵션:

  • channels.tlon.enabled: 채널 시작을 활성화/비활성화합니다.
  • channels.tlon.ship: 봇의 Urbit ship 이름(예: ~sampel-palnet).
  • channels.tlon.url: ship URL(예: https://sampel-palnet.tlon.network).
  • channels.tlon.code: ship 로그인 코드.
  • channels.tlon.allowPrivateNetwork: localhost/LAN URL 허용(SSRF 우회).
  • channels.tlon.ownerShip: 승인 시스템의 소유자 ship(항상 권한 부여됨).
  • channels.tlon.dmAllowlist: DM이 허용된 ship(비어 있음 = 없음).
  • channels.tlon.autoAcceptDmInvites: 허용 목록의 ship에서 온 DM을 자동 수락합니다.
  • channels.tlon.autoAcceptGroupInvites: 허용 목록의 ship에서 온 그룹 초대를 자동 수락합니다.
  • channels.tlon.groupInviteAllowlist: 그룹 초대를 자동 수락할 수 있는 ship.
  • channels.tlon.autoDiscoverChannels: 그룹 채널 자동 검색(기본값: true).
  • channels.tlon.groupChannels: 수동으로 고정한 채널 nest.
  • channels.tlon.defaultAuthorizedShips: 모든 채널에 대해 권한이 부여된 ship.
  • channels.tlon.authorization.channelRules: 채널별 인증 규칙.
  • channels.tlon.showModelSignature: 메시지에 모델 이름을 추가합니다.

참고

  • 그룹 답장은 응답하려면 멘션(예: ~your-bot-ship)이 필요합니다.
  • 스레드 답장: 수신 메시지가 스레드에 있으면 OpenClaw는 스레드 안에서 답장합니다.
  • 리치 텍스트: Markdown 서식(굵게, 기울임, 코드, 헤더, 목록)이 Tlon의 네이티브 형식으로 변환됩니다.
  • 이미지: URL은 Tlon 저장소에 업로드되고 이미지 블록으로 임베드됩니다.

관련 항목