القائمة
Điều khiển plugin Zalo Mod bằng ngôn ngữ tự nhiên — bật/tắt mute, silent, welcome, follow theo nhóm; đọc và tổng hợp lịch sử chat nhóm; chạy các action của dashboard. Dùng khi owner nhờ đổi cấu hình bot Zalo, hỏi trạng thái nhóm, hoặc tổng hợp nội dung chat.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | zalo-mod-control |
| description | Điều khiển plugin Zalo Mod bằng ngôn ngữ tự nhiên — bật/tắt mute, silent, welcome, follow theo nhóm; đọc và tổng hợp lịch sử chat nhóm; chạy các action của dashboard. Dùng khi owner nhờ đổi cấu hình bot Zalo, hỏi trạng thái nhóm, hoặc tổng hợp nội dung chat. |
Skill này đi kèm plugin openclaw-zalo-mod. Nó cho bạn điều khiển toàn bộ Zalo Mod bằng lời nói của owner — owner không cần nhớ slash command, không cần tự bấm badge trên dashboard.
Bạn không được nói "đã mute rồi", "đã bật follow", "đã đồng bộ xong"… khi chưa gọi tool và chưa thấy kết quả trả về.
Đây từng là lỗi thật: bot trả lời "đã mute" trong khi badge trên dashboard Zalo Mod vẫn đang tắt, vì bot không hề chạm được vào state.
Quy trình bắt buộc cho mọi yêu cầu đổi cấu hình:
zalo_mod_settings (hoặc zalo_mod_action).applied và mảng groups trong kết quả.groups — nêu tên nhóm + trạng thái mới.ok: false → nói thẳng là chưa làm được và nêu lý do trong error. Không diễn giải thành "đã xử lý".Nếu tool trả code: "PRO_REQUIRED" hoặc "TEAM_REQUIRED": đó là giới hạn gói license, không phải lỗi kỹ thuật. Nói rõ cho owner và gợi ý làm từng nhóm một hoặc nâng gói.
Bốn tool này chỉ owner của bot dùng được — host tự chặn, bạn không cần tự kiểm tra quyền. Nếu tool trả lỗi "chỉ owner", hãy nói thật với người dùng là họ không có quyền.
| Tool | Dùng khi nào |
|---|---|
zalo_mod_groups | Xem danh sách nhóm + trạng thái thật của mọi toggle. Gọi TRƯỚC khi trả lời câu hỏi về cấu hình, và SAU khi đổi để xác nhận. |
zalo_mod_settings | Bật/tắt muted, silent, welcome, follow, tracking, pendingAuto, autoSummary cho một hoặc nhiều nhóm. Tương đương bấm badge trên dashboard. |
zalo_mod_history | Đọc lịch sử chat đã ghi của các nhóm đang bật follow, kèm ghi chú admin + memory. Dùng để tự tổng hợp. |
zalo_mod_reports | Xem/tạo/sửa lịch báo cáo lịch sử chat. Dùng khi owner nói "đổi lịch báo cáo thành 9h", "gửi báo cáo vào nhóm X", "tạo lịch tổng hợp", "gửi thử báo cáo". Tham số PHẲNG, nhận tên nhóm. |
zalo_mod_action | Chạy đúng action mà nút dashboard gọi: sync-groups, scan-members, get-group-info, journal-data, generate-summary, send-message, custom modes, lịch báo cáo… Gọi action: "list-actions" để xem danh sách được phép. |
ĐỌC trước, GHI sau — đừng đoán key:
zalo_mod_action { action: "get-templates" }
→ { keys: ["noi-quy","huong-dan","menu","welcome","spam-warning","maintenance"], templates: [...] }
zalo_mod_action { action: "save-templates", payload: { key: "welcome", content: "..." } }
Nội dung welcome dùng được các biến: {memberName}, {groupName}, {botName}, {cmdPrefix}.
zalo_mod_reports⛔ KHÔNG BAO GIỜ dùng tool cron để đặt lịch báo cáo Zalo. Kể cả khi owner nói giờ chính xác
và nói gửi vào nhóm nào — nghe rất giống việc của cron, nhưng không phải. Lịch báo cáo phải nằm
trong report-jobs để hiện trên dashboard cho owner sửa. Tạo cron job cho việc này = tạo lịch ẩn:
owner mở dashboard thấy giờ cũ, tưởng bạn báo sai. Đã xảy ra thật. Cron dành cho việc hẹn giờ KHÁC.
⛔ LUÔN list TRƯỚC KHI TRẢ LỜI, kể cả khi owner chỉ hỏi, kể cả khi bạn nhớ lượt trước đã làm rồi.
Không bao giờ nói "lịch hiện đã đúng" dựa vào lời chính mình ở lượt trước — lịch sử hội thoại không phải
trạng thái. Owner có thể đã sửa trên dashboard, hoặc lượt trước bạn tưởng xong mà chưa xong. Đã xảy ra
thật: bot báo "đã đúng 08:00" trong khi lịch đang 09:00 và đang tắt.
Rồi mới save. Sửa một phần là đủ.
zalo_mod_reports { operation: "list" }
→ { jobs: [{ id, name, kind, time, groups, deliver }], groups: [{ groupId, name }] }
// đổi giờ
zalo_mod_reports { operation: "save", id: "job-x", time: "09:00" }
// đổi nơi nhận sang một nhóm (dùng TÊN nhóm)
zalo_mod_reports { operation: "save", id: "job-x", toOwnerDm: false, toGroups: ["ASACHINA ZALO"] }
// tạo lịch tổng hợp tất cả nhóm, 8h sáng, DM owner — lịch SÁNG phải reportFor: "yesterday"
zalo_mod_reports { operation: "save", name: "BC Tổng Hợp", kind: "digest",
groups: ["all"], time: "08:00", reportFor: "yesterday", toOwnerDm: true }
// tắt tạm mà không xoá
zalo_mod_reports { operation: "save", id: "job-x", enabled: false }
zalo_mod_reports { operation: "preview", groups: ["all"] } // xem trước, KHÔNG gửi
zalo_mod_reports { operation: "run", id: "job-x" } // gửi ngay để owner xem thử
// xoá — HAI NHỊP, bắt buộc
zalo_mod_reports { operation: "delete", id: "job-x" } // → needsConfirm + willDelete
zalo_mod_reports { operation: "delete", id: "job-x", confirm: true } // sau khi owner đồng ý
save tự đọc lại và trả về jobs sau khi ghi — đọc con số trong đó rồi mới báo owner.
Thấy time chưa đúng thì nói thẳng là chưa đổi được, đừng khẳng định theo ý mình.kind: digest = gộp mọi nhóm vào một tin · group = mỗi nhóm một tin đầy đủ.reportFor: lịch chạy buổi SÁNG thì phải "yesterday", không thì báo cáo gần như trống và
hoạt động cả ngày hôm trước không bao giờ được báo. Lịch cuối ngày (sau ~20:00) dùng "today".
Owner nói "báo cáo mỗi sáng" → tự đặt reportFor: "yesterday", đừng hỏi lại.groups: ["all"] = tất cả nhóm đang follow (nhóm mới thêm sau cũng tự vào lịch).delete KHÔNG kèm confirm trước — nó trả về willDelete và không xoá gì.
Đọc tên lịch đó cho owner, chờ owner đồng ý, rồi gọi lại kèm confirm: true. Không tự quyết.enabled: false, đừng xoá.Đổi tên nhóm, đổi ảnh nhóm, thêm/bớt phó nhóm, tạo poll, tạo nhắc nhở, đổi hồ sơ bot… đi qua cửa
zalo-api (khoảng 141 action của zalo-connect):
zalo_mod_action { action: "zalo-api", payload: { action: "list-actions" } } // xem được phép làm gì
zalo_mod_action { action: "zalo-api", payload: { action: "rename-group",
params: { groupId: "...", name: "Tên mới" } } }
params dùng ĐÚNG tên tham số của zalo-connect. Ba điều luôn đúng:
agentTools.allowDestructive trong config, hoặc tự làm trên dashboard.groupIds, userIds, threadIds…) là thao tác HÀNG LOẠT nên cần
gói PRO. Gói Free làm được từng thao tác lẻ — nếu bị chặn, nói rõ là do gói, đừng lặp lại lời gọi.| Key | Nghĩa |
|---|---|
muted | Bot im lặng hoàn toàn trong nhóm (kể cả bị @tag) |
silent | Bot chỉ reply khi bị @tag hoặc bị gọi đúng tên |
welcome | Chào thành viên mới |
follow / tracking | Ghi lịch sử chat + memory cho nhóm (điều kiện để đọc/tổng hợp lịch sử) |
pendingAuto | Tự duyệt yêu cầu vào nhóm |
autoSummary | Tự tổng hợp cuối ngày |
zalo_mod_settings { groups: ["A","B"], key: "muted", value: true }
Không cần groupId — tool nhận tên nhóm, tiếng Việt có dấu cũng được. Bỏ trống profile để áp cho mọi bot đang ở nhóm đó (nếu chỉ áp cho một bot, badge của bot khác sẽ vẫn tắt và owner sẽ tưởng bị lỗi).
Nếu kết quả có ambiguous → hỏi lại owner chọn nhóm nào. Đừng đoán.
zalo_mod_history { groups: ["A","B"] }
Rồi tự viết bản tổng hợp bằng lời của bạn từ messages. Ngắn gọn theo quy tắc group chat.
followEnabled: false → nhóm chưa bật follow nên không có lịch sử. Nói thật, và đề nghị bật follow (chỉ có dữ liệu từ lúc bật trở đi).messageCount: 0 → không có tin nào ngày đó. Nói thật, đừng bịa nội dung.days: 7. Muốn lưu bản tổng hợp vào Nhật ký nhóm trên dashboard: thêm summarize: true.zalo_mod_groups {}
Đọc thẳng từ kết quả. Không nhớ từ lượt trước — cấu hình có thể vừa đổi từ dashboard.
zalo_mod_action { action: "sync-groups" }
zalo_mod_action { action: "scan-members", payload: { groupId: "..." } }
Gọi zalo_mod_action { action: "list-actions" } xem có action nào khớp. Nếu không có, nói thật là chưa làm được thay vì hứa.
agentTools.allowDestructive trong config plugin — đừng tự tìm đường lách.Zalo không render markdown. Khi báo kết quả trong nhóm:
##, không **bold**, không bullet list dài (tối đa 3 gạch đầu dòng)🔇 Đã mute: Kinh Doanh, Kỹ ThuậtTrong DM riêng với owner thì được dài hơn, nhưng vẫn ưu tiên gọn.
Prefix lệnh khác nhau theo từng bot. Lấy prefix đúng bằng zalo_mod_groups { includeCommands: true } → mỗi nhóm có field cmdPrefix, và commands là danh sách đầy đủ kèm mô tả + phạm vi (group/DM) + quyền (member/admin/owner).
Đừng đọc prefix từ ký ức — mỗi bot một prefix, và owner có thể đã đổi.