메인 콘텐츠로 건너뛰기

​
Nextcloud Talk

상태: 번들 plugin(webhook bot). 다이렉트 메시지, 룸, 반응, 마크다운 메시지가 지원됩니다.

​
번들 plugin

Nextcloud Talk는 현재 OpenClaw 릴리스에 번들 plugin으로 포함되어 있으므로 일반 패키지 빌드에서는 별도 설치가 필요하지 않습니다. 이전 빌드 또는 Nextcloud Talk가 제외된 사용자 지정 설치를 사용하는 경우 수동으로 설치하세요. CLI를 통해 설치(npm 레지스트리): 
openclaw plugins install @openclaw/nextcloud-talk
로컬 체크아웃(git 리포지토리에서 실행하는 경우): 
openclaw plugins install ./path/to/local/nextcloud-talk-plugin
자세한 내용: Plugins

​
빠른 설정(초보자용)

  1. Nextcloud Talk plugin을 사용할 수 있는지 확인합니다.
    • 현재 패키지된 OpenClaw 릴리스에는 이미 번들로 포함되어 있습니다.
    • 이전/사용자 지정 설치에서는 위 명령으로 수동 추가할 수 있습니다.
  2. Nextcloud 서버에서 bot을 생성합니다. 
    ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature reaction
  3. 대상 룸 설정에서 bot을 활성화합니다.
  4. OpenClaw를 구성합니다.
    • Config: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
    • 또는 env: NEXTCLOUD_TALK_BOT_SECRET (기본 계정 전용)
  5. gateway를 다시 시작합니다(또는 설정을 완료합니다).
최소 구성: 
{
  channels: {
    "nextcloud-talk": {
      enabled: true,
      baseUrl: "https://cloud.example.com",
      botSecret: "shared-secret",
      dmPolicy: "pairing",
    },
  },
}

​
참고

  • bot은 DM을 시작할 수 없습니다. 사용자가 먼저 bot에 메시지를 보내야 합니다.
  • webhook URL은 Gateway에서 도달 가능해야 합니다. 프록시 뒤에 있는 경우 webhookPublicUrl을 설정하세요.
  • bot API는 미디어 업로드를 지원하지 않으므로 미디어는 URL로 전송됩니다.
  • webhook payload는 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=["*"].
  • 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)

전체 구성: 구성 Provider 옵션:
  • channels.nextcloud-talk.enabled: 채널 시작 활성화/비활성화
  • channels.nextcloud-talk.baseUrl: Nextcloud 인스턴스 URL
  • channels.nextcloud-talk.botSecret: bot 공유 시크릿
  • channels.nextcloud-talk.botSecretFile: 일반 파일 시크릿 경로. 심볼릭 링크는 거부됩니다.
  • channels.nextcloud-talk.apiUser: 룸 조회(DM 감지)용 API 사용자
  • 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)

​
관련 문서