公开记录良好
软件健康报告模式 0.31.0 · 指标 2.5.0 · 2026-08-05 09:24 UTC
monas-team / zaloclaw
Plugin kênh Zalo OpenClaw đầy đủ tính năng, xây dựng trên zca-js, hỗ trợ nhắn tin, quản lý nhóm, phân quyền truy cập và tích hợp công cụ cho agent.
monas-team/zaloclaw 的健康指数为 100 分中的 69 分，处于「良好」区间。 其得分最高的类别是Engineering Quality（81/100），最低的是Security（47/100）。 最近一次更新在 11 天前。 近期的大部分工作由 1 位贡献者完成。
69
总分 / 100软件健康指数
指标归入加权类别，统一采用 1–100 量表。总体分先取类别加权平均，再依据公开记录的分布进行校准，使各等级具有百分位含义；当公开证据触发高风险司法辖区政策时，评级会按政策调整，并设置 34（存在风险）的上限。
69
卓越93-100公开记录中的最高层级（约前 5%）；基本满足所有检验标准
优秀80-92各方面均表现强劲；仅有少量不足
良好65-79健康；不足之处有限且可控
中等50-64可接受，但存在明显不足；建议进行审查
薄弱35-49多个领域存在实质性薄弱环节
存在风险20-34存在重大薄弱环节；采用时应保持审慎
危急1-19问题严重（项目被弃置、仅有单一维护者、缺乏基本工程规范）
评分画像
每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形，而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。
加权总体分 62 经校准后在公布的指数量表上为 69（记录校准 2026-08-02）。
所有权
软件包生态系统
| 注册表 | 软件包 | 版本 | 月下载量 | 版本数 | 最近发布 | 标签 |
|---|---|---|---|---|---|---|
| npm | zaloclaw | 2.5.11 | 2,241 | 15 | 11 天前 | openclaw-channelopenclaw-pluginopenclawzalochatbotchannel-pluginzca-jsmessaging |
按类别列示的指标
活力
项目是否仍有生命——是否仍在编写代码，是否仍在发布版本？
77
开发活跃度
62中等
评分方式
| 28.8/36 | 推送新近度 — 最近一次推送于 11 天前 |
| 5.5/36 | 提交节奏 — 52 周中有 8 周有提交 |
| 18/18 | 提交量 — 最近一年 130 次提交 |
| 10/10 | OpenSSF Scorecard：Maintained — 30 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10 |
所用输入
| commits_last_year | 130 |
| human_commit_share | 0.85 |
| days_since_last_push | 11 |
| active_weeks_last_year | 8 |
发布纪律
100卓越
评分方式
| 27/27 | 有发布版本 — 已发布 11 个发布版本 |
| 36/36 | 发布时效 — 最近一次发布版本于 18 天前 |
| 27/27 | 发布节奏 — 约每 1 天发布一次 |
| 0/10 | OpenSSF Scorecard：Signed-Releases — 无数据 |
所用输入
| releases_count | 11 |
| latest_release_tag | v2.5.7 |
| releases_from_tags | 否 |
| days_since_latest_release | 18 |
| mean_days_between_releases | 1 |
已排除计分（无数据或不适用）：OpenSSF Scorecard：Signed-Releases。 其余权重已重新归一化。
社区与采用
项目是否拥有用户、下载量与关注度，并具备欢迎贡献者参与的配置？
55
流行度与采用
29存在风险
评分方式
| 21.8/60 | 星标 — 23 个星标 |
| 7.5/25 | 复刻 — 9 个复刻 |
| 0/15 | 关注者 — 1 位关注者 |
所用输入
| forks | 9 |
| stars | 23 |
| watchers | 1 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
社区健康
85优秀
评分方式
| 22.5/22.5 | README |
| 22.5/22.5 | 许可证 — 可识别的许可证（MIT） |
| 18/18 | CONTRIBUTING 指南 |
| 13.5/13.5 | 行为准则 |
| 0/7.2 | 议题模板 |
| 0/6.3 | PR 模板 |
所用输入
| has_readme | 是 |
| has_license | 是 |
| readme_badges | 4 |
| has_contributing | 是 |
| has_issue_template | 否 |
| has_code_of_conduct | 是 |
| readme_badge_services | shields.io |
| has_pull_request_template | 否 |
生态采用（下载量）
56中等
评分方式
| 44.7/80 | 月度下载量 — npm 合计每月 2,241 次下载 |
| 0/20 | 注册表被依赖数 — 该生态系统不报告此项 |
所用输入
| packages | zaloclaw |
| dependents | — |
| ecosystems | npm |
| total_downloads | — |
| monthly_downloads | 2,241 |
已排除计分（无数据或不适用）：注册表被依赖数。 其余权重已重新归一化。
可持续性与治理
项目能否在其成员之外延续——巴士系数、响应能力、由谁支持，以及软件包的维护状况？
51
维护者韧性（巴士系数）
13危急
评分方式
| 9/54 | 巴士系数 — 1 位贡献者贡献了半数提交 |
| 0/22.5 | 提交分布 — 头号贡献者编写了 100% 的提交 |
| 1.4/13.5 | 贡献者广度 — 1 位贡献者 |
| 3/10 | OpenSSF Scorecard：Contributors — project has 1 contributing companies or organizations -- score normalized to 3 |
所用输入
| bus_factor | 1 |
| contributors_sampled | 1 |
| top_contributor_share | 1 |
议题与 PR 响应能力
69良好
评分方式
| 42/42 | 议题解决 — 100% 的议题已关闭 |
| 26.7/30 | PR 接受 — 已裁定的 PR 中 16/18 已合并 |
| 0/13 | Newcomer PR acceptance — 30 天内首次贡献者的 PR 已合并 0/2 |
| 0/15 | OpenSSF Scorecard：Code-Review — Found 0/30 approved changesets -- score normalized to 0 |
所用输入
| merged_prs | 16 |
| open_issues | 0 |
| closed_issues | 5 |
| prs_merged_7d | 0 |
| prs_decided_7d | 0 |
| prs_merged_30d | 0 |
| prs_decided_30d | 2 |
| issue_closed_ratio | 1 |
| closed_unmerged_prs | 2 |
| first_time_authors_30d | 2 |
| first_time_prs_merged_30d | 0 |
| first_time_prs_decided_30d | 2 |
所有权与托管责任
38薄弱
评分方式
| 30/30 | 所有权背书 — 组织持有 |
| 0/20 | 已验证域名 |
| 5/25 | 所有者影响力 — monas-team 有 4 位关注者 |
| 2.5/25 | 既往记录 — 1 个公开仓库，账户约 0 年 |
所用输入
| followers | 4 |
| owner_type | Organization |
| is_verified | — |
| owner_login | monas-team |
| public_repos | 1 |
| account_age_days | 65 |
软件包维护
100卓越
评分方式
| 25/25 | 已发布且可解析 — npm 上有 1 个软件包 |
| 35/35 | 发布时效 — 最近一次发布于 11 天前 |
| 20/20 | 版本历史 — 15 个已发布版本 |
| 20/20 | 未被弃用 — 活跃，未被弃用或撤回 |
所用输入
| packages | zaloclaw |
| ecosystems | npm |
| any_deprecated | 否 |
| min_days_since_publish | 11 |
工程质量
基础的工程与文档实践是否到位？
81
工程实践
68良好
评分方式
| 24/24 | CI 工作流 — 1 个工作流 |
| 24/24 | 存在测试 |
| 0/16 | Linter 配置 |
| 0/9.6 | Pre-commit 钩子 |
| 6.4/6.4 | .editorconfig |
| 0/20 | OpenSSF Scorecard：CI-Tests — 无数据 |
所用输入
| has_ci | 是 |
| has_tests | 是 |
| has_editorconfig | 是 |
| has_linter_config | 否 |
| has_precommit_config | 否 |
已排除计分（无数据或不适用）：OpenSSF Scorecard：CI-Tests。 其余权重已重新归一化。
文档
100卓越
评分方式
| 30/30 | README |
| 25/25 | 文档目录 |
| 15/15 | 文档 / 主页站点 — https://openclaw.monas.us/zalo |
| 10/10 | 仓库描述 |
| 10/10 | 主题标签 — 9 个主题标签 |
| 10/10 | Wiki |
所用输入
| topics | ai-agent, chat-automation, messaging, openclaw, typescript, workflow-automation, zalo, zalo-bot, zca-js |
| has_wiki | 是 |
| homepage | https://openclaw.monas.us/zalo |
| has_readme | 是 |
| has_docs_dir | 是 |
| has_description | 是 |
安全
可见的安全与供应链实践是否稳固，且不存在未解决的高风险司法辖区暴露？
47
安全态势
39薄弱
评分方式
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 0/7.5 | Branch-Protection — branch protection not enabled on development/release branches |
| 0/2.5 | CI-Tests — 无数据 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 0/30 approved changesets -- score normalized to 0 |
| 0.8/2.5 | Contributors — project has 1 contributing companies or organizations -- score normalized to 3 |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 0/7.5 | Dependency-Update-Tool — no update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | 许可证 — license file detected |
| 7.5/7.5 | Maintained — 30 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10 |
| 0/5 | Packaging — 无数据 |
| 1.5/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 3 |
| 0/5 | SAST — no SAST tool detected |
| 5/5 | Security-Policy — security policy file detected |
| 0/7.5 | Signed-Releases — 无数据 |
| 0/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 0/7.5 | Vulnerabilities — 52 existing vulnerabilities detected |
所用输入
| source | openssf_scorecard |
| checks_evaluated | 15 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 3 |
| scorecard_aggregate | 3.9 |
已排除计分（无数据或不适用）：ci_tests, packaging, signed_releases。 其余权重已重新归一化。
依赖安全公告
80优秀
评分方式
| 14.6/35 | 直接依赖不含已知公告 — 1 个受影响：sharp 0.33.5 (high 7.3) |
| 25/25 | 间接依赖不含已知公告 — 没有间接依赖携带已知公告 |
| 40/40 | 没有长期未处理的公告 — 没有公告公开超过 90 天 |
所用输入
| source | osv |
| advisories | 1 |
| affected_packages | 1 |
| assessed_packages | 68 |
| unassessed_packages | 0 |
| affected_by_severity | high 1 |
| direct_affected_packages | 1 |
比对的是 npm:zaloclaw@2.5.11 的运行时依赖闭包——安装已发布的软件包时真正被拉取进来的内容——共 68 个软件包。 未对可达性进行分析。
AI 就绪度
该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件？权重刻意设小（4%）：代理工具链是一项真实的维护信号，但完全不具备的仓库仍可达到 100/100。
53
AI 代理上下文与指引
40薄弱
评分方式
| 0/45 | 代理指令 — 没有 CLAUDE.md / AGENTS.md / 编辑器规则 |
| 0/15 | 机器可读文档（llms.txt） |
| 40/40 | 可读的提交历史 — 85 次人类提交中有 78 次说明了意图（结构化标题或解释性正文） |
所用输入
| has_llms_txt | 否 |
| legible_history_share | 0.918 |
| agent_instruction_files | — |
| agent_instruction_max_bytes | — |
评分方式
| 0/18 | 一条命令的引导启动 |
| 22/22 | 自动化测试 |
| 0/11 | Lint / 格式化配置 |
| 11/11 | 静态类型检查 — tsconfig.json |
| 10/10 | 可复现环境 — lockfile |
| 0/10 | 已体现的代理实践 — 最近 100 次提交中没有代理编写的提交 |
| 0/8 | 自动化维护 — 未观察到自动依赖更新 |
| 3/10 | OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 3 |
所用输入
| has_nix | 否 |
| has_tests | 是 |
| lockfiles | package-lock.json |
| has_dockerfile | 否 |
| typed_language | 是 |
| bootstrap_files | — |
| has_devcontainer | 否 |
| has_linter_config | 否 |
| typecheck_configs | tsconfig.json |
| agent_commit_share | 0 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
面向模型的代码可读性
98卓越
评分方式
| 45/45 | 可类型检查的代码 — TypeScript（静态类型） |
| 52.6/55 | 可控的文件大小 — 采样的 46 个源文件中有 2 个超过 60KB |
所用输入
| primary_language | TypeScript |
| largest_source_bytes | 80,724 |
| source_files_sampled | 46 |
| oversized_source_files | 2 |
关键数据
23GitHub 星标
1贡献者
130最近 12 个月提交数
11距最近推送天数
11发布版本数
1巴士系数（bus factor）
0开放议题
npm软件包生态系统数
数据采集警告
- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
更多细节
Star 与 Fork 历史 0 ★ / 9 ⇿
0Star
9Fork
11发布
每颗 star 和每个 fork 的添加时间，来自 GitHub 并按天汇总。累计增长位于其构成来源——每日新增——的正上方，二者可相互对照：稳定的自然增长与短暂的突增形态截然不同。当这一差别可被衡量时，它会作为增长真实性予以报告。
主版本 0次版本 4修订 7
OpenSSF Scorecard 3.9 / 10
3.9综合
来自开源项目 OpenSSF Scorecard 的独立、工具无关的安全评估。每项检查奖励的是安全实践本身，而非特定供应商的工具。Scorecard 无法判定的检查项标记为 不适用，并从安全评分中剔除（绝不按零分计）。
| 10 | Binary-Artifacts | no binaries found in the repo |
| 0 | Branch-Protection | branch protection not enabled on development/release branches |
| 不适用 | CI-Tests | no pull request found |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 0/30 approved changesets -- score normalized to 0 |
| 3 | Contributors | project has 1 contributing companies or organizations -- score normalized to 3 |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 0 | Dependency-Update-Tool | no update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 10 | Maintained | 30 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10 |
| 不适用 | Packaging | packaging workflow not detected |
| 3 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 3 |
| 0 | SAST | no SAST tool detected |
| 10 | Security-Policy | security policy file detected |
| 不适用 | Signed-Releases | no releases found |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 0 | Vulnerabilities | 52 existing vulnerabilities detected |
直接依赖 7
| 注册表 | 软件包 | 版本约束 | 清单文件 |
|---|---|---|---|
| npm | @sinclair/typebox | ^0.34.0 | package.json |
| npm | jsqr | ^1.4.0 | package.json |
| npm | pngjs | ^7.0.0 | package.json |
| npm | qrcode-terminal | ^0.12.0 | package.json |
| npm | sharp | ^0.33.0 | package.json |
| npm | zca-js | ^2.1.2 | package.json |
| npm | zod | ^4.3.6 | package.json |
全部依赖 未采集
本报告未能采集到解析后的依赖集合：GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
依赖安全公告 1
安装 npm:zaloclaw@2.5.11 会引入 68 个包（直接与传递）：其中 1 个存在已知公告，1 个为直接依赖。
| 软件包 | 版本 | 关系 | 严重程度 | 公告数 | 修复版本 |
|---|---|---|---|---|---|
| sharp | 0.33.5 | 直接 | 高 | 1 | 0.35.0 |
公告表示依赖图中记录的版本落入某条公告的受影响范围。可达性未经分析，且依赖图包含开发与测试的版本固定——某项发现可能只涉及工具链而非交付的软件。
原始 JSON 报告 机器可读
{
"data": {
"icon": {
"bytes": 50038,
"width": 256,
"height": 256,
"rejected": [],
"collected": true,
"media_type": "image/png",
"source_url": "https://avatars.githubusercontent.com/u/289379150?v=4&s=256",
"source_type": "avatar",
"content_hash": "d4650f718d434377fe322e0639ed9f117eddfaddda1a1f392ac12e59d6c2871c",
"candidates_considered": 1
},
"repo": {
"topics": [
"ai-agent",
"chat-automation",
"messaging",
"openclaw",
"typescript",
"workflow-automation",
"zalo",
"zalo-bot",
"zca-js"
],
"is_fork": false,
"size_kb": 576,
"has_wiki": true,
"homepage": "https://openclaw.monas.us/zalo",
"languages": {
"TypeScript": 342069
},
"pushed_at": "2026-07-25T06:18:49Z",
"created_at": "2026-04-12T15:54:40Z",
"owner_type": "Organization",
"updated_at": "2026-07-27T08:28:11Z",
"description": "Plugin kênh Zalo OpenClaw đầy đủ tính năng, xây dựng trên zca-js, hỗ trợ nhắn tin, quản lý nhóm, phân quyền truy cập và tích hợp công cụ cho agent.",
"is_archived": false,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "main",
"license_spdx_raw": "MIT",
"primary_language": "TypeScript",
"significant_languages": [
"TypeScript"
]
},
"owner": {
"blog": "https://monas.us",
"name": "Monas Team",
"type": "Organization",
"login": "monas-team",
"company": null,
"location": "Vietnam",
"followers": 4,
"avatar_url": "https://avatars.githubusercontent.com/u/289379150?v=4",
"created_at": "2026-05-31T09:49:47Z",
"is_verified": null,
"public_repos": 1,
"account_age_days": 65
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v2.5.7",
"kind": "patch",
"published_at": "2026-07-18T07:34:50Z"
},
{
"tag": "v2.5.4",
"kind": "patch",
"published_at": "2026-07-17T11:13:22Z"
},
{
"tag": "v2.5.3",
"kind": "patch",
"published_at": "2026-07-17T10:52:33Z"
},
{
"tag": "v2.5.2",
"kind": "patch",
"published_at": "2026-07-17T10:32:19Z"
},
{
"tag": "v2.5.1",
"kind": "patch",
"published_at": "2026-07-17T10:30:11Z"
},
{
"tag": "v2.5.0",
"kind": "minor",
"published_at": "2026-07-17T10:30:04Z"
},
{
"tag": "v2.4.2",
"kind": "patch",
"published_at": "2026-07-09T07:14:22Z"
},
{
"tag": "v2.4.1",
"kind": "patch",
"published_at": "2026-07-09T07:08:51Z"
},
{
"tag": "v2.4.0",
"kind": "minor",
"published_at": "2026-07-09T07:03:55Z"
},
{
"tag": "v2.3.0",
"kind": "minor",
"published_at": "2026-07-09T06:58:17Z"
},
{
"tag": "v2.1.0",
"kind": "minor",
"published_at": "2026-06-11T03:59:25Z"
}
],
"recent_commits": [
{
"oid": "4807a687ebb63fcf7e9b0540ea9eab7e50f7f652",
"body": "…le download in replies (v2.5.11)",
"is_bot": false,
"headline": "fix: detect Zalo quote.attach file format (params+title) — enables fi…",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-25T06:18:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "db5c0311991118e3d663f77fb9b0b7fc52c1bc77",
"body": "…a fields (v2.5.10)",
"is_bot": false,
"headline": "fix: quoted file note false positive — only show when attach has medi…",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-25T06:01:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "687a5704f9911fc9df14d9a2e7c089ec310f8d97",
"body": "….5.9)",
"is_bot": false,
"headline": "fix: file-downloader Zalo CDN auth + quoted file unavailable note (v2…",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-25T05:56:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "58042fa14d3a1e3048ce9d4c11e67a3f02986d8b",
"body": null,
"is_bot": false,
"headline": "chore: bump 2.5.8 — update Zalo support group link",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-18T07:37:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b0db0ccf0f5bba26535b5be23cc603b3b120d4f6",
"body": null,
"is_bot": false,
"headline": "Update README.md",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-07-18T07:36:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "03ed473d96f2c8ad947fba8ec4a88f9ae9a9dac0",
"body": "- actions.md: rewrite toàn bộ từ codebase thực tế (153 actions, verified)\n - Mark 3 deprecated Zalo endpoints (get-online-friends, get-close-friends, get-group-chat-history)\n - Mark group-mention as config action (not send action)\n - Add session cache limitation notes (add-reaction, undo-message)\n[…]\nnt tier limitation\n - Note get-biz-account business account only\n - Add Giới hạn đã biết summary table\n- README.md: expand Hạn chế section with full limitation table + solutions\n- bump 2.5.6 → 2.5.7",
"is_bot": false,
"headline": "docs: rewrite actions.md + update README limitations (v2.5.7)",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-18T07:06:05Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "db6b287390ee5d917cbbab5f25d6b05bddaae1bc",
"body": "…essage, group-mention clearer error, docs/actions.md corrections\n\n- get-related-friend-groups: fallback to getCurrentUid() when userId not provided\n- forward-message: explicit validation requiring message param (cannot auto-lookup content by msgId)\n- group-mention: improved error message clarifying\n[…]\n not stickerCateId), forward-message note about message required,\n get-related-friend-groups userId optional, mark deprecated Zalo APIs (get-online-friends, get-close-friends, get-group-chat-history)",
"is_bot": false,
"headline": "fix: get-related-friend-groups auto-userId, forward-message require m…",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-18T07:00:46Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "66048d0b6b700c4eb29c712c5a7351507cd4bb6a",
"body": "CHANGELOG:\n- Add [2.5.6] — quoted image fix + build regression fix\n- Add [2.5.5] — fileUrl extraction for share.file (Issue #22)\n- Add [2.5.4] — quote media content parsing fix\n\nREADME:\n- Update badges and feature table (file attachments, quoted media)\n- Add 'Xử lý Media' section: file attachment fl\n[…]\nfile-downloader.ts to architecture diagram\n\ndocs/guide.md:\n- Add 'File Attachments' section with full flow and caveats\n- Add 'Ảnh & Quoted Media' section explaining both direct + quoted image handling",
"is_bot": false,
"headline": "docs: update README, CHANGELOG, guide for v2.5.4–2.5.6",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-18T06:46:36Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "320aebe134e3335cea6c3a9b1e2e2388fd763e53",
"body": "…followup)\n\nTwo bugs fixed:\n\n1. Build regression: previous fix (fileUrl, v2.5.5) was only typechecked\n (tsc --noEmit) — dist/index.js was never rebuilt so fix had no effect\n at runtime. Now always run 'npm run build' after source changes.\n\n2. Quoted image/file not forwarded to agent:\n - ZaloCl\n[…]\nacefully\n\nCombined effect: when user quotes a photo in Zalo DM and asks bot a question,\nthe bot now receives both the text question AND the quoted image as a downloaded\nlocal file, and can analyze it.",
"is_bot": false,
"headline": "fix(monitor): extract quoted message images + always build dist (#22 …",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-18T06:36:50Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "5b7a9af80aed1d9bda13f9cff4252f52a36e7e81",
"body": "- extractMediaFromObject: add fileUrl as first URL candidate (before href/url)\n fixing binary file attachments (PPTX, PDF, DOCX, CSV, etc.) being silently dropped\n- mediaMimeFromObject: detect Zalo share.file objects via fileUrl/extention fields\n so numeric type codes (e.g. 2) are still recognised\n[…]\n into bodyWithSender context\n so agent knows where to find the local file and can use read/pdf/exec tools\n- Rename shouldProcessImages -> shouldProcessMedia (accuracy, no behavior change)\n\nCloses #22",
"is_bot": false,
"headline": "fix(monitor): extract fileUrl from Zalo share.file events (#22)",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-18T06:27:31Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "31dbb8df99858bb27b52223acd3a9df3d5db5314",
"body": null,
"is_bot": false,
"headline": "fix: parse media content to object for correct image quote (v2.5.4)",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-17T11:12:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "73ba959d82082edd1bd5a8329019ddff39cc87e7",
"body": "…v2.5.3)",
"is_bot": false,
"headline": "fix: quote msgType string, content passthrough, image debug logging (…",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-17T10:51:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "15d8084ddee7a95c8e5667119946498f2a7973d7",
"body": "…nnel control docs",
"is_bot": false,
"headline": "release: v2.5.2 — docs update, action count 153, bridge service & cha…",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-17T10:31:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0a03cf693ac38ec1d548e50335e0ee8ae182918e",
"body": "…ontrol docs (v2.5.1)",
"is_bot": false,
"headline": "docs: update README, action count 151→153, bridge service & channel c…",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-17T10:31:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "18abb5adbd5278dd50ac3c6e9ec49ad6a16ed05a",
"body": null,
"is_bot": false,
"headline": "feat: add channel control + self-update actions (v2.5.1)",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-17T10:23:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d242f1970f3432044c72ad91573467ef36273d1b",
"body": "…vice v1",
"is_bot": false,
"headline": "release: v2.5.0 — fix quote-reply, fix image CDN auth, add bridge ser…",
"author_name": "MONAS 0xCLAW",
"author_login": null,
"committed_at": "2026-07-17T10:10:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7232fda2ae4dbc5148ca02146d5fc826a08f7057",
"body": null,
"is_bot": false,
"headline": "Update README with group link and title change",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-07-14T05:08:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "afd2306deaff50c955952f71581691cf516dce4e",
"body": "All files now fully consistent:\n- version: 2.4.6\n- compat.pluginApi: >=2026.5.7\n- minGatewayVersion: 2026.5.7\n- CHANGELOG: complete from v2.4.0 to v2.4.6",
"is_bot": false,
"headline": "chore: add [2.4.5] CHANGELOG entry + bump to 2.4.6",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-09T07:59:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "13c55675b6e85cd27ed1f28003b36bcc728c3d01",
"body": "- Add missing entries: v2.4.1 (manifest), v2.4.2 (docs restructure),\n v2.4.3 (guide.md), v2.4.4 (minGatewayVersion fix)\n- Credit bé Mi (Ươm Mầm) for catching the version mismatch in v2.4.4",
"is_bot": false,
"headline": "docs: backfill CHANGELOG for v2.4.1–v2.4.4 (v2.4.5)",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-09T07:44:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "52baccda6f59b663175af7cd67ba5e8c7e13cae8",
"body": "README/guide said >=2026.5.7 but package.json + openclaw.plugin.json\nstill had >=2026.2.0. Aligning to 2026.5.7 (contracts.tools requirement).\nCaught by bé Mi (Ươm Mầm) during doc review — good catch!",
"is_bot": false,
"headline": "fix: sync minGatewayVersion to >=2026.5.7 across all files",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-09T07:41:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "be8a9ea548b3a6a0410ddc7651f96390e02cd064",
"body": "Full guide from zero to working Zalo AI bot:\n- Prerequisites & OpenClaw setup\n- 3 install methods (ClawHub/npm/clone)\n- QR login steps with phone instructions\n- Basic & full config examples with comments\n- Advanced: passive collector, group events, injection guard, auto-reply\n- Troubleshooting: session expired, requireMention, plugin not found",
"is_bot": false,
"headline": "docs: add docs/guide.md — step-by-step install & config guide (v2.4.3)",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-09T07:33:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "68a22ca2609b3645143198f85d270452eba9dcdc",
"body": "- Remove stale files: TOOLS.md, docs/FEATURES.md, docs/agent-help.md, docs/agent-install.md\n- Rewrite README.md — lean ~180 lines, accurate for v2.4.x\n - Fix action count: 147 → 151 (added recall-group-history, list-passive-groups + others)\n - Document passive collector JSONL storage\n - Remove ou\n[…]\nons (donation, verbose 147 action tables)\n- Add docs/actions.md — complete 151-action reference, grouped, with params\n- Rewrite CONTRIBUTING.md — fix URL (monasprox → monas-team), simplify to 30 lines",
"is_bot": false,
"headline": "docs: restructure & rewrite all documentation (v2.4.2)",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-09T07:14:20Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "d1efda961d2ab325e3c106c35670fb198c7c5f05",
"body": "- Remove esUrl from passiveCollector configSchema (ES no longer used in v2.4)\n- Update passiveCollector description to reflect JSONL file storage\n- Add activation.onStartup: true (required by OpenClaw plugin docs)\n- Add compat field to openclaw.plugin.json\n- Fix install ledger version 2.1.2 → 2.4.0",
"is_bot": false,
"headline": "fix: manifest cleanup for OpenClaw standards compliance (v2.4.1)",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-09T07:08:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "58fde0eee7c1eebf4afa62aa53614201ae8f8e1b",
"body": "…S dependency\n\n- Remove Elasticsearch dependency from passive-collector entirely\n- Store group messages to ~/.openclaw/workspace/zaloclaw/passive/{groupId}.jsonl\n- Text-visible format: one JSON record per line, readable with any tool\n- Portable: works on any OpenClaw install without extra setup or e\n[…]\ndd zaloclaw tool actions: recall-group-history, list-passive-groups\n- collectGroupMessage() is now synchronous file append (no await needed)\n- Drop OPENCLAW_ES_URL / ES_URL env vars (no longer needed)",
"is_bot": false,
"headline": "release: v2.4.0 — passive-collector rewrite: JSONL file storage, no E…",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-09T07:03:42Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "12102c305b48c5b5ee91c2ea8e3a1ee58baefeff",
"body": "…RL, docs cleanup",
"is_bot": false,
"headline": "release: v2.3.0 — security fixes, passive-collector configurable ES_U…",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-09T06:57:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "77b20d4675dac537fecdd47f75497d9b239f1f2f",
"body": "- fix import paths: zalouser → config-runtime/runtime\n- add contracts.tools to openclaw.plugin.json\n- fix group message detection (outbound.sendText isGroup)\n- add group-id-cache.ts\n- fix typing keepalive gap\n- fix reaction cliMsgId fallback\n- 104 tests passing, typecheck clean",
"is_bot": false,
"headline": "release: v2.2.0 — OpenClaw 2026.5.7 compatibility + bug fixes",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-08T13:10:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5af698a76f3ce1961fcdf7aa5220baa5825e4baf",
"body": "openclaw/plugin-sdk/zalouser no longer exports OpenClawConfig,\nMarkdownTableMode, RuntimeEnv in OpenClaw 2026.5.7.\n\nCorrect paths:\n- OpenClawConfig, MarkdownTableMode → plugin-sdk/config-runtime\n- RuntimeEnv → plugin-sdk/runtime\n\nFixes typecheck failure on current OpenClaw version.",
"is_bot": false,
"headline": "fix: update import paths for OpenClaw 2026.5.7 compatibility",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-08T13:00:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b26151e62428353d8f2bdc9f13c659bea772a7fc",
"body": "- Add group-id-cache.ts: in-memory Set of known group IDs\n- monitor.ts: recordGroupId(chatId) when isGroup=true on inbound\n- channel.ts: outbound.sendText/sendMedia auto-detect isGroup via cache\n so explicit message tool calls to group IDs work correctly\n\nPreviously outbound.sendText always sent ThreadType.User, causing\nmessages to be delivered as DMs instead of group messages.",
"is_bot": false,
"headline": "fix: group message detection for outbound.sendText/sendMedia",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-08T12:47:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c2065c42eada1c876428de1cac7532d2d94049dd",
"body": "- add contracts.tools=[\"zaloclaw\"] to openclaw.plugin.json\n- pre-reply typing keepalive setInterval 3s to cover model setup gap\n- fallback to lookupCliMsgId() when message.cliMsgId absent",
"is_bot": false,
"headline": "fix: contracts.tools, typing keepalive, cliMsgId fallback for reaction",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-07-08T12:28:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e79ed92c8fe80b27ce55c772e530f2a84006b791",
"body": null,
"is_bot": false,
"headline": "Update README.md",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-06-11T06:12:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4504e9dec2815e38112d81af3995a0f1d410abf1",
"body": "Root cause: package.json missing the `openclaw.channel` field.\nOpenClaw's catalog scanner does:\n const channel = candidate.packageManifest?.channel;\n if (!channel?.id) return []; // skips plugin entirely\n\nWithout this field, zaloclaw was never added to the channel catalog,\ncausing `channels login\n[…]\nregardless of how it was installed.\n\nFix: add openclaw.channel with id/label/blurb/aliases/order.\nAfter this fix, zaloclaw correctly appears in the catalog and\n`channels login` works on first install.",
"is_bot": false,
"headline": "fix(critical): add openclaw.channel to package.json — fix channels login",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-06-11T05:26:20Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "7120b7153ed95b5d4912737d03f6d4df627e8402",
"body": "- README: 3 install methods EN (A/B/C) + VI (Cách 1/2/3)\n- README: QR scan instructions + verify step after login\n- README: session expiry note + channels login troubleshooting",
"is_bot": false,
"headline": "release: v2.1.1 — docs: complete install guide rewrite",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-06-11T04:32:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c49b0b63dd7cc6c0350e4f90283054e9d7a94a85",
"body": "…, verified flow\n\n- EN: restructured into Option A (ClawHub) / B (npm) / C (manual clone)\n- VI: added missing Cách 2 (npm), added Cách 3 (clone) with proper steps\n- Both: added QR scan instructions (Zalo app → profile → QR icon)\n- Both: added verify step after login (openclaw status → connected)\n- Both: added session expiry note + channels login troubleshooting\n- Manual clone: clarified dist/ pre-built, no build step needed",
"is_bot": false,
"headline": "docs: rewrite install guide — 3 methods (A/B/C), QR scan instructions…",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-06-11T04:28:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "69c4fb6cb98e31075aa87f6334c16dbbd5f0d0fd",
"body": "- English section: add full disclaimer with correct zalo.vn/dieukhoan link\n- English section: add npm install option (openclaw plugins install zaloclaw)\n- English section: add features-at-a-glance table\n- Badges: add npm version badge, fix ClawHub/OpenClaw links\n- Nav: cleaner EN/VI language labels",
"is_bot": false,
"headline": "docs: fix README — add EN disclaimer, npm badge, install polish",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-06-11T04:13:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f129512f0e7ab363cf47a09269e018c0c2113678",
"body": "- README: bilingual EN+VI with language toggle\n- README: document channels login bug + openclaw setup workaround\n- README: clarify install --link required before channels login\n- openclaw.plugin.json: add name/description/version/kind/homepage metadata\n- package.json: add files, publishConfig, prepublishOnly for npm release\n- package.json: add openclaw-plugin/openclaw-channel keywords\n- CHANGELOG: v2.1.0 and backfill v2.0.4 entries",
"is_bot": false,
"headline": "release: v2.1.0 — community packaging",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-06-11T03:51:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f6881199408ff87b3b1ee10162d6e57fc194e51d",
"body": "…ublish",
"is_bot": false,
"headline": "chore: bump version to 2.0.4 — CI fix + README redesign + ClawHub rep…",
"author_name": "monas-team",
"author_login": null,
"committed_at": "2026-06-10T16:29:53Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f0d3b56b792572aa6b3d97a7a54505fa5677f1ac",
"body": "…on mismatch",
"is_bot": false,
"headline": "fix(ci): fix tsc step exit code — use continue-on-error for SDK versi…",
"author_name": "monas-team",
"author_login": null,
"committed_at": "2026-06-10T15:26:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c8614e4e9e54e4a8768e9d2b58b5a447080e33cc",
"body": null,
"is_bot": false,
"headline": "Merge branch 'main' of https://github.com/monas-team/zaloclaw",
"author_name": "monas-team",
"author_login": null,
"committed_at": "2026-06-10T15:25:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b8ae67e28581920b9808693969491ad38b2b8ba1",
"body": "… update CI node actions",
"is_bot": false,
"headline": "fix: regenerate package-lock.json to resolve opusscript missing dep +…",
"author_name": "monas-team",
"author_login": null,
"committed_at": "2026-06-10T15:24:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "306fbbfdc051f3fd8aecacfb8e61c7693d7508fc",
"body": null,
"is_bot": false,
"headline": "Update README.md",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-06-10T15:20:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5fc288e94f846f45bf563ca5905cee30203d5bac",
"body": null,
"is_bot": false,
"headline": "Update README.md",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-06-10T15:19:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "193bfc5d258a84110e4e01fe2b610e4ddb74159b",
"body": "…ayout",
"is_bot": false,
"headline": "docs: redesign README — centered header, table of contents, cleaner l…",
"author_name": "monas-team",
"author_login": null,
"committed_at": "2026-06-10T15:17:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0c20d54dbae30c77d04d5f026b03821d76c6274d",
"body": null,
"is_bot": false,
"headline": "Update README.md",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-06-10T15:12:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fc359cf7a5bc4b94cf7628a97e6f2e84177b6738",
"body": "…th Zalo/VNG",
"is_bot": false,
"headline": "docs: add official disclaimer — unofficial project, not affiliated wi…",
"author_name": "monas-team",
"author_login": null,
"committed_at": "2026-06-10T15:11:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f608fce87bcc015eacf8be9f3646830a4e663b56",
"body": "…Bank/BIDV)",
"is_bot": false,
"headline": "docs: add MTTQ donation section with VietQR codes (Vietcombank/Vietin…",
"author_name": "monas-team",
"author_login": null,
"committed_at": "2026-06-10T14:50:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9ec31b504cf8e4b52dd1e1da2dd40700b14fa1bb",
"body": "…ean structure",
"is_bot": false,
"headline": "docs: rewrite README — ClawHub install, collapsible action tables, cl…",
"author_name": "monas-team",
"author_login": null,
"committed_at": "2026-06-10T14:42:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a0d2723a6537adcdb7fbaac6de7da967a1ce89f4",
"body": "… built dist",
"is_bot": false,
"headline": "chore: add ClawHub compat metadata, fix repo URLs to monas-team, ship…",
"author_name": "monas-team",
"author_login": null,
"committed_at": "2026-06-10T14:15:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e189a33a6b29a447d583360597e972147410d512",
"body": "- Add dist/index.js (esbuild bundle) — required by OpenClaw v2026.5.3+\n- Update package.json: main → dist/index.js, add openclaw.runtimeExtensions\n- Add npm run build script (esbuild)\n- Add esbuild as devDependency\n- Update .gitignore to track dist/index.js",
"is_bot": false,
"headline": "build: add compiled output for OpenClaw v2026.5.3+ compatibility",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-05-07T14:04:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ff3ff3519e955ee4d93abb0acba25df830b21480",
"body": "…lookup\n\nfix: batch and supplement group member lookups for mentions",
"is_bot": false,
"headline": "Merge pull request #19 from huynhphuquy1450/fix/multi-mention-member-…",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-05-01T17:17:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4fa19f9f2460c56f5543e56f02ee1844313339cc",
"body": null,
"is_bot": false,
"headline": "fix: batch and supplement group member lookups for mentions",
"author_name": "IziGo VN AI",
"author_login": null,
"committed_at": "2026-05-01T16:46:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "81cf36cf0319ed77f40295b70d4c28472902ca55",
"body": "fix: prevent stale and false media attachments",
"is_bot": false,
"headline": "Merge pull request #18 from huynhphuquy1450/fix/media-ingestion-guards",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-05-01T15:16:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2d70a758a8856adff420298a1365ee85fb028ca1",
"body": null,
"is_bot": false,
"headline": "fix: prevent stale and false media attachments",
"author_name": "IziGo VN AI",
"author_login": null,
"committed_at": "2026-05-01T15:09:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bff221a959ec88b9373774dd62704980fb7d0c8c",
"body": "…ess:false on silent drop",
"is_bot": false,
"headline": "fix(#17): validate msgId for send/send-styled/send-link — return succ…",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-21T23:35:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f198fb19cefbc80bc1074be2265580aa03a188ac",
"body": "Root cause: passive collector stored UTC timestamp only.\nBun Ne rendered raw UTC string (06:19) instead of GMT+7 (13:19).\n\nFix: add display_time field pre-formatted as HH:mm:ss - dd/MM/yyyy\nusing Intl.DateTimeFormat formatToParts with timeZone=Asia/Ho_Chi_Minh.\ncanonical timestamp (UTC ISO) unchanged — only display_time added.\n\nVerified: 06:20 → 13:20:41 - 20/04/2026 ✓",
"is_bot": false,
"headline": "fix: add display_time field (Asia/Ho_Chi_Minh) to passive records",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-20T08:01:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7435f9f4f0ff9a595b769e9e51e28f51470e2723",
"body": "Before: wing=zaloclaw_default (global, not group-specific)\nAfter: wing=zaloclaw__<accountId>__group_<first13chars>\n\nMatches OpenClaw exchange wing format exactly.\nverbatim_recall with group wing now returns both exchange + passive records.\nNo conflict with existing groups — each group has its own wing namespace.\nOld passive records (wing=zaloclaw_default) remain queryable.",
"is_bot": false,
"headline": "fix: passive collector wing matches exchange turn format",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-20T07:46:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e827a5f112ecb17eaf1e8367c0ab79cca0004e80",
"body": "npm ci failed on CI (Node 22/24) with:\n Missing: opusscript@0.0.8 from lock file\n\nRoot cause: PR #15 regenerated lock file with npm 11 which elides\nthe nested @discordjs/voice/node_modules/opusscript@0.0.8 entry.\nnpm 10 (used in CI via Node 22) requires this nested resolution.\n\nFix: restored the missing entry from last passing commit (db34cf8).\nDiff: +1 package entry only, no other changes.",
"is_bot": false,
"headline": "fix: restore opusscript@0.0.8 nested entry in package-lock.json",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-19T11:16:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5178813d2fe2f592e65d6e79d33d674075f98688",
"body": "…essage\n\nPreviously used mentions:[] — user received no notification.\nNow computes mention.pos/uid/len correctly so Zalo pushes\nnative notification to the warned user.\n\nRelates to #13 (already fixed in mention-parser via PR #14/#15).",
"is_bot": false,
"headline": "fix(injection-guard): build proper Zalo mention payload for warning m…",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-19T11:01:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "26eaef577bc381a314ba0a84c1bdb3bbe9fde1d6",
"body": "…-form field)",
"is_bot": false,
"headline": "fix: read passiveCollector from plugins.entries.zaloclaw.config (free…",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-19T10:47:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "304a02cd2f7955136498ca2a623efff430baa754",
"body": "Moves config from channels.zaloclaw (visible in UI) to\nplugins.entries.zaloclaw.passiveCollector (not rendered in control panel).\n\nUsers installing zaloclaw will never see this option.\nFeature is activated via internal config path only.\n\nTo enable (for epistemic users):\n plugins.entries.zaloclaw.passiveCollector.enabled = true",
"is_bot": false,
"headline": "fix: move passiveCollector to plugins.entries (hidden from channel UI)",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-19T10:46:21Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c527a2d698e015609b25e37fd3d397d5eaa18957",
"body": "Prevents conflict for users without epistemic/Elasticsearch.\npassiveCollector.enabled must be explicitly set to true in openclaw.json.\n\nWithout the flag: zero impact on non-epistemic deployments.\nWith the flag: works as before (writes to oc_verbatim).\n\nRequires: epistemic plugin + Elasticsearch running at localhost:19200",
"is_bot": false,
"headline": "fix: gate passiveCollector behind config flag (default: false)",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-19T10:43:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "50ec055897f8bd334214ecb9695c798080c068e9",
"body": "New: src/features/injection-guard.ts\n- 40+ regex patterns (EN + VI) for prompt injection detection\n- Attempt 1: silent block (not forwarded to AI)\n- Attempt 2: public warning in group with @mention\n- Attempt 3+: removeUserFromGroup (zca-js API)\n- Violation tracker resets after 1h clean behavior per \n[…]\nk AFTER passive collector, BEFORE messageQueue.enqueue\n- Async check via .then() to avoid blocking listener\n- Fail-safe: on error, message proceeds normally (no false-positive block)\n\nTypecheck: clean",
"is_bot": false,
"headline": "feat: injection guard — warn after 2 attempts, remove after 3",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-19T10:25:40Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "8dfe5e53e28e42aaec9baa00c25e9ab0a68f6df6",
"body": "New: src/features/passive-collector.ts\n- Stores ALL group messages to oc_verbatim WITHOUT calling AI\n- Zero LLM API cost — pure ES write only (fire-and-forget)\n- turn_type='passive' distinguishes from AI exchange turns\n- silent=true by default — never blocks message flow on ES error\n\nIntegration: mo\n[…]\nn-memory buffer (lost on restart)\n After: group msgs without @mention → oc_verbatim (persistent, searchable)\n\nverbatim_recall(wing='zaloclaw_default') now returns full group history\nTypecheck: clean",
"is_bot": false,
"headline": "feat: passive group message collector → oc_verbatim",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-19T10:16:34Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "dfeece9e4fa308d2fdbcb341f25b581b41e0443f",
"body": "Pre-compiled schema used by OpenClaw for config validation.\nadditionalProperties: false was blocking groupEvents field.\nTypeScript source patch alone is insufficient — plugin.json must match.",
"is_bot": false,
"headline": "fix: add groupEvents to openclaw.plugin.json JSON Schema",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-19T09:58:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a67d790284a680a22c556fe31eb102c427e1d4bd",
"body": "Adds GroupEventsSchema (optional) to allow groupEvents config\nwithout triggering 'must NOT have additional properties' error.\n\nFields: enabled, welcome, leaveAlert, adminAlert,\nwelcomeTemplate, leaveTemplate, kickTemplate,\nadminAddTemplate, adminRemoveTemplate",
"is_bot": false,
"headline": "feat: add groupEvents to ZaloClawAccountSchema",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-19T09:44:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "17e21a0a87e2112da5bf9bb6044042ced286289b",
"body": "New file: src/features/group-event.ts\n- Handles GroupEventType: JOIN, LEAVE, REMOVE_MEMBER, ADD_ADMIN, REMOVE_ADMIN\n- Config-driven via account.config.groupEvents (all disabled by default)\n- Template system: {name}, {groupName} variables\n- No API cost on event arrival — only when bot sends a reply\n\n\n[…]\nfriend_event and reaction\n- Uses same pattern as existing listeners (fire-and-forget, error-logged)\n- requireMention NOT required — independent of message pipeline\n\nTypecheck: clean (npx tsc --noEmit)",
"is_bot": false,
"headline": "feat: group_event listener — welcome, leave, kick, admin alerts",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-19T09:32:51Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "f0d211491c565442e630e526dd2ddeaa65437cad",
"body": "fix: resolve @mentions in send/send-styled tool actions",
"is_bot": false,
"headline": "Merge pull request #15 from huynhphuquy1450/fix/mention-in-send-tool",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-18T02:48:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e010ad211c3337222ba82db066673e229dfcafa9",
"body": "send and send-styled tool actions now call resolveOutboundMentions()\nfor group messages, matching the existing behavior in the channel\nadapter (send.ts). This ensures @[Name] syntax in tool-initiated\nmessages produces real Zalo mention payloads with highlight + notify.\n\nChanges:\n- tool.ts: import re\n[…]\nin send/send-styled\n when isGroup=true, attach mentions array to sendMessage payload\n- Response now includes mentionsResolved count\n\nTested: mentionsResolved:1, blue highlight + red notify confirmed.",
"is_bot": false,
"headline": "fix: resolve @mentions in send/send-styled tool actions",
"author_name": "IziGo VN AI",
"author_login": null,
"committed_at": "2026-04-18T02:05:04Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "92a516ab89c6002efcee0fec82d12e7c7ce1e519",
"body": "…ification\n\n[WIP] Fix Zalo notification for @mention in send/send-styled",
"is_bot": false,
"headline": "Merge pull request #14 from monasprox/copilot/bugfix-zalo-mention-not…",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-17T16:21:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "23eb4992e6ef9bdcabd5ed9819da4ee30bdd871f",
"body": "…rofiles for mention resolution\n\nWhen getGroupMembersInfo returns empty profiles (can happen in some Zalo groups),\nthe mention resolver would find no matches and return an empty mentions array,\ncausing @[Name] to be sent as plain text without triggering Zalo notifications.\n\nFix: add two-level fallba\n[…]\n and all fallback paths.\"\n\nAgent-Logs-Url: https://github.com/monasprox/zaloclaw/sessions/ae4556d6-64bf-4c2f-8e3b-69c085210904\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "fix: fallback to getUserInfo when getGroupMembersInfo returns empty p…",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-17T16:20:13Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "628b5639579a878cd506cc42d618f7b6193a824b",
"body": "Agent-Logs-Url: https://github.com/monasprox/zaloclaw/sessions/ae4556d6-64bf-4c2f-8e3b-69c085210904\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "chore: initial plan for mention fallback fix",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-17T16:17:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "df7c547e8b4288d5ca530196cc8419001ac94670",
"body": null,
"is_bot": true,
"headline": "Initial plan",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-17T16:13:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "db34cf8181018fa11dbe11cf8f9c474ebede9085",
"body": "feat: per-thread message queue with concurrency control",
"is_bot": false,
"headline": "Merge pull request #12 from monasprox/copilot/enhance-queue-processing",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-17T11:28:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "18ac5d971f2d7cec500a13db74ce36fc8f478097",
"body": "…y type assertion\n\nAgent-Logs-Url: https://github.com/monasprox/zaloclaw/sessions/f017afa4-bbdd-46a8-bcfd-2fff57994b1c\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "fix: address code review feedback - remove unused code and unnecessar…",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-17T11:26:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d8cfba7307858e4d6ad694b9d9ac8a5dc05f8b50",
"body": "Replace fire-and-forget processMessage dispatch with ThreadMessageQueue that\nprovides per-thread serial processing, global concurrency limit (4),\nqueue-depth limit (10 per thread), stale message skipping (5min),\nand processing timeout (3min). Modeled after openclaw/telegram's\n@grammyjs/runner sink.concurrency pattern.\n\nAgent-Logs-Url: https://github.com/monasprox/zaloclaw/sessions/f017afa4-bbdd-46a8-bcfd-2fff57994b1c\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "feat: add per-thread message queue with concurrency control",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-17T11:24:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "81bd8444f720a5f019c54be0c629bc9e3116fe82",
"body": "fix: regenerate package-lock.json with npm 10 for Node 22 CI compat",
"is_bot": false,
"headline": "Merge pull request #11 from monasprox/copilot/fix-npm-ci-error",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-17T11:21:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4c73409ac2a4f13bcf165da0d98e88646d4314df",
"body": "The lockfile was generated with npm 11 which omitted the nested\nopusscript@0.0.8 resolution required by prism-media (peer dep of\n@discordjs/voice). npm 10 strictly validates that ^0.0.8 resolves\nto 0.0.8 (not 0.1.1), so npm ci failed on Node 22.\n\nRegenerated with npm 10.9.7 (Node 22.22.2) for cross-version compat.\n\nAgent-Logs-Url: https://github.com/monasprox/zaloclaw/sessions/f2cd650a-a78f-4115-a777-1c8b297ed5ae\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "fix: regenerate package-lock.json with npm 10 (Node 22) to fix npm ci",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-17T11:16:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "06f5c394250874b7feeaa1bb2420f84a9ac2cd41",
"body": "…ssage-listener\n\nfix: deduplicate inbound messages by msgId to prevent duplicate replies",
"is_bot": false,
"headline": "Merge pull request #10 from monasprox/copilot/fix-deduplication-in-me…",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-17T11:03:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "71f619928cef70375bc9c4ec3edb858fd3be4946",
"body": "Zalo sends two events for the same message (original + delivery-mirror).\nWithout dedup, both events trigger processMessage → bot replies twice.\n\nAdded a time-bounded (60s TTL, 2000 max) msgId dedup cache in the\nmessage listener to skip already-processed message IDs.\n\nAgent-Logs-Url: https://github.com/monasprox/zaloclaw/sessions/edfbe7cc-92a9-4347-8e67-aa4c56e66320\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "fix: deduplicate inbound messages by msgId to prevent duplicate replies",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-17T10:59:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e1fd08840f78e59a4c84072699f13eb57dedab6c",
"body": "Critical fixes:\n- api.undo(): remove extra threadId/type params (docs: 1 param only)\n- addGroupBlockedMember/removeGroupBlockedMember: fix param order (uid,gid)\n\nHigh fixes:\n- updateProfile: wrap in { profile: {...} }, fetch current before partial update\n- last-online: use api.lastOnline(uid) instea\n[…]\nafety: fallback to api.getOwnId()\n- getBizAccount: remove unused uid param\n- join-group-link: wrap getGroupLinkInfo in separate try/catch\n- Tool description: 130 -> 147 actions\n\nBumps version to 2.0.3",
"is_bot": false,
"headline": "fix: 18 bugs from API contract audit against zca-js docs",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-15T11:08:11Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "bc239aea616ae86df2b4eea04e863a2676e165d3",
"body": null,
"is_bot": false,
"headline": "docs: update CHANGELOG for agent-install.md enhancements",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-15T10:14:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "93a233071a2b6b71fb0fd70fbf32fe66620599e8",
"body": "…and correct paths\n\n- Add Bước 0: mandatory plugin conflict check before installation\n- Add correct directory structure (~/.openclaw/workspace/.openclaw/extensions/zaloclaw)\n- Add migration guide for moving from old plugin locations\n- Add comprehensive debug/diagnostic section (6 steps)\n- Add npm lockfile troubleshooting (Node 22 requirement)\n- Update version footer to 2.0.2",
"is_bot": false,
"headline": "docs: enhance agent-install.md with pre-install checks, debug guide, …",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-15T10:10:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "786dbe6300d962b72e5f1512b1dc7eb9bfb45485",
"body": "…t@0.0.8\n\nnpm 10 correctly resolves the nested peer dep:\n- opusscript@0.1.1 (top-level, for openclaw ^0.1.1)\n- opusscript@0.0.8 (nested under @discordjs/voice, for prism-media ^0.0.8)\n\nnpm 11 (Node 24) skips optional peer deps entirely, producing a lockfile\nthat npm 10 rejects with 'Missing: opusscript@0.0.8 from lock file'.",
"is_bot": false,
"headline": "fix(ci): regenerate lockfile with npm 10 (Node 22) — nested opusscrip…",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-15T09:15:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "43c1afd6c90fbe501228e5de99a1b9810e671ca0",
"body": null,
"is_bot": false,
"headline": "fix(ci): regenerate package-lock.json — resolve missing opusscript@0.0.8",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-15T09:07:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cb22c0c37eeec17875f46e925b4d2b6e2ea39579",
"body": "… UI labels\n\n- openclaw.plugin.json uiHints label\n- index.ts name + label\n- channel.ts label + selectionLabel + QR prompt\n- onboarding.ts login description\n- config-schema.ts label",
"is_bot": false,
"headline": "refactor: rename display name 'OpenClaw Zalo' → 'ZaloClaw' across all…",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-15T09:01:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5c78906243d650d274644c73b34c4c6b0afff8ab",
"body": "- reply-scoped media binding fix (no more buffer leak)\n- opclaw-zalo → zaloclaw rename\n- Vietnamese translations for all docs/templates\n- agent-help.md and TOOLS.md additions\n- CI lockfile fix (opusscript@0.0.8)\n- Bump version to 2.0.2",
"is_bot": false,
"headline": "docs: update CHANGELOG for v2.0.2 — media fix, rename, Vietnamese docs",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-15T04:48:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1d5f8d272da4dcf8d40f314f196b008b0c3ec611",
"body": "fix: regenerate package-lock.json to fix CI failure (missing opusscript@0.0.8)",
"is_bot": false,
"headline": "Merge pull request #9 from monasprox/copilot/fix-action-job-error",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-15T04:32:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "635232c9c1ec836875bf2c1b056fe0ee4b989dfe",
"body": "….0.8\n\nAgent-Logs-Url: https://github.com/monasprox/zaloclaw/sessions/6e0376dd-bee1-46bc-bd65-8ce5acd2aed7\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "fix: regenerate package-lock.json with npm 10 to include opusscript@0…",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-15T04:29:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b6b500bcfaebdd0f6d86d0852c07f335a18372a7",
"body": "…claw\n\nRename opclaw-zalo → zaloclaw, standardize docs to Vietnamese",
"is_bot": false,
"headline": "Merge pull request #8 from monasprox/copilot/replace-opclaw-with-zalo…",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-15T04:19:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9e064b8e64c11551d36f850fba8f31ce37a4f3af",
"body": "Agent-Logs-Url: https://github.com/monasprox/zaloclaw/sessions/bf1f42b4-8970-4ae7-8c56-3655cb28e71e\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "docs: translate all documentation and templates to Vietnamese",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-15T04:16:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3a72d4276efcd26aa7bf11b4dbe98bc09efbabca",
"body": "Agent-Logs-Url: https://github.com/monasprox/zaloclaw/sessions/bf1f42b4-8970-4ae7-8c56-3655cb28e71e\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "refactor: rename opclaw-zalo → zaloclaw across entire codebase",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-15T04:09:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ff7152940d94de61b0421c2e8aa6c4741fc2888c",
"body": "fix: add missing opusscript@0.0.8 peer dep resolution to lockfile",
"is_bot": false,
"headline": "Merge pull request #7 from monasprox/copilot/fix-lint-errors",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-15T03:20:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b16c48fd0124f1dbc10ac29bce565590ff5cc658",
"body": "…p resolution\n\nAgent-Logs-Url: https://github.com/monasprox/opclaw-zalo/sessions/c512d6f6-05c4-4b74-9f16-b5b95d8503a4\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "fix: regenerate package-lock.json to include opusscript@0.0.8 peer de…",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-15T03:17:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "604b3c66bc61b379e81b55e0fe1fbcfaee5fd429",
"body": "Previously, when the bot was @mentioned in a group, consumeGroupBuffer()\ndrained ALL buffered images (up to 50 messages / 4 hours) from the entire\nroom and merged them into the agent's vision context. This caused the agent\nto see unrelated images from other users.\n\nFix:\n- consumeGroupBuffer() now re\n[…]\nach parsing)\n\nThis enforces the correct rule:\n mention + reply + reply-target-has-image → load only that image\n mention without reply → no images loaded\n no mention → skip media resolution entirely",
"is_bot": false,
"headline": "fix: reply-scoped media binding — stop cross-message media contamination",
"author_name": "monasprox",
"author_login": "monasprox",
"committed_at": "2026-04-15T03:05:08Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ae7b8c9eabdac388040ded870e6f4932225c95c0",
"body": "Add agent-help.md and TOOLS.md for persistent agent tool knowledge",
"is_bot": false,
"headline": "Merge pull request #6 from monasprox/copilot/update-agent-help-file",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-15T03:00:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e14c53159dcb5c1211756779c8b5d157eafcbe41",
"body": "…eference\n\n- Create docs/agent-help.md: full guide for AI agents covering all 147 tool\n actions with params, examples, update process, and persistence instructions\n- Create TOOLS.md: quick reference for agents to read at session start\n- Update README.md to reference new agent-help.md and TOOLS.md\n\nAgent-Logs-Url: https://github.com/monasprox/opclaw-zalo/sessions/8c66bdbc-94f8-47a9-8df3-3e1890d09ae7\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "Add docs/agent-help.md comprehensive agent guide and TOOLS.md quick r…",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-15T02:56:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1a9db694cabec39239c30764cf3224b1ef151045",
"body": "…o-main\n\nMerge v2.0.1: CI lockfile fix + security audit changelog into main",
"is_bot": false,
"headline": "Merge pull request #5 from monasprox/copilot/merge-pull-request-4-int…",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-14T19:49:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dc8fd364a52ff8478b2b56cd0c66b580d78c4200",
"body": "Co-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "Merge main into branch for PR targeting",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-14T19:45:56Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4810bf42815b984f81ea79407eb2f686b8386b1f",
"body": "…8 resolution; bump v2.0.1 with security audit changelog\n\nAgent-Logs-Url: https://github.com/monasprox/opclaw-zalo/sessions/a5517fe7-cbd1-43b2-b8ab-d4b290719585\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "fix(ci): regenerate package-lock.json with npm 10 for opusscript@0.0.…",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-14T19:27:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "84e29f79e21609b96d2513c573f096f0e35dd6e1",
"body": "…nd-bugs\n\nSecurity remediation: SSRF, path traversal, sandbox enforcement, race conditions, and 17 additional audit fixes",
"is_bot": false,
"headline": "Merge pull request #3 from monasprox/copilot/audit-source-code-and-fi…",
"author_name": "Monas",
"author_login": "monasprox",
"committed_at": "2026-04-14T19:03:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "18d1206920da523eb126aba4543f273a5ad373b4",
"body": "…mprove IPv6 check\n\nAgent-Logs-Url: https://github.com/monasprox/opclaw-zalo/sessions/f8a121fa-9c32-4fa3-bd06-21fd43e901aa\n\nCo-authored-by: monasprox <244426571+monasprox@users.noreply.github.com>",
"is_bot": true,
"headline": "Address code review: fix CDN regex bypass, replace dynamic imports, i…",
"author_name": "copilot-swe-agent[bot]",
"author_login": "Copilot",
"committed_at": "2026-04-14T19:00:22Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 11,
"commits_last_year": 130,
"latest_release_at": "2026-07-18T07:34:50Z",
"latest_release_tag": "v2.5.7",
"releases_from_tags": false,
"days_since_last_push": 11,
"active_weeks_last_year": 8,
"days_since_latest_release": 18,
"mean_days_between_releases": 1
},
"artifacts": {
"collected": true,
"structure": [],
"declarations": [
{
"name": "zaloclaw",
"path": "package.json",
"tokens": [
"npm.entry",
"npm.peer_dependencies"
],
"ecosystem": "npm"
}
]
},
"community": {
"has_readme": true,
"has_license": true,
"readme_badges": {
"hosts": [
"shields.io"
],
"total": 4,
"header": 4,
"collected": true,
"has_inspect_badge": false
},
"has_description": true,
"has_contributing": true,
"health_percentage": 87,
"has_issue_template": false,
"has_code_of_conduct": true,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "zaloclaw",
"exists": true,
"license": "MIT",
"keywords": [
"openclaw-channel",
"openclaw-plugin",
"openclaw",
"zalo",
"chatbot",
"channel-plugin",
"zca-js",
"messaging"
],
"ecosystem": "npm",
"categories": [],
"matches_repo": true,
"registry_url": "https://www.npmjs.com/package/zaloclaw",
"declared_type": null,
"is_deprecated": false,
"latest_version": "2.5.11",
"repository_url": "https://github.com/monas-team/zaloclaw",
"versions_count": 15,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": 1,
"monthly_downloads": 2241,
"first_published_at": "2026-06-11T04:09:50.975000Z",
"latest_published_at": "2026-07-25T06:18:52.888000Z",
"latest_version_yanked": null,
"days_since_latest_publish": 11
}
]
},
"popularity": {
"forks": 9,
"stars": 23,
"watchers": 1,
"fork_history": {
"days": [
{
"date": "2026-04-18",
"count": 1
},
{
"date": "2026-04-25",
"count": 1
},
{
"date": "2026-06-01",
"count": 1
},
{
"date": "2026-06-06",
"count": 1
},
{
"date": "2026-06-30",
"count": 1
},
{
"date": "2026-07-13",
"count": 1
},
{
"date": "2026-07-16",
"count": 1
},
{
"date": "2026-07-22",
"count": 1
},
{
"date": "2026-07-23",
"count": 1
}
],
"complete": true,
"collected": 9,
"total_forks": 9
},
"star_history": null,
"open_issues_and_prs": 0
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [
"tsconfig.json"
],
"toolchain_manifests": [],
"largest_source_bytes": 80724,
"source_files_sampled": 46,
"oversized_source_files": 2,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"dependencies": {
"manifests": [
"package.json"
],
"advisories": {
"error": null,
"scope": "published_package",
"source": "osv",
"findings": [
{
"name": "sharp",
"direct": true,
"version": "0.33.5",
"severity": "high",
"ecosystem": "npm",
"cvss_score": 7.3,
"advisory_ids": [
"GHSA-f88m-g3jw-g9cj"
],
"fixed_version": "0.35.0",
"advisory_count": 1,
"oldest_advisory_days": 14
}
],
"collected": true,
"malicious": [],
"truncated": false,
"by_severity": {
"high": 1
},
"advisory_count": 1,
"affected_count": 1,
"assessed_count": 68,
"malicious_count": 0,
"assessed_package": "npm:zaloclaw@2.5.11",
"unassessed_count": 0,
"direct_affected_count": 1
},
"ecosystems": [
"npm"
],
"dependencies": [
{
"name": "@sinclair/typebox",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^0.34.0"
},
{
"name": "jsqr",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^1.4.0"
},
{
"name": "pngjs",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^7.0.0"
},
{
"name": "qrcode-terminal",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^0.12.0"
},
{
"name": "sharp",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^0.33.0"
},
{
"name": "zca-js",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^2.1.2"
},
{
"name": "zod",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^4.3.6"
}
],
"all_dependencies": {
"error": "GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
"source": null,
"packages": [],
"collected": false,
"truncated": false,
"total_count": null,
"direct_count": null,
"indirect_count": null
}
},
"maintainership": {
"issues": {
"open_prs": 0,
"merged_prs": 16,
"open_issues": 0,
"closed_ratio": 1,
"closed_issues": 5,
"closed_unmerged_prs": 2
},
"bus_factor": 1,
"bot_contributors": 1,
"top_contributors": [
{
"type": "User",
"login": "monasprox",
"commits": 82,
"avatar_url": "https://avatars.githubusercontent.com/u/244426571?v=4"
}
],
"contributors_sampled": 1,
"top_contributor_share": 1
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"ci.yml"
],
"has_docs_dir": true,
"linter_configs": [],
"has_editorconfig": true,
"has_linter_config": false,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [
"package-lock.json"
],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 0,
"reason": "branch protection not enabled on development/release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": null,
"reason": "no pull request found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 0/30 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 3,
"reason": "project has 1 contributing companies or organizations -- score normalized to 3",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 10,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "30 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": null,
"reason": "packaging workflow not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 3,
"reason": "dependency not pinned by hash detected -- score normalized to 3",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "no SAST tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 10,
"reason": "security policy file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 0,
"reason": "52 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "4807a687ebb63fcf7e9b0540ea9eab7e50f7f652",
"ran_at": "2026-08-05T09:24:22Z",
"aggregate_score": 3.9,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": true,
"has_dependabot_config": false
},
"contribution_flow": {
"collected": true,
"recent_prs": {
"merged_7d": 0,
"decided_7d": 0,
"merged_30d": 0,
"authors_30d": 2,
"decided_30d": 2,
"sample_size": 18,
"window_days": 30,
"sample_exhausted": false,
"authors_probed_30d": 2,
"newcomer_merged_30d": 0,
"bot_prs_excluded_30d": 0,
"newcomer_authors_30d": 2,
"newcomer_decided_30d": 2
},
"ci_last_run_at": "2026-07-25T06:19:22Z",
"oldest_open_prs": [],
"last_merged_pr_at": "2026-05-01T17:17:03Z",
"ci_last_conclusion": "SUCCESS",
"oldest_open_issues": []
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/monas-team/zaloclaw",
"host": "github.com",
"name": "zaloclaw",
"owner": "monas-team"
},
"metrics": {
"overall": {
"key": "overall",
"band": "good",
"name": "Overall health",
"note": "The weighted overall 62 is calibrated to 69 on the published index scale (record calibration 2026-08-02).",
"notes": [
{
"code": "overall_calibration",
"params": {
"raw": 62,
"calibrated": 69,
"calibration": "2026-08-02"
}
}
],
"value": 69,
"inputs": {
"security": 47,
"vitality": 77,
"community": 55,
"governance": 51,
"calibration": "2026-08-02",
"engineering": 81,
"ai_readiness": 53,
"weighted_overall_raw": 62
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "good",
"name": "Vitality",
"value": 77,
"weight": 0.21,
"metrics": [
{
"key": "development_activity",
"band": "moderate",
"name": "Development activity",
"note": null,
"notes": [],
"value": 62,
"inputs": {
"commits_last_year": 130,
"human_commit_share": 0.85,
"days_since_last_push": 11,
"active_weeks_last_year": 8
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 11 days ago",
"points": 28.8,
"status": "partial",
"details": [
{
"code": "push_recency",
"params": {
"days": 11
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "8/52 weeks with commits",
"points": 5.5,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 8
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "130 commits in the last year",
"points": 18,
"status": "met",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 130
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "30 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "exceptional",
"name": "Release discipline",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 100,
"inputs": {
"releases_count": 11,
"latest_release_tag": "v2.5.7",
"releases_from_tags": false,
"days_since_latest_release": 18,
"mean_days_between_releases": 1
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "11 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 11
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 18 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 18
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~1 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 1
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "exceptional",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "unverified",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": "repository_too_young",
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": null,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "maintenance record not established from the collected data",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_unverified",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "moderate",
"name": "Community & Adoption",
"value": 55,
"weight": 0.17,
"metrics": [
{
"key": "popularity",
"band": "at_risk",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 29,
"inputs": {
"forks": 9,
"stars": 23,
"watchers": 1,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "23 stars",
"points": 21.8,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 23
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "9 forks",
"points": 7.5,
"status": "partial",
"details": [
{
"code": "forks",
"params": {
"count": 9
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "1 watchers",
"points": 0,
"status": "missed",
"details": [
{
"code": "watchers",
"params": {
"count": 1
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "excellent",
"name": "Community health",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"has_readme": true,
"has_license": true,
"readme_badges": 4,
"has_contributing": true,
"has_issue_template": false,
"has_code_of_conduct": true,
"readme_badge_services": [
"shields.io"
],
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (MIT)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "MIT"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 18,
"status": "met",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 13.5,
"status": "met",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
},
{
"key": "ecosystem_adoption",
"band": "moderate",
"name": "Ecosystem adoption (downloads)",
"note": "Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"registry_dependents"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 56,
"inputs": {
"packages": [
"zaloclaw"
],
"dependents": null,
"ecosystems": "npm",
"total_downloads": null,
"monthly_downloads": 2241
},
"components": [
{
"key": "monthly_downloads",
"name": "Monthly downloads",
"detail": "2,241 downloads/month across npm",
"points": 44.7,
"status": "partial",
"details": [
{
"code": "downloads_monthly",
"params": {
"count": 2241,
"ecosystems": "npm"
}
}
],
"max_points": 80
},
{
"key": "registry_dependents",
"name": "Registry dependents",
"detail": "not reported by this ecosystem",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_reported_by_this_ecosystem",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 51,
"weight": 0.23,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 13,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 1,
"top_contributor_share": 1
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 100% of commits",
"points": 0,
"status": "missed",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 100
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "1 contributors",
"points": 1.4,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 1
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 3,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "good",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 69,
"inputs": {
"merged_prs": 16,
"open_issues": 0,
"closed_issues": 5,
"prs_merged_7d": 0,
"prs_decided_7d": 0,
"prs_merged_30d": 0,
"prs_decided_30d": 2,
"issue_closed_ratio": 1,
"closed_unmerged_prs": 2,
"first_time_authors_30d": 2,
"first_time_prs_merged_30d": 0,
"first_time_prs_decided_30d": 2
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "100% of issues closed",
"points": 42,
"status": "met",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 100
}
}
],
"max_points": 42
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "16/18 decided PRs merged",
"points": 26.7,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 16,
"decided": 18
}
}
],
"max_points": 30
},
{
"key": "newcomer_pr_acceptance",
"name": "Newcomer PR acceptance",
"detail": "0/2 first-time contributors' PRs merged in 30d",
"points": 0,
"status": "missed",
"details": [
{
"code": "newcomer_prs_merged",
"params": {
"days": 30,
"merged": 0,
"decided": 2
}
}
],
"max_points": 13
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 0/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "weak",
"name": "Ownership & stewardship",
"note": null,
"notes": [],
"value": 38,
"inputs": {
"followers": 4,
"owner_type": "Organization",
"is_verified": null,
"owner_login": "monas-team",
"public_repos": 1,
"account_age_days": 65
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "organization-owned",
"points": 30,
"status": "met",
"details": [
{
"code": "owner_organization",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "4 followers of monas-team",
"points": 5,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 4,
"login": "monas-team"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "1 public repos, account ~0 yr old",
"points": 2.5,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 1
}
},
{
"code": "account_age_years",
"params": {
"years": 0
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "exceptional",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"zaloclaw"
],
"ecosystems": "npm",
"any_deprecated": false,
"min_days_since_publish": 11
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on npm",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "npm"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 11 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 11
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "15 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 15
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "excellent",
"name": "Engineering Quality",
"value": 81,
"weight": 0.19,
"metrics": [
{
"key": "engineering_practices",
"band": "good",
"name": "Engineering practices",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: CI-Tests. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_ci_tests"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 68,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": true,
"has_linter_config": false,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "1 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 1
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 6.4,
"status": "met",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "no pull request found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "exceptional",
"name": "Documentation",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"topics": [
"ai-agent",
"chat-automation",
"messaging",
"openclaw",
"typescript",
"workflow-automation",
"zalo",
"zalo-bot",
"zca-js"
],
"has_wiki": true,
"homepage": "https://openclaw.monas.us/zalo",
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "https://openclaw.monas.us/zalo",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "9 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 9
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "weak",
"name": "Security",
"value": 47,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "weak",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): CI-Tests, Packaging, Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"ci_tests",
"packaging",
"signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 39,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 15,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 3,
"scorecard_aggregate": 3.9
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection not enabled on development/release branches",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "no pull request found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 0/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 0.8,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "30 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow not detected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 3",
"points": 1.5,
"status": "partial",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "no SAST tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "52 existing vulnerabilities detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "dependency_advisories",
"band": "excellent",
"name": "Dependency advisories",
"note": "Matched the npm:zaloclaw@2.5.11 runtime dependency closure — what installing the published package pulls in — 68 packages. Reachability is not analyzed.",
"notes": [
{
"code": "advisories_scope_published",
"params": {
"package": "npm:zaloclaw@2.5.11",
"assessed": 68
}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 80,
"inputs": {
"source": "osv",
"advisories": 1,
"affected_packages": 1,
"assessed_packages": 68,
"unassessed_packages": 0,
"affected_by_severity": "high 1",
"direct_affected_packages": 1
},
"components": [
{
"key": "direct_dependencies_free_of_known_advisories",
"name": "Direct dependencies free of known advisories",
"detail": "1 affected: sharp 0.33.5 (high 7.3)",
"points": 14.6,
"status": "partial",
"details": [
{
"code": "advisories_affected",
"params": {
"count": 1,
"packages": "sharp 0.33.5 (high 7.3)"
}
}
],
"max_points": 35
},
{
"key": "indirect_dependencies_free_of_known_advisories",
"name": "Indirect dependencies free of known advisories",
"detail": "no indirect dependency carries a known advisory",
"points": 25,
"status": "met",
"details": [
{
"code": "no_indirect_advisories",
"params": {}
}
],
"max_points": 25
},
{
"key": "no_advisories_left_outstanding",
"name": "No advisories left outstanding",
"detail": "no advisory has been public longer than 90 days",
"points": 40,
"status": "met",
"details": [
{
"code": "advisories_none_stale",
"params": {
"days": 90
}
}
],
"max_points": 40
}
]
},
{
"key": "malicious_dependencies",
"band": "exceptional",
"name": "Malicious dependencies",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"source": "osv",
"meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
"packages": [],
"red_flag": false,
"assessed_packages": 68,
"malicious_packages": 0,
"direct_malicious_packages": 0,
"withdrawn_malicious_packages": 0,
"installable_malicious_packages": 0
},
"components": [
{
"key": "no_dependency_reported_as_a_malicious_package",
"name": "No dependency reported as a malicious package",
"detail": "no dependency is reported as a malicious package",
"points": 100,
"status": "met",
"details": [
{
"code": "no_malicious_dependencies",
"params": {}
}
],
"max_points": 100
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "exceptional",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"commit_weight_rule": {
"min_commits": 50,
"min_commit_share": 0.1
},
"review_only_matches": 0,
"below_threshold_exposures": [],
"assessed_self_published_locations": 2
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "moderate",
"name": "AI Readiness",
"value": 53,
"weight": 0.04,
"metrics": [
{
"key": "ai_agent_context",
"band": "weak",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.918,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "no CLAUDE.md / AGENTS.md / editor rules",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_instructions",
"params": {}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "78 of 85 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 78,
"sampled": 85
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "weak",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 46,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [
"package-lock.json"
],
"has_dockerfile": false,
"typed_language": true,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [
"tsconfig.json"
],
"agent_commit_share": 0,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": "tsconfig.json",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "tsconfig.json"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "lockfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "lockfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "no agent-authored commits among the last 100",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_authored_commits",
"params": {
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 3",
"points": 3,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "exceptional",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 98,
"inputs": {
"primary_language": "TypeScript",
"largest_source_bytes": 80724,
"source_files_sampled": 46,
"oversized_source_files": 2
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "TypeScript (statically typed)",
"points": 45,
"status": "met",
"details": [
{
"code": "statically_typed_language",
"params": {
"language": "TypeScript"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "2/46 source files over 60KB",
"points": 52.6,
"status": "partial",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 46,
"oversized": 2
}
}
],
"max_points": 55
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight: agent tooling is a real maintenance signal, but its absence must never gate the top of the scale (calibration saturates at raw 91, so 100/100 remains reachable with AI Readiness at zero)."
}
],
"classification": {
"top": [
"library"
],
"labels": [
"library"
],
"scores": {
"plugin": 2,
"library": 17,
"chat-bot": 2
},
"primary": "library",
"evidence": [
{
"tier": "declared",
"label": "library",
"source": "npm.entry",
"weight": 8
},
{
"tier": "distribution",
"label": "library",
"source": "registry:npm",
"weight": 6
},
{
"tier": "declared",
"label": "library",
"source": "npm.peer_dependencies",
"weight": 3
},
{
"tier": "tags",
"label": "chat-bot",
"source": "tag:chatbot",
"weight": 2
},
{
"tier": "description",
"label": "plugin",
"source": "description:plugin",
"weight": 2
}
],
"artifacts": [
{
"path": "package.json",
"labels": [
"library"
],
"ecosystem": "npm"
}
],
"confidence": "high",
"host_extension": false,
"runs_as_process": false,
"consumed_by_code": true
},
"metrics_version": "2.5.0"
},
"warnings": [
"Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token",
"GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository"
],
"report_type": "repository",
"generated_at": "2026-08-05T09:24:27.190074Z",
"schema_version": "0.31.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/m/monas-team/zaloclaw.svg",
"full_name": "monas-team/zaloclaw",
"license_state": "standard",
"license_spdx": "MIT"
}