Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

สถานะ: Plugin ที่รวมมาให้ (บอต Webhook) รองรับข้อความโดยตรง ห้อง ปฏิกิริยา และข้อความ Markdown

​
Plugin ที่รวมมาให้

Nextcloud Talk จัดส่งมาเป็น Plugin ที่รวมมาให้ใน OpenClaw รุ่นปัจจุบัน ดังนั้น บิลด์ที่แพ็กเกจตามปกติจึงไม่จำเป็นต้องติดตั้งแยกต่างหาก หากคุณใช้บิลด์เก่ากว่าหรือการติดตั้งแบบกำหนดเองที่ไม่รวม Nextcloud Talk ให้ติดตั้งแพ็กเกจ npm โดยตรง: ติดตั้งผ่าน CLI (รีจิสทรี npm): 
openclaw plugins install @openclaw/nextcloud-talk
ใช้แพ็กเกจเปล่าเพื่อติดตามแท็กรุ่นทางการปัจจุบัน ปักหมุดเวอร์ชันที่แน่นอน เฉพาะเมื่อคุณต้องการการติดตั้งที่ทำซ้ำได้เท่านั้น เช็กเอาต์ในเครื่อง (เมื่อรันจาก git repo): 
openclaw plugins install ./path/to/local/nextcloud-talk-plugin
รายละเอียด: Plugins

​
การตั้งค่าอย่างรวดเร็ว (ผู้เริ่มต้น)

  1. ตรวจสอบให้แน่ใจว่า Plugin Nextcloud Talk พร้อมใช้งาน
    • OpenClaw รุ่นแพ็กเกจปัจจุบันรวมไว้แล้ว
    • การติดตั้งรุ่นเก่า/แบบกำหนดเองสามารถเพิ่มเองได้ด้วยคำสั่งด้านบน
  2. บนเซิร์ฟเวอร์ Nextcloud ของคุณ ให้สร้างบอต: 
    ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction
  3. เปิดใช้บอตในการตั้งค่าห้องเป้าหมาย
  4. กำหนดค่า OpenClaw:
    • การกำหนดค่า: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
    • หรือ env: NEXTCLOUD_TALK_BOT_SECRET (เฉพาะบัญชีค่าเริ่มต้น)
    การตั้งค่าผ่าน CLI: 
    openclaw channels add --channel nextcloud-talk \
  --url https://cloud.example.com \
  --token "<shared-secret>"
    ฟิลด์แบบระบุชัดเจนที่เทียบเท่า: 
    openclaw channels add --channel nextcloud-talk \
  --base-url https://cloud.example.com \
  --secret "<shared-secret>"
    ความลับที่อิงจากไฟล์: 
    openclaw channels add --channel nextcloud-talk \
  --base-url https://cloud.example.com \
  --secret-file /path/to/nextcloud-talk-secret
  5. รีสตาร์ท Gateway (หรือทำการตั้งค่าให้เสร็จ)
การกำหนดค่าขั้นต่ำ: 
{
  channels: {
    "nextcloud-talk": {
      enabled: true,
      baseUrl: "https://cloud.example.com",
      botSecret: "shared-secret",
      dmPolicy: "pairing",
    },
  },
}

​
หมายเหตุ

  • บอตไม่สามารถเริ่ม DM ได้ ผู้ใช้ต้องส่งข้อความหาบอตก่อน
  • URL ของ Webhook ต้องเข้าถึงได้โดย Gateway; ตั้งค่า webhookPublicUrl หากอยู่หลังพร็อกซี
  • การอัปโหลดสื่อไม่รองรับโดย 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=["*"]
  • allowFrom จับคู่เฉพาะ ID ผู้ใช้ Nextcloud เท่านั้น; ชื่อที่แสดงจะถูกละเว้น

​
ห้อง (กลุ่ม)

  • ค่าเริ่มต้น: 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: URL ของอินสแตนซ์ Nextcloud
  • channels.nextcloud-talk.botSecret: ความลับร่วมของบอต
  • channels.nextcloud-talk.botSecretFile: พาธความลับแบบไฟล์ปกติ Symlink จะถูกปฏิเสธ
  • 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: URL ของ Webhook ที่เข้าถึงได้จากภายนอก
  • 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: การตั้งค่าและรายการอนุญาตต่อห้อง
  • กลุ่มการเข้าถึงผู้ส่งแบบคงที่สามารถอ้างอิงจาก allowFrom และ groupAllowFrom ด้วย accessGroup:<name>
  • 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)

​
ที่เกี่ยวข้อง