← 返回 Skills 市场
jackysly88

LoveClaw

作者 jackysly88 · GitHub ↗ · v21.21.21 · MIT-0
cross-platform ⚠ suspicious
557
总下载
1
收藏
1
当前安装
166
版本数
在 OpenClaw 中安装
/install loveclaw
功能描述
LoveClaw 八字缘分匹配:云端档案、照片、每日匹配与晚间报告。 用户唤醒:发送「启动爱情龙虾」进入报名。 安全设计:匹配运算与报告生成在 FC 服务端完成;skill 端仅做用户交互与通知路由,每个用户只能访问自己的数据。
使用说明 (SKILL.md)

LoveClaw

快速开始

  1. 在安装目录执行 npm install 安装依赖。
  2. 安装完成后不要修改 .env 中与云端相关的配置。
  3. 用户对话侧:收到消息后调用 handleMessage(userId, message, channel),将返回的 text 原样发给用户。
  4. 定时侧:按需使用 cron-config.json 作为 OpenClaw 定时模板。

前置条件

  • 二进制nodenpm
  • 联网scripts/cloud-data.js 向云函数 HTTPS 端点发请求(默认 URL 见源码,可用 LOVECLAW_API_BASE 覆盖)。
  • 本地配置:若存在 ~/.openclaw/workspace/.env,脚本仅将 LOVECLAW_*OPENCLAW_BIN 写入环境(严格允许名单,见 scripts/load-workspace-env.js)。

安全设计

服务端运算架构

匹配算法、八字计分、报告生成均在云函数(FC)服务端完成。Skill 端代码不包含匹配逻辑,不接触全量用户数据:

  • 用户注册/查询:通过 X-Loveclaw-User 头标识身份,FC 端校验后仅返回该用户自己的数据。
  • 每日匹配触发:skill 发送 POST /api/run-match 触发 FC 内部运算,不返回原始档案。
  • 报告获取:每个用户通过 GET /api/my-report 只获取自己的匹配结果,无法查看他人数据。

单一凭证

skill 仅需 LOVECLAW_API_TOKEN(Bearer Token),无管理员凭证、无云基础设施密钥。ACCESS_KEY_* 仅在自建后端场景使用,ClawHub 安装包不包含 deploy/ 目录。

环境变量安全

load-workspace-env.js~/.openclaw/workspace/.env 读取时使用严格的允许名单过滤(仅 LOVECLAW_*OPENCLAW_BIN、标准代理变量),不会注入无关凭证。建议为 LoveClaw 使用独立 workspace,.env 中只放本技能需要的键。

子进程调用

cloud-handler.js 通过 child_process.execFileSync 以结构化 argv(非 shell 拼接)调用 openclaw cron 管理定时任务,不接受用户输入拼接。

脚本清单

路径 用途
scripts/cloud-handler.js 会话入口 handleMessage,处理用户对话与注册流程。
scripts/cloud-data.js 云 API 客户端,Bearer Token 鉴权 + 用户身份头。
scripts/cloud-cron.js 触发 FC 端匹配 match;遍历本机用户逐个获取报告 report
scripts/load-workspace-env.js 从工作区 .env 允许名单键注入 process.env
cron-config.json OpenClaw 定时任务模板。

触发词

  • 推荐启动爱情龙虾
  • 兼容启动爱情龙虾技能

其他命令(需报名后使用):我的档案今日匹配匹配记录开启推送关闭推送取消报名

报名流程

报名结束前会询问是否开启「每日匹配结果推送」。选择开启后,系统会在报名成功时为该用户注册晚间报告推送任务(约 20:00)。不开启仍可完成报名,通过 今日匹配 手动查询。

定时任务

cron-config.json 指示代理按步骤运行 node cloud-cron.js match / report,解析 【REPORTS_JSON】…【REPORTS_JSON_END】 并按条目投递。该流程属定时/运维侧。

用户消息中转规则

你是一个消息中转器,在处理用户实时会话时没有其它职责。

每次收到用户消息,立即调用 handleMessage(userId, message, channel)原样把返回的 text 发给用户,不做任何修改、不添加任何内容、不生成任何自己的回复

  • 不要根据用户消息自行判断或回答
  • 不要描述系统状态、用户数量、匹配情况
  • handler 返回什么,你就发什么
