Nextcloud Talk - OpenClaw

Trạng thái: Plugin đi kèm (bot Webhook). Hỗ trợ tin nhắn trực tiếp, phòng, phản ứng và tin nhắn Markdown.

Plugin đi kèm

Nextcloud Talk được phát hành dưới dạng Plugin đi kèm trong các bản phát hành OpenClaw hiện tại, nên các bản dựng đóng gói thông thường không cần cài đặt riêng. Nếu bạn đang dùng bản dựng cũ hơn hoặc bản cài đặt tùy chỉnh loại trừ Nextcloud Talk, hãy cài đặt trực tiếp gói npm: Cài đặt qua CLI (npm registry):

openclaw plugins install @openclaw/nextcloud-talk

Dùng gói không kèm phiên bản để đi theo thẻ phát hành chính thức hiện tại. Chỉ ghim một phiên bản chính xác khi bạn cần bản cài đặt có thể tái lập. Bản checkout cục bộ (khi chạy từ repo git):

openclaw plugins install ./path/to/local/nextcloud-talk-plugin

Chi tiết: Plugins

Thiết lập nhanh (người mới bắt đầu)

Đảm bảo Plugin Nextcloud Talk có sẵn.
- Các bản phát hành OpenClaw đóng gói hiện tại đã đi kèm Plugin này.
- Các bản cài đặt cũ hơn/tùy chỉnh có thể thêm thủ công bằng các lệnh ở trên.

Trên máy chủ Nextcloud của bạn, tạo một bot:

./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction

Bật bot trong phần cài đặt phòng đích.

Cấu hình OpenClaw:

Cấu hình: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
Hoặc env: NEXTCLOUD_TALK_BOT_SECRET (chỉ tài khoản mặc định)

Thiết lập CLI:

openclaw channels add --channel nextcloud-talk \
  --url https://cloud.example.com \
  --token "<shared-secret>"

Các trường rõ ràng tương đương:

openclaw channels add --channel nextcloud-talk \
  --base-url https://cloud.example.com \
  --secret "<shared-secret>"

Bí mật dựa trên tệp:

openclaw channels add --channel nextcloud-talk \
  --base-url https://cloud.example.com \
  --secret-file /path/to/nextcloud-talk-secret

Khởi động lại Gateway (hoặc hoàn tất thiết lập).

Cấu hình tối thiểu:

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

Ghi chú

Bot không thể khởi tạo DM. Người dùng phải nhắn tin cho bot trước.
URL Webhook phải có thể được Gateway truy cập; đặt webhookPublicUrl nếu nằm sau proxy.
API bot không hỗ trợ tải lên media; media được gửi dưới dạng URL.
Payload Webhook không phân biệt DM với phòng; đặt apiUser + apiPassword để bật tra cứu loại phòng (nếu không, DM được xử lý như phòng).

Kiểm soát truy cập (DM)

Mặc định: channels.nextcloud-talk.dmPolicy = "pairing". Người gửi chưa biết sẽ nhận mã ghép nối.
Phê duyệt qua:
- openclaw pairing list nextcloud-talk
- openclaw pairing approve nextcloud-talk <CODE>
DM công khai: channels.nextcloud-talk.dmPolicy="open" cộng với channels.nextcloud-talk.allowFrom=["*"].
allowFrom chỉ khớp với ID người dùng Nextcloud; tên hiển thị bị bỏ qua.

Phòng (nhóm)

Mặc định: channels.nextcloud-talk.groupPolicy = "allowlist" (được kiểm soát bằng đề cập).
Cho phép phòng bằng allowlist với channels.nextcloud-talk.rooms:

{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true },
      },
    },
  },
}

Để không cho phép phòng nào, hãy giữ allowlist rỗng hoặc đặt channels.nextcloud-talk.groupPolicy="disabled".

Khả năng

Tính năng	Trạng thái
Tin nhắn trực tiếp	Được hỗ trợ
Phòng	Được hỗ trợ
Luồng	Không được hỗ trợ
Media	Chỉ URL
Phản ứng	Được hỗ trợ
Lệnh native	Không được hỗ trợ

Tham chiếu cấu hình (Nextcloud Talk)

Cấu hình đầy đủ: Cấu hình Tùy chọn nhà cung cấp:

channels.nextcloud-talk.enabled: bật/tắt khởi động kênh.
channels.nextcloud-talk.baseUrl: URL phiên bản Nextcloud.
channels.nextcloud-talk.botSecret: bí mật dùng chung của bot.
channels.nextcloud-talk.botSecretFile: đường dẫn bí mật dạng tệp thông thường. Symlink bị từ chối.
channels.nextcloud-talk.apiUser: người dùng API để tra cứu phòng (phát hiện DM).
channels.nextcloud-talk.apiPassword: mật khẩu API/ứng dụng để tra cứu phòng.
channels.nextcloud-talk.apiPasswordFile: đường dẫn tệp mật khẩu API.
channels.nextcloud-talk.webhookPort: cổng trình nghe Webhook (mặc định: 8788).
channels.nextcloud-talk.webhookHost: host Webhook (mặc định: 0.0.0.0).
channels.nextcloud-talk.webhookPath: đường dẫn Webhook (mặc định: /nextcloud-talk-webhook).
channels.nextcloud-talk.webhookPublicUrl: URL Webhook có thể truy cập từ bên ngoài.
channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
channels.nextcloud-talk.allowFrom: allowlist DM (ID người dùng). open yêu cầu "*".
channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
channels.nextcloud-talk.groupAllowFrom: allowlist nhóm (ID người dùng).
channels.nextcloud-talk.rooms: cài đặt và allowlist theo từng phòng.
Có thể tham chiếu nhóm truy cập người gửi tĩnh từ allowFrom và groupAllowFrom bằng accessGroup:<name>.
channels.nextcloud-talk.historyLimit: giới hạn lịch sử nhóm (0 để tắt).
channels.nextcloud-talk.dmHistoryLimit: giới hạn lịch sử DM (0 để tắt).
channels.nextcloud-talk.dms: ghi đè theo từng DM (historyLimit).
channels.nextcloud-talk.textChunkLimit: kích thước đoạn văn bản gửi đi (ký tự).
channels.nextcloud-talk.chunkMode: length (mặc định) hoặc newline để tách theo dòng trống (ranh giới đoạn văn) trước khi chia đoạn theo độ dài.
channels.nextcloud-talk.blockStreaming: tắt phát trực tuyến theo khối cho kênh này.
channels.nextcloud-talk.blockStreamingCoalesce: tinh chỉnh gộp phát trực tuyến theo khối.
channels.nextcloud-talk.mediaMaxMb: giới hạn media đầu vào (MB).

Liên quan

Tổng quan về kênh — tất cả kênh được hỗ trợ
Ghép nối — xác thực DM và luồng ghép nối
Nhóm — hành vi trò chuyện nhóm và kiểm soát bằng đề cập
Định tuyến kênh — định tuyến phiên cho tin nhắn
Bảo mật — mô hình truy cập và gia cố

Documentation Index

​Plugin đi kèm

​Thiết lập nhanh (người mới bắt đầu)

​Ghi chú

​Kiểm soát truy cập (DM)

​Phòng (nhóm)

​Khả năng

​Tham chiếu cấu hình (Nextcloud Talk)

​Liên quan