Documentation Index

Fetch the complete documentation index at: https://openclawhub.vn/llms.txt

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

​

Synology Chat (plugin)

​

Yêu cầu plugin

openclaw plugins install ./extensions/synology-chat

​

Cài đặt nhanh

1. Cài đặt và kích hoạt plugin Synology Chat.
   • openclaw onboard hiện hiển thị Synology Chat trong danh sách cài đặt kênh như openclaw channels add.
   • Cài đặt không tương tác: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
2. Trong phần tích hợp của Synology Chat:
   • Tạo một incoming webhook và sao chép URL của nó.
   • Tạo một outgoing webhook với secret token của bạn.
3. Trỏ URL của outgoing webhook đến gateway của OpenClaw:
   • Mặc định là https://gateway-host/webhook/synology.
   • Hoặc channels.synology-chat.webhookPath tùy chỉnh của bạn.
4. Hoàn tất cài đặt trong OpenClaw.
   • Hướng dẫn: openclaw onboard
   • Trực tiếp: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
5. Khởi động lại gateway và gửi tin nhắn trực tiếp đến bot Synology Chat.

{
  channels: {
    "synology-chat": {
      enabled: true,
      token: "synology-outgoing-token",
      incomingUrl: "https://nas.example.com/webapi/entry.cgi?api=SYNO.Chat.External&method=incoming&version=2&token=...",
      webhookPath: "/webhook/synology",
      dmPolicy: "allowlist",
      allowedUserIds: ["123456"],
      rateLimitPerMinute: 30,
      allowInsecureSsl: false,
    },
  },
}

​

Biến môi trường

• SYNOLOGY_CHAT_TOKEN
• SYNOLOGY_CHAT_INCOMING_URL
• SYNOLOGY_NAS_HOST
• SYNOLOGY_ALLOWED_USER_IDS (phân tách bằng dấu phẩy)
• SYNOLOGY_RATE_LIMIT
• OPENCLAW_BOT_NAME

​

Chính sách DM và kiểm soát truy cập

• dmPolicy: "allowlist" là mặc định được khuyến nghị.
• allowedUserIds chấp nhận danh sách (hoặc chuỗi phân tách bằng dấu phẩy) các ID người dùng Synology.
• Trong chế độ allowlist, danh sách allowedUserIds trống được coi là cấu hình sai và tuyến webhook sẽ không khởi động (sử dụng dmPolicy: "open" để cho phép tất cả).
• dmPolicy: "open" cho phép bất kỳ người gửi nào.
• dmPolicy: "disabled" chặn tin nhắn trực tiếp.
• Phê duyệt ghép đôi hoạt động với:
  • openclaw pairing list synology-chat
  • openclaw pairing approve synology-chat <CODE>

​

Gửi đi

openclaw message send --channel synology-chat --target 123456 --text "Hello from OpenClaw"
openclaw message send --channel synology-chat --target synology-chat:123456 --text "Hello again"

​

Nhiều tài khoản

{
  channels: {
    "synology-chat": {
      enabled: true,
      accounts: {
        default: {
          token: "token-a",
          incomingUrl: "https://nas-a.example.com/...token=...",
        },
        alerts: {
          token: "token-b",
          incomingUrl: "https://nas-b.example.com/...token=...",
          webhookPath: "/webhook/synology-alerts",
          dmPolicy: "allowlist",
          allowedUserIds: ["987654"],
        },
      },
    },
  },
}

​

Ghi chú bảo mật

• Giữ bí mật token và thay đổi nó nếu bị lộ.
• Giữ allowInsecureSsl: false trừ khi bạn tin tưởng vào chứng chỉ NAS tự ký cục bộ.
• Các yêu cầu webhook inbound được xác minh bằng token và giới hạn tốc độ theo từng người gửi.
• Ưu tiên dmPolicy: "allowlist" cho môi trường sản xuất.