Skip to main content

​
Nextcloud Talk (플러그인)

상태: 플러그인(웹훅 봇)을 통해 지원됨. 다이렉트 메시지, 방, 반응 및 마크다운 메시지가 지원됩니다.

​
플러그인 필요

Nextcloud Talk는 플러그인으로 제공되며 핵심 설치에 포함되어 있지 않습니다. CLI를 통해 설치(npm registry): 
openclaw plugins install @openclaw/nextcloud-talk
로컬 체크아웃(깃 저장소에서 실행 시): 
openclaw plugins install ./extensions/nextcloud-talk
구성/온보딩 중 Nextcloud Talk를 선택하고 깃 체크아웃이 감지되면, OpenClaw는 로컬 설치 경로를 자동으로 제공합니다. 자세한 내용: 플러그인

​
간단한 설정(초보자용)

  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. 게이트웨이를 재시작하거나 온보딩을 완료합니다.
최소 설정: 
{
  channels: {
    "nextcloud-talk": {
      enabled: true,
      baseUrl: "https://cloud.example.com",
      botSecret: "shared-secret",
      dmPolicy: "pairing",
    },
  },
}

​
주의 사항

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

​
접근 제어(다이렉트 메시지)

  • 기본값: channels.nextcloud-talk.dmPolicy = "pairing". 알 수 없는 발신자는 페어링 코드를 받습니다.
  • 다음을 통해 승인:
    • openclaw pairing list nextcloud-talk
    • openclaw pairing approve nextcloud-talk <CODE>
  • 공개 다이렉트 메시지: channels.nextcloud-talk.dmPolicy="open" 및 channels.nextcloud-talk.allowFrom=["*"].
  • allowFrom은 Nextcloud 사용자 ID만 일치합니다; 표시 이름은 무시됩니다.

​
방(그룹)

  • 기본값: 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)

전체 구성: 구성 프로바이더 옵션:
  • channels.nextcloud-talk.enabled: 채널 시작 활성화/비활성화.
  • channels.nextcloud-talk.baseUrl: Nextcloud 인스턴스 URL.
  • channels.nextcloud-talk.botSecret: 봇 공유 비밀.
  • channels.nextcloud-talk.botSecretFile: 비밀 파일 경로.
  • channels.nextcloud-talk.apiUser: 방 조회(API 탐지)용 API 사용자.
  • channels.nextcloud-talk.apiPassword: 방 조회용 API/앱 비밀번호.
  • channels.nextcloud-talk.apiPasswordFile: API 비밀번호 파일 경로.
  • channels.nextcloud-talk.webhookPort: 웹훅 리스너 포트(기본값: 8788).
  • channels.nextcloud-talk.webhookHost: 웹훅 호스트(기본값: 0.0.0.0).
  • channels.nextcloud-talk.webhookPath: 웹훅 경로(기본값: /nextcloud-talk-webhook).
  • channels.nextcloud-talk.webhookPublicUrl: 외부에서 접근 가능한 웹훅 URL.
  • channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
  • channels.nextcloud-talk.allowFrom: 다이렉트 메시지 허용 목록(사용자 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: 다이렉트 메시지 기록 제한(0은 비활성화).
  • channels.nextcloud-talk.dms: 다이렉트 메시지별 재정의(기록 제한).
  • channels.nextcloud-talk.textChunkLimit: 발신 텍스트 청크 크기(문자).
  • channels.nextcloud-talk.chunkMode: length (기본값) 또는 빈 줄(단락 경계)로 나눈 후 길이 청크로 분할하려면 newline.
  • channels.nextcloud-talk.blockStreaming: 이 채널에 대한 블록 스트리밍 비활성화.
  • channels.nextcloud-talk.blockStreamingCoalesce: 블록 스트리밍 병합 조정.
  • channels.nextcloud-talk.mediaMaxMb: 수신 미디어 제한(MB).