> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openclaw.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# Nextcloud Talk

# Nextcloud Talk (플러그인)

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

## 플러그인 필요

Nextcloud Talk는 플러그인으로 제공되며 핵심 설치에 포함되어 있지 않습니다.

CLI를 통해 설치(npm registry):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/nextcloud-talk
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install ./extensions/nextcloud-talk
```

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

자세한 내용: [플러그인](/ko-KR/tools/plugin)

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

1. Nextcloud Talk 플러그인을 설치합니다.

2. Nextcloud 서버에서 봇을 생성합니다:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   ./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. 게이트웨이를 재시작하거나 온보딩을 완료합니다.

최소 설정:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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`로 허용된 방 목록을 지정:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true },
      },
    },
  },
}
```

* 방을 허용하지 않으려면, 허용 목록을 비워 두거나 `channels.nextcloud-talk.groupPolicy="disabled"`로 설정하십시오.

## 기능

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

## 구성 참조(Nextcloud Talk)

전체 구성: [구성](/ko-KR/gateway/configuration)

프로바이더 옵션:

* `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).