Tlon

Tlon은 Urbit을 기반으로 구축된 탈중앙화 메신저입니다. OpenClaw는 사용자의 Urbit ship에 연결하여 DM과 그룹 채팅 메시지에 응답합니다. 그룹 응답에는 기본적으로 @ 멘션이 필요하며, 그 위에 권한 부여 규칙과 소유자 승인 흐름이 적용됩니다.

상태: 번들 Plugin. DM, 그룹 멘션, 스레드, 서식 있는 텍스트, 이미지 업로드/다운로드 및 소유자 승인 시스템을 지원합니다. 반응과 투표는 지원하지 않습니다.

번들 Plugin

현재 OpenClaw 릴리스에는 Tlon이 번들로 제공되므로 패키징된 빌드에서는 별도로 설치할 필요가 없습니다.

이 Plugin이 제외된 이전 빌드나 사용자 지정 설치에서는 npm으로 설치합니다.

openclaw plugins install @openclaw/tlon

현재 릴리스 태그를 추적하려면 버전 없는 패키지 이름을 사용합니다. 재현 가능한 설치가 필요한 경우에만 버전(@openclaw/tlon@x.y.z)을 고정합니다.

로컬 체크아웃에서 설치하려면 다음을 실행합니다.

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

자세한 내용: Plugin

설정

openclaw channels add --channel tlon --ship ~sampel-palnet --url https://your-ship-host --code lidlut-tabwed-pillex-ridrup

또는 구성을 직접 편집합니다.

