← 返回 Skills 市场
105
总下载
1
收藏
1
当前安装
7
版本数
在 OpenClaw 中安装
/install sam-faces
功能描述
Face recognition and identity memory for AI assistants. Enroll known people with reference photos, then automatically identify faces in inbound images — with...
安全使用建议
Before installing or enabling this skill, consider the following:
- Review the sam-faces PyPI project and source code before pip installing (pip packages can run arbitrary code at install and runtime).
- Understand where face data will be stored on disk (the SKILL.md references {workspaceDir}/faces/) and ensure that location is acceptable and secured; the skill does not declare or request these paths explicitly.
- The skill's inference is local, but it instructs the agent to prepend identified names into LLM prompts (llm_context). If your assistant uses remote LLM APIs, that will transmit personally identifiable information to third parties — disable automatic injection or require explicit user consent per image.
- If you need stricter privacy, require explicit user confirmation before identification or enrollment and audit what is being sent to models or external services.
- If you proceed, install only on trusted devices, limit filesystem access to a dedicated workspace, and consider legal/privacy implications of storing and processing biometric identifiers in your jurisdiction.
功能分析
Type: OpenClaw Skill
Name: sam-faces
Version: 1.1.0
The sam-faces skill provides local face recognition and identity management using a PyPI package. The SKILL.md file contains standard instructions for the AI agent to automatically identify faces in images and manage a local database (people.db) without external API calls. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
能力评估
Purpose & Capability
Name and description match the required binary (sam-faces) and CLI invocations. Asking for a sam-faces binary is coherent for face recognition. However, the skill references a workspaceDir and persistent databases for encodings without declaring any required config/path or permissions; that is an unstated requirement.
Instruction Scope
Runtime instructions tell the agent to automatically identify faces when users send images and to prepend the produced llm_context (names, confidences, positions) into image descriptions used for LLM prompts. That creates a clear privacy/exfiltration vector: even though inference is local, identity data would be injected into LLM prompts which may be sent to remote model APIs. Instructions also assume the agent can write temp files and to {workspaceDir}/faces/ — the skill does not declare or request explicit file-paths or permissions.
Install Mechanism
The registry lists no install spec, but SKILL.md includes a pip install suggestion (pip package 'sam-faces'). Installing from PyPI is plausible for this tool, but pip installs run arbitrary package install scripts. The absence of an explicit registry-level install spec plus the instruction-only nature means installers may not automatically vet or run that install; users should review the PyPI package source before installing.
Credentials
No environment variables or credentials are requested (which is appropriate). However, the skill stores face encodings and unknown face crops on-disk ({workspaceDir}/faces/people.db and /faces/unknown/) yet doesn't declare or require a workspace path or explicit file permissions. The combination of stored identities plus the instruction to include identities in LLM context is disproportionate without explicit safeguards or consent controls.
Persistence & Privilege
always:false (no forced always-on presence) and autonomous invocation is allowed by default. Autonomous invocation plus automatic face ID behavior is potentially risky: the agent could insert PII into prompts without additional per-message consent. This is not a configuration bug by itself, but it amplifies privacy risk and should be managed via user-facing controls (e.g., opt-in, per-image consent).
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install sam-faces - 安装完成后,直接呼叫该 Skill 的名称或使用
/sam-faces触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.0
Add visualize command for drawing bounding boxes and name labels on detected faces
v1.0.5
Add visualize command to documentation (README + SKILL.md)
v1.0.4
Remove accidentally restored setup.sh script, keep only pip install
v1.0.3
Add threshold tuning reference guide and setup script
v1.0.2
Fix JSON output example in docs to match actual CLI output
v1.0.1
Fix privacy framing and remove stale setup.sh script
v1.0.0
Initial ClawHub release — face recognition and identity memory for OpenClaw agents
元数据
常见问题
sam-faces 是什么?
Face recognition and identity memory for AI assistants. Enroll known people with reference photos, then automatically identify faces in inbound images — with... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 105 次。
如何安装 sam-faces?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install sam-faces」即可一键安装,无需额外配置。
sam-faces 是免费的吗?
是的,sam-faces 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
sam-faces 支持哪些平台?
sam-faces 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 sam-faces?
由 Sam Cox(@jasonacox-sam)开发并维护,当前版本 v1.1.0。
推荐 Skills