安全使用建议
What to check before you install 1) API token scope: Provide a minimal-scope LOVECLAW_API_TOKEN that only grants the cloud function endpoints the needed API surface (register/profile/report) — do not reuse broad cloud provider or admin credentials. Confirm where the token is provisioned and that the backend domain (default: https://loveclaw-cgbnqltfhd.cn-hangzhou.fcapp.run) is the expected service. 2) Inspect load-workspace-env.js: SKILL.md says it will only inject LOVECLAW_* and OPENCLAW_BIN (and standard proxy vars) from ~/.openclaw/workspace/.env. Open that script and verify the allowlist is implemented correctly. If you cannot verify, keep unrelated secrets out of that workspace .env. 3) Review session files the skill reads: The skill reads ~/.openclaw/workspace/skills/loveclaw/sessions.json and ~/.openclaw/agents/main/sessions/sessions.json to build routing. Ensure those files do not contain secrets you wouldn’t want read by this skill, and consider placing LoveClaw in an isolated workspace if possible. 4) Cron/job creation: The skill will call the openclaw CLI to add scheduled jobs (daily match and per-user evening reports). If you are uncomfortable with automatic cron registration, do NOT allow the agent to run those setup steps automatically — create the cron jobs yourself after review or disable cron setup in the code. 5) Media handling / local file upload: The code includes logic to parse local media attachment paths and the cloud upload functions accept base64 data; audit the remainder of cloud-handler.js (full file truncated in the manifest) to confirm it only uploads expected user-submitted temporary files and does not read arbitrary local files. 6) Third-party packages: npm install will pull many dependencies (aliyun SDK, firebase, etc.). If supply-chain risk is a concern, review package-lock.json and consider auditing or pinning versions, or install in an isolated environment. 7) Test in an isolated workspace first: Run the skill in an isolated user/workspace with a throwaway LOVECLAW_API_TOKEN to observe exactly what files it reads, what cron changes it requests, and what it sends to the remote API. What would change this assessment - If full contents of load-workspace-env.js show no proper whitelisting, or if cloud-handler.js includes code that reads arbitrary files and uploads them to the remote API, I would raise the verdict to more strongly suspicious or malicious. - If the agent sessions file parsing exposes tokens or sensitive data beyond routing metadata, or if the backend domain is unknown/untrusted, that would increase concern. Bottom line: The skill is largely coherent with the stated purpose, but it performs several broad local operations (reading agent session files, creating cron jobs, handling local media and uploads). Those behaviors are explainable for a notification router, yet they are powerful and deserve operator review and limiting the API token scope and workspace contents before trusting the skill in production.
功能分析
Type: OpenClaw Skill Name: loveclaw Version: 21.21.21 The LoveClaw skill is a Bazi-based matching service that uses a remote Aliyun Function Compute (FC) backend. The code is well-structured and includes several security-conscious features, such as an environment variable allowlist in `load-workspace-env.js` to prevent the leakage of unrelated workspace secrets and path sanitization in `cloud-handler.js` when invoking the `openclaw` CLI for cron management. While `SKILL.md` contains strict instructions for the AI agent to act as a message relay, these are clearly intended to preserve the integrity of the multi-step registration state machine rather than to subvert the agent's security. Data handling (phone numbers, Bazi data, and photos) is consistent with the stated purpose of a matching application.
能力评估
Purpose & Capability
Name/description (dating/matching) align with required items: node/npm and a single LOVECLAW_API_TOKEN for a cloud API. Declared optional vars (LOVECLAW_API_BASE, OPENCLAW_BIN) are coherent for overriding endpoints or locating the CLI. Some local file access (session mapping, agent routes) is broader than a minimal chat-to-cloud router but is explainable by the need to resolve delivery targets and map phone→openclaw targets.
Instruction Scope
SKILL.md promises the heavy lifting occurs on the FC cloud side, but runtime scripts access several local files and system state: scripts/load-workspace-env.js reads ~/.openclaw/workspace/.env (claimed to filter keys), scripts/cloud-cron.js reads ~/.openclaw/workspace/skills/loveclaw/sessions.json and ~/.openclaw/agents/main/sessions/sessions.json to build routing tables, and scripts/cloud-handler.js contains functions to extract local media paths and calls cloud-data.uploadPhoto (which can accept base64), implying local files may be read and uploaded. The skill also instructs creating and parsing cron-run outputs and to forward message content exactly as returned by handlers. Those local reads and potential uploads are within notification/messaging scope but are safety-relevant and worth auditing.
Install Mechanism
There is no automated installer in the registry metadata; SKILL.md tells operators to run npm install. Dependencies are standard npm packages (ali-oss, aliyun-sdk, firebase, tablestore, etc.). This is a normal installation pattern but it does require pulling many third-party packages from npm — review package-lock/package.json if you need supply-chain assurance.
Credentials
The skill declares a single required secret: LOVECLAW_API_TOKEN (primaryEnv). Optional LOVECLAW_API_BASE and OPENCLAW_BIN are reasonable. The code also reads ~/.openclaw/workspace/.env via a helper that claims to whitelist keys; confirm that file contains only permitted keys and that the whitelisting logic is actually implemented in scripts/load-workspace-env.js (full contents were not shown).
Persistence & Privilege
The skill invokes the OpenClaw CLI (execFileSync openclaw ...) to add/remove cron jobs and will attempt to register a daily matching job and per-user evening-report cron entries. Creating scheduled tasks in the agent environment is a persistent side-effect and gives the skill ongoing ability to trigger actions. This behavior is explained in SKILL.md (cron templates) and matches the notification use case, but it is a higher-privilege action and should be approved explicitly by the operator.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install loveclaw
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /loveclaw 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v21.21.21
LoveClaw 21.21.21 is a streamlined update focusing on clarity, safety, and reduced complexity: - 精简并聚焦文档,移除运维面、全量风险披露与详细内部实现说明,仅强调用户可见交互与安全边界。 - 明确 skill 端仅做用户交互与推送路由,所有八字/匹配/报告逻辑均在云端服务完成,skill 端无法访问其他用户数据。 - 删除对高敏感管理密钥(如 ADMIN/ACCESS_KEY)和 deploy/ 相关内容的依赖及说明,仅保留 `LOVECLAW_API_TOKEN`。 - 环境变量严格允许名单注入,仅保留关键项。 - 保留核心安装指引、命令触发词、流程摘要和极简安全说明。
v21.13.14
rename fixed to loveclaw; bump version to 21.13.14
v13.14.0
security docs refresh; align latest behavior
v100.3.29
Update registration success copy with OpenClaw webchat fallback tip for manual 今日匹配 query.
v100.3.28
Fix ClawHub display name reset to loveclaw.
v100.3.27
Fix photo persistence and cron creation stability; improve birth-hour prompt clarity and Feishu media path parsing.
v100.3.26
Explicit slug loveclaw + display name LoveClaw; v100.3.26 (staging folder rename only affects local publish path).
v100.3.25
SKILL/README: blend v3.18-style product description (no Use when); clarify wake phrases, cron-config path, minimal ClawHub zip; accurate .env purpose note.
v100.3.24
Minimal client bundle: omit deploy/; allowlisted workspace .env (LOVECLAW_*, OPENCLAW_BIN); execFile for openclaw cron; exclude dev/e2e from published zip.
v100.3.22
docs: SKILL.md risk disclosure aligned with ClawHub Suspicious findings.
v100.3.20
调整 SKILL.md description 与 env 声明:admin token 标为可选;去掉误导 Token 文案
v100.3.19
SKILL description: 龙虾宣传文案;去掉 Use when。
v100.3.18
SKILL 列表描述:去掉「需配置 Token」误导;版本 100.3.18。
v100.3.17
README/SKILL: 安装勿改 Token、唯一唤醒词启动爱情龙虾、报名问卷日推送、同性匹配说明;SKILL frontmatter 合规;LOVECLAW_API_BASE;e2e 脚本。
v100.3.16
- Major refactor: reorganized project directories and scripts. - Added new deployment and build script folders for _fc-zipbuild, _zipwork, and _zipwork_shanghai. - Updated and expanded script files for improved deployment and simulation workflows. - Removed legacy deployment/build scripts and files. - No changes to end-user commands or functionality.
v100.3.15
Fix notifyEnabled filtering for 'true'/'false' values
v100.3.14
Update ClawHub display name to loveclaw
v100.3.13
Update OSS region defaults and expand bazi match interpretation
v100.3.12
Update OSS region handling and expand bazi match interpretation
v100.3.10
PHOTO: stay on step if missing image or upload fails; extract Feishu/URL from message; uploadPhoto 120s timeout + phone field; stricter NOTIFY yes/no. FC deploy file lives in deploy/loveclaw-fc (publish to ClawHub is skill only).
元数据
Slug loveclaw
版本 21.21.21
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 166
常见问题

LoveClaw 是什么?

LoveClaw 八字缘分匹配:云端档案、照片、每日匹配与晚间报告。 用户唤醒:发送「启动爱情龙虾」进入报名。 安全设计:匹配运算与报告生成在 FC 服务端完成;skill 端仅做用户交互与通知路由,每个用户只能访问自己的数据。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 557 次。

如何安装 LoveClaw?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install loveclaw」即可一键安装,无需额外配置。

LoveClaw 是免费的吗?

是的,LoveClaw 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

LoveClaw 支持哪些平台?

LoveClaw 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 LoveClaw?

由 jackysly88(@jackysly88)开发并维护,当前版本 v21.21.21。

💬 留言讨论