{  channels: {    tlon: {      enabled: true,      ship: "~sampel-palnet",      url: "https://your-ship-host",      code: "lidlut-tabwed-pillex-ridrup",      ownerShip: "~your-main-ship", // 권장: 사용자의 ship이며 항상 권한이 부여됨    },  },}

구성을 직접 편집한 후 Gateway를 다시 시작합니다. 그런 다음 봇에 DM을 보내거나 그룹 채널에서 @ 멘션합니다.

비공개/LAN ship

OpenClaw는 기본적으로 SSRF 보호를 위해 비공개/내부 호스트 이름과 IP 범위를 차단합니다. ship이 비공개 네트워크(localhost, LAN IP, 내부 호스트 이름)에서 실행되는 경우 명시적으로 허용합니다.

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

http://localhost:8080, http://192.168.x.x:8080, http://my-ship.local:8080 같은 대상에 적용됩니다. 신뢰하는 ship URL에만 활성화하세요. 이 설정은 해당 계정의 HTTP 요청에 대한 SSRF 보호를 비활성화합니다.

그룹 채널

채널을 수동으로 고정하거나 자동 검색을 활성화합니다.

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

구성에 설정되지 않은 경우 autoDiscoverChannels의 기본값은 false입니다. 설정 마법사의 프롬프트 기본값은 예이며 true를 명시적으로 기록합니다. 활성화하면 OpenClaw는 시작 시 참여한 그룹을 scry하고, 그룹 초대가 수락될 때 새 채널을 감시하며, 2분마다 다시 확인합니다.

접근 제어

DM 허용 목록(비어 있으면 발신자가 ownerShip인 경우를 제외하고 DM을 허용하지 않음):

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

그룹 권한 부여는 채널별로 기본값이 restricted입니다. 기준값으로 defaultAuthorizedShips를 설정하고 채널 nest별로 재정의합니다.

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

봇이 스레드 안에서 한 번 응답하면, 이후 해당 스레드의 메시지에는 다시 멘션하지 않아도 계속 응답합니다.

소유자 및 승인 시스템

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

소유자 ship에는 모든 위치에서 권한이 부여됩니다. DM 초대와 그룹 초대는 항상 자동 수락되며, 채널 메시지는 항상 권한 검사를 통과합니다. 소유자는 dmAllowlist, defaultAuthorizedShips 또는 groupInviteAllowlist에 포함될 필요가 없습니다.

ownerShip이 설정된 경우 권한이 없는 요청은 단순히 삭제되지 않습니다. 대기 중인 승인으로 대기열에 추가되고 소유자에게 DM이 전송됩니다.

• dmAllowlist에 없는 ship의 DM 요청
• 발신자가 권한 검사를 통과하지 못한 채널의 멘션
• groupInviteAllowlist에 없는 ship의 그룹 초대(자동 수락이 꺼져 있거나, 켜져 있지만 초대자가 허용 목록에 없는 경우)

소유자는 DM으로 응답하여 요청을 처리합니다.

ownerShip이 구성되지 않은 경우 권한이 없는 DM과 채널 멘션은 단순히 삭제되고 기록되며, 승인 프롬프트는 표시되지 않습니다.

자동 수락 설정

이미 dmAllowlist에 있는 ship의 DM 초대를 자동 수락합니다(이 플래그와 관계없이 소유자는 항상 자동 수락됨).

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

허용 목록에 있는 그룹 초대를 자동 수락합니다(안전하게 거부: autoAcceptGroupInvites: true이고 groupInviteAllowlist가 비어 있으면 소유자가 아닌 사용자의 초대는 수락되지 않음).

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

Urbit 설정 저장소를 통한 핫 리로드

위 설정 대부분(dmAllowlist, groupInviteAllowlist, groupChannels, defaultAuthorizedShips, autoDiscoverChannels, autoAcceptDmInvites, autoAcceptGroupInvites, ownerShip, showModelSignature)은 처음 실행할 때 ship의 %settings 에이전트(desk moltbot, bucket tlon)에 미러링된 후 그 위치에서 실시간으로 읽힙니다. 따라서 Landscape 클라이언트나 번들 Skills의 설정 명령을 통해 변경한 내용은 Gateway를 다시 시작하지 않아도 적용됩니다. channelRules와 대기 중인 승인도 JSON으로 해당 위치에 저장됩니다. 설정 저장소에 기록된 적이 없는 값에는 파일 구성이 계속 기준 정보로 사용됩니다.

전송 대상(CLI/cron)

openclaw message send 또는 Cron 전송과 함께 사용합니다.

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

번들 Skills

Plugin에는 직접 Urbit 작업을 위한 CLI인 @tloncorp/tlon-skill이 번들로 포함되며, Plugin이 설치되면 자동으로 사용할 수 있습니다.

• 활동: 멘션, 답글, 읽지 않은 항목
• 채널: 목록 조회, 생성, 이름 변경
• 연락처: 프로필 목록 조회/가져오기/업데이트
• 그룹: 생성, 참여, 초대/요청 흐름, 역할
• 훅: 채널 훅 관리
• 메시지: 기록, 검색
• DM: 전송, 반응, 수락/거절
• 게시물: 반응, 삭제
• 노트북: 일기 채널에 게시
• 설정: 위 설정 저장소를 통해 Plugin 구성을 핫 리로드

기능

문제 해결

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor

일반적인 오류:

• DM이 무시됨: 발신자가 dmAllowlist에 없고 승인 흐름을 위한 ownerShip도 구성되지 않았습니다.
• 그룹 메시지가 무시됨: 채널이 검색되거나 고정되지 않았거나, 발신자가 권한 검사를 통과하지 못했고 승인을 대기열에 추가할 ownerShip도 없습니다.
• 연결 오류: ship URL에 접근할 수 있는지 확인하고, 로컬 ship에는 network.dangerouslyAllowPrivateNetwork를 설정합니다.
• 인증 오류: 로그인 코드는 주기적으로 변경되므로 ship에서 현재 코드를 복사합니다.

구성 참조

전체 구성: 구성

참고 사항

• 봇이 이미 해당 스레드에 참여한 경우를 제외하면 그룹 응답에는 @ 멘션(예: ~your-bot-ship)이 필요합니다.
• 스레드 응답은 스레드 내에 게시되며, 에이전트를 위해 스레드 문맥의 최근 메시지 10개도 앞에 추가됩니다.
• 서식 있는 텍스트(굵게, 기울임꼴, 코드, 헤더, 목록)는 Tlon의 네이티브 형식으로 변환됩니다.
• 채널 요약을 요청하는 수신 메시지(예: "이 채널을 요약해 줘")를 보내면 일반 응답 흐름 대신 내장된 기록 요약 기능이 실행됩니다.

관련 문서

• 채널 개요 — 지원되는 모든 채널
• 페어링 — DM 인증 및 페어링 흐름
• 그룹 — 그룹 채팅 동작 및 멘션 요구
• 채널 라우팅 — 메시지 세션 라우팅
• 보안 — 접근 모델 및 보안 강화