Nextcloud Talk (플러그인)

상태: 플러그인을 통해 지원됩니다(webhook 봇). 다이렉트 메시지, 방, 반응, markdown 메시지가 지원됩니다.

플러그인 필요

Nextcloud Talk는 플러그인으로 제공되며 코어 설치에 번들되지 않습니다.

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

openclaw plugins install @openclaw/nextcloud-talk

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

openclaw plugins install ./extensions/nextcloud-talk

구성/온보딩 중에 Nextcloud Talk를 선택하고 git 체크아웃이 감지되면, OpenClaw가 자동으로 로컬 설치 경로를 제공합니다.

자세한 내용: Plugins

빠른 설정 (초보자용)

  1. Nextcloud Talk 플러그인을 설치합니다.
  2. Nextcloud 서버에서 봇을 생성합니다: 
    ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature reaction
  3. 대상 방 설정에서 봇을 활성화합니다.
  4. OpenClaw를 구성합니다:
    • 설정: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
    • 또는 환경 변수: NEXTCLOUD_TALK_BOT_SECRET (기본 계정만)
  5. Gateway를 재시작합니다(또는 온보딩을 완료합니다).

최소 설정:

{
  channels: {
    "nextcloud-talk": {
      enabled: true,
      baseUrl: "https://cloud.example.com",
      botSecret: "shared-secret",
      dmPolicy: "pairing"
    }
  }
}

참고사항

  • 봇은 DM을 시작할 수 없습니다. 사용자가 먼저 봇에게 메시지를 보내야 합니다.
  • Webhook URL은 Gateway에서 접근 가능해야 합니다. 프록시 뒤에 있는 경우 webhookPublicUrl을 설정하세요.
  • 미디어 업로드는 bot API에서 지원되지 않습니다. 미디어는 URL로 전송됩니다.
  • Webhook 페이로드는 DM과 방을 구별하지 않습니다. 방 유형 조회를 활성화하려면 apiUser + apiPassword를 설정하세요(그렇지 않으면 DM이 방으로 처리됨).

접근 제어 (DM)

  • 기본값: channels.nextcloud-talk.dmPolicy = "pairing". 알 수 없는 발신자는 페어링 코드를 받습니다.
  • 승인 방법:
    • openclaw pairing list nextcloud-talk
    • openclaw pairing approve nextcloud-talk <CODE>
  • 공개 DM: channels.nextcloud-talk.dmPolicy="open" 및 channels.nextcloud-talk.allowFrom=["*"].

방 (그룹)

  • 기본값: channels.nextcloud-talk.groupPolicy = "allowlist" (멘션 게이팅).
  • channels.nextcloud-talk.rooms로 방을 허용목록에 추가합니다:
{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true }
      }
    }
  }
}
  • 방을 허용하지 않으려면 허용목록을 비워두거나 channels.nextcloud-talk.groupPolicy="disabled"로 설정하세요.

기능

기능상태
다이렉트 메시지지원됨
방지원됨
스레드지원되지 않음
미디어URL만
반응지원됨
네이티브 명령지원되지 않음

설정 참조 (Nextcloud Talk)

전체 설정: Configuration

제공자 옵션:

  • channels.nextcloud-talk.enabled: 채널 시작 활성화/비활성화.
  • channels.nextcloud-talk.baseUrl: Nextcloud 인스턴스 URL.
  • channels.nextcloud-talk.botSecret: 봇 공유 시크릿.
  • channels.nextcloud-talk.botSecretFile: 시크릿 파일 경로.
  • channels.nextcloud-talk.apiUser: 방 조회용 API 사용자 (DM 감지).
  • channels.nextcloud-talk.apiPassword: 방 조회용 API/앱 비밀번호.
  • channels.nextcloud-talk.apiPasswordFile: API 비밀번호 파일 경로.
  • channels.nextcloud-talk.webhookPort: webhook 리스너 포트 (기본값: 8788).
  • channels.nextcloud-talk.webhookHost: webhook 호스트 (기본값: 0.0.0.0).
  • channels.nextcloud-talk.webhookPath: webhook 경로 (기본값: /nextcloud-talk-webhook).
  • channels.nextcloud-talk.webhookPublicUrl: 외부에서 접근 가능한 webhook URL.
  • channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
  • channels.nextcloud-talk.allowFrom: DM 허용목록 (사용자 ID). open은 "*"가 필요합니다.
  • channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
  • channels.nextcloud-talk.groupAllowFrom: 그룹 허용목록 (사용자 ID).
  • channels.nextcloud-talk.rooms: 방별 설정 및 허용목록.
  • channels.nextcloud-talk.historyLimit: 그룹 히스토리 제한 (0은 비활성화).
  • channels.nextcloud-talk.dmHistoryLimit: DM 히스토리 제한 (0은 비활성화).
  • channels.nextcloud-talk.dms: DM별 재정의 (historyLimit).
  • channels.nextcloud-talk.textChunkLimit: 아웃바운드 텍스트 청크 크기 (문자).
  • channels.nextcloud-talk.chunkMode: length (기본값) 또는 newline으로 길이 청킹 전에 빈 줄(단락 경계)로 분할.
  • channels.nextcloud-talk.blockStreaming: 이 채널에 대한 블록 스트리밍 비활성화.
  • channels.nextcloud-talk.blockStreamingCoalesce: 블록 스트리밍 병합 튜닝.
  • channels.nextcloud-talk.mediaMaxMb: 인바운드 미디어 제한 (MB).
← 문서로 돌아가기