← 返回 Skills 市场
381
总下载
0
收藏
0
当前安装
25
版本数
在 OpenClaw 中安装
/install stella-selfie
功能描述
Generate persona-consistent selfie images and send to any OpenClaw channel. Supports Gemini, fal, and laozhang.ai providers, multi-reference avatar blending.
安全使用建议
What to consider before installing:
- always:true is set: ask the author why the skill must be force-included in every agent run; if there's no good reason, avoid installing or ask the registry owner to remove that flag. always:true increases the risk that the skill can be invoked autonomously and access local files.
- Credentials: the registry lists GEMINI_API_KEY, FAL_KEY, and LAOZHANG_API_KEY as required. In practice the code only needs the key for the provider you choose. Don't provision all keys unless you intend to use all providers; prefer giving the minimum-permission key for the chosen provider.
- Local file access: the skill reads ~/.openclaw/workspace/IDENTITY.md and any configured avatars directory and will base64-embed local images when sending to providers. Make sure you trust the skill and that your IDENTITY.md / avatars dir do not contain private images you don't want processed or transmitted to external APIs.
- OpenClaw CLI usage: the skill runs the OpenClaw CLI via exec to send messages. Check that your CLI is up-to-date and that you are comfortable with the skill invoking it on your behalf (sent command arguments may be visible to local process listing while running).
- Network calls: the skill calls third-party provider APIs (Gemini via @google/genai SDK, fal via SDK, and laozhang.ai REST). Verify you trust those providers and that you understand where images/metadata will be sent.
- Code provenance: the source is marked unknown and homepage points to a GitHub repo. If you plan to use it, review the repo history or prefer a version from a verified publisher. Ask the maintainer to (a) remove the always:true flag if not needed, and (b) update registry metadata to only require provider keys actually used, to reduce unnecessary credential exposure.
If you want, I can: (1) list all places the skill reads/writes files and network endpoints it contacts, (2) suggest exact metadata edits to reduce requested env vars and remove always:true, or (3) draft questions to ask the author/maintainer.
功能分析
Type: OpenClaw Skill
Name: stella-selfie
Version: 1.3.3
The skill exhibits high-risk behaviors including broad file system access to the user's workspace (~/.openclaw/workspace) and the uploading of local images to external AI providers (Google, Fal, and laozhang.ai). Furthermore, scripts/sender.ts utilizes child_process.exec to interact with the OpenClaw CLI; while it includes a shellEscape function to mitigate risks, the use of shell execution combined with external data exfiltration (even for stated purposes) and the inclusion of a third-party API proxy (api.laozhang.ai) creates a significant security surface that warrants caution.
能力评估
Purpose & Capability
Name/description, required binaries (node), and code files align with an image-generation + channel-sending skill. However the registry metadata/ SKILL.md declare three required API keys (GEMINI_API_KEY, FAL_KEY, LAOZHANG_API_KEY) while runtime logic only requires the API key for the active provider (process.env.Provider or default gemini). Declaring all three as required in metadata is overspecified and inconsistent with the actual runtime needs.
Instruction Scope
Runtime instructions and code stay within the stated purpose: assembling prompts, optionally calling timeline_resolve, reading identity/avatar data from ~/.openclaw/workspace/IDENTITY.md and an avatars directory, calling provider SDKs or REST endpoints, writing generated images to ~/.openclaw/workspace/stella-selfie, and invoking the OpenClaw CLI to send media. This file I/O (reading arbitrary files under the user's OpenClaw workspace and avatars dir) is legitimate for avatar blending but is scope-sensitive — users should be aware the skill will read those local images and identity config. The skill executes the OpenClaw CLI via child_process.exec to send messages (expected for channel delivery).
Install Mechanism
Install entries are Node packages (@google/genai and @fal-ai/client) from standard registries; no arbitrary URL downloads or extraction steps are used. This is proportional to the stated functionality.
Credentials
The skill's metadata lists three provider API keys as required, but runtime only enforces the key for the selected provider. Requiring all three keys up-front is disproportionate and may encourage unnecessary credential exposure. The skill does not request unrelated cloud credentials, but it will read files from the user's home OpenClaw workspace (IDENTITY.md, avatar images), which could contain personal data — this access is functional but should be explicit to the user.
Persistence & Privilege
The skill is published with always: true. That forces the skill to be included by default in every agent run and bypasses usual eligibility gates. There is no clear justification in SKILL.md for needing permanent inclusion; this increases blast radius because the skill can be invoked autonomously and has access to local workspace files and the OpenClaw CLI. This combination (always:true + local file access + ability to call external provider APIs) is the main security concern.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install stella-selfie - 安装完成后，直接呼叫该 Skill 的名称或使用
/stella-selfie触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.3.3
v1.3.3\n\n- feat: Implement target directory write checks in sync-local-openclaw script to ensure proper permissions before syncing\n- chore: Bump version to 1.3.2 in package.json and update documentation to emphasize stronger grounding syntax for outdoor scenes\n- chore: Bump version to 1.3.1 in package.json\n- chore: Add sync-local-openclaw script to package.json and .clawhubignore, and improve README_CN formatting for third-person photo section\n- docs: Update README and README_CN to replace "tourist photo" with "third-person photo" for consistency, and refine context completion details for sparse requests with stella-timeline-plugin integration\n- docs: Update README and README_CN to replace "travel photo" with "third-person photo" for consistency, and enhance clarity on context completion for sparse photo requests with stella-timeline-plugin integration\n- docs: Update README and README_CN to improve formatting of selfie modes and enhance clarity on reference image examples\n- docs: Update README and README_CN to clarify selfie modes and enhance character consistency with new reference image examples\n- chore: Bump version to 1.3.0 in package.json and update documentation links in README and README_CN to reflect new references structure\n- docs: Clarify user intent requirements for selfie requests in README and README_CN, enhancing context completion details with stella-timeline-plugin integration\n- docs: Enhance README and README_CN to clarify integration with stella-timeline-plugin, detailing context completion and scene continuity features for improved user experience\n- docs: Update README and SKILL.md to clarify optional timeline enrichment rules and link to detailed integration documentation\n- docs: Update README_CN.md to correct formatting of avatar configuration fields for improved readability and consistency\n- docs: Update README_CN.md to improve clarity on API key references for providers, enhancing user understanding of integration options\n- chore: Bump version to 1.2.5 in package.json and update README.md for improved clarity on provider configurations and reference image setup\n- docs: Enhance README_CN.md with detailed guidance on reference image setup and integration with stella-timeline-plugin for improved character consistency and context-aware selfies\n- chore: Refine SKILL.md to clarify usage of atmosphere hints and continuity in mode selection, enhancing prompt generation logic\n- chore: Update README_CN.md for clarity on avatar blending and provider configurations, remove protocol.md, and enhance error handling in skill.ts with new test cases\n- chore: Bump version to 1.2.4 in package.json and update documentation for laozhang.ai provider to clarify usage of local reference images\n- chore: Update .env.example to remove OPENCLAW_GATEWAY_TOKEN, reflecting recent changes in API integration and documentation
v1.3.2
v1.3.2\n\n- chore: Bump version to 1.3.1 in package.json\n- chore: Add sync-local-openclaw script to package.json and .clawhubignore, and improve README_CN formatting for third-person photo section\n- docs: Update README and README_CN to replace "tourist photo" with "third-person photo" for consistency, and refine context completion details for sparse requests with stella-timeline-plugin integration\n- docs: Update README and README_CN to replace "travel photo" with "third-person photo" for consistency, and enhance clarity on context completion for sparse photo requests with stella-timeline-plugin integration\n- docs: Update README and README_CN to improve formatting of selfie modes and enhance clarity on reference image examples\n- docs: Update README and README_CN to clarify selfie modes and enhance character consistency with new reference image examples\n- chore: Bump version to 1.3.0 in package.json and update documentation links in README and README_CN to reflect new references structure\n- docs: Clarify user intent requirements for selfie requests in README and README_CN, enhancing context completion details with stella-timeline-plugin integration\n- docs: Enhance README and README_CN to clarify integration with stella-timeline-plugin, detailing context completion and scene continuity features for improved user experience\n- docs: Update README and SKILL.md to clarify optional timeline enrichment rules and link to detailed integration documentation\n- docs: Update README_CN.md to correct formatting of avatar configuration fields for improved readability and consistency\n- docs: Update README_CN.md to improve clarity on API key references for providers, enhancing user understanding of integration options\n- chore: Bump version to 1.2.5 in package.json and update README.md for improved clarity on provider configurations and reference image setup\n- docs: Enhance README_CN.md with detailed guidance on reference image setup and integration with stella-timeline-plugin for improved character consistency and context-aware selfies\n- chore: Refine SKILL.md to clarify usage of atmosphere hints and continuity in mode selection, enhancing prompt generation logic\n- chore: Update README_CN.md for clarity on avatar blending and provider configurations, remove protocol.md, and enhance error handling in skill.ts with new test cases\n- chore: Bump version to 1.2.4 in package.json and update documentation for laozhang.ai provider to clarify usage of local reference images\n- chore: Update .env.example to remove OPENCLAW_GATEWAY_TOKEN, reflecting recent changes in API integration and documentation\n- chore: Bump version to 1.2.3 in package.json and remove gateway token and URL requirements from documentation and code, streamlining message delivery to use only the OpenClaw CLI.\n- chore: Bump version to 1.2.2 in package.json and enhance identity parsing to support additional Markdown formats in identity.ts and corresponding tests
v1.3.1
v1.3.1\n\n- chore: Add sync-local-openclaw script to package.json and .clawhubignore, and improve README_CN formatting for third-person photo section\n- docs: Update README and README_CN to replace "tourist photo" with "third-person photo" for consistency, and refine context completion details for sparse requests with stella-timeline-plugin integration\n- docs: Update README and README_CN to replace "travel photo" with "third-person photo" for consistency, and enhance clarity on context completion for sparse photo requests with stella-timeline-plugin integration\n- docs: Update README and README_CN to improve formatting of selfie modes and enhance clarity on reference image examples\n- docs: Update README and README_CN to clarify selfie modes and enhance character consistency with new reference image examples\n- chore: Bump version to 1.3.0 in package.json and update documentation links in README and README_CN to reflect new references structure\n- docs: Clarify user intent requirements for selfie requests in README and README_CN, enhancing context completion details with stella-timeline-plugin integration\n- docs: Enhance README and README_CN to clarify integration with stella-timeline-plugin, detailing context completion and scene continuity features for improved user experience\n- docs: Update README and SKILL.md to clarify optional timeline enrichment rules and link to detailed integration documentation\n- docs: Update README_CN.md to correct formatting of avatar configuration fields for improved readability and consistency\n- docs: Update README_CN.md to improve clarity on API key references for providers, enhancing user understanding of integration options\n- chore: Bump version to 1.2.5 in package.json and update README.md for improved clarity on provider configurations and reference image setup\n- docs: Enhance README_CN.md with detailed guidance on reference image setup and integration with stella-timeline-plugin for improved character consistency and context-aware selfies\n- chore: Refine SKILL.md to clarify usage of atmosphere hints and continuity in mode selection, enhancing prompt generation logic\n- chore: Update README_CN.md for clarity on avatar blending and provider configurations, remove protocol.md, and enhance error handling in skill.ts with new test cases\n- chore: Bump version to 1.2.4 in package.json and update documentation for laozhang.ai provider to clarify usage of local reference images\n- chore: Update .env.example to remove OPENCLAW_GATEWAY_TOKEN, reflecting recent changes in API integration and documentation\n- chore: Bump version to 1.2.3 in package.json and remove gateway token and URL requirements from documentation and code, streamlining message delivery to use only the OpenClaw CLI.\n- chore: Bump version to 1.2.2 in package.json and enhance identity parsing to support additional Markdown formats in identity.ts and corresponding tests\n- chore: Bump version to 1.2.1 in package.json and update README and SKILL.md for improved clarity on options and error handling
v1.3.0
v1.3.0\n\n- chore: Bump version to 1.3.0 in package.json and update documentation links in README and README_CN to reflect new references structure\n- docs: Clarify user intent requirements for selfie requests in README and README_CN, enhancing context completion details with stella-timeline-plugin integration\n- docs: Enhance README and README_CN to clarify integration with stella-timeline-plugin, detailing context completion and scene continuity features for improved user experience\n- docs: Update README and SKILL.md to clarify optional timeline enrichment rules and link to detailed integration documentation\n- docs: Update README_CN.md to correct formatting of avatar configuration fields for improved readability and consistency\n- docs: Update README_CN.md to improve clarity on API key references for providers, enhancing user understanding of integration options\n- chore: Bump version to 1.2.5 in package.json and update README.md for improved clarity on provider configurations and reference image setup\n- docs: Enhance README_CN.md with detailed guidance on reference image setup and integration with stella-timeline-plugin for improved character consistency and context-aware selfies\n- chore: Refine SKILL.md to clarify usage of atmosphere hints and continuity in mode selection, enhancing prompt generation logic\n- chore: Update README_CN.md for clarity on avatar blending and provider configurations, remove protocol.md, and enhance error handling in skill.ts with new test cases\n- chore: Bump version to 1.2.4 in package.json and update documentation for laozhang.ai provider to clarify usage of local reference images\n- chore: Update .env.example to remove OPENCLAW_GATEWAY_TOKEN, reflecting recent changes in API integration and documentation\n- chore: Bump version to 1.2.3 in package.json and remove gateway token and URL requirements from documentation and code, streamlining message delivery to use only the OpenClaw CLI.\n- chore: Bump version to 1.2.2 in package.json and enhance identity parsing to support additional Markdown formats in identity.ts and corresponding tests\n- chore: Bump version to 1.2.1 in package.json and update README and SKILL.md for improved clarity on options and error handling\n- feat: Add support for laozhang.ai provider, update documentation and error handling for new API integration\n- docs: Remove outdated documents and update README to include new protocol.md for input/output contracts and integration rules.\n- chore: Bump version to 1.1.0 in package.json and update SKILL.md to enhance mode selection logic with timeline context and explicit scene detection.\n- docs: Refine SKILL.md to clarify environment variable requirements and document external endpoints and data flow. Update tests to ensure minimal load-time requirements and proper bin extraction.\n- docs: Update README and SKILL documentation to clarify gateway rules and environment variable requirements, ensuring local gateway restrictions are emphasized. Enhance error handling in skill.ts for remote gateway configurations and add tests for validation.
v1.2.5
v1.2.5\n\n- docs: Enhance README_CN.md with detailed guidance on reference image setup and integration with stella-timeline-plugin for improved character consistency and context-aware selfies\n- chore: Refine SKILL.md to clarify usage of atmosphere hints and continuity in mode selection, enhancing prompt generation logic\n- chore: Update README_CN.md for clarity on avatar blending and provider configurations, remove protocol.md, and enhance error handling in skill.ts with new test cases\n- chore: Bump version to 1.2.4 in package.json and update documentation for laozhang.ai provider to clarify usage of local reference images\n- chore: Update .env.example to remove OPENCLAW_GATEWAY_TOKEN, reflecting recent changes in API integration and documentation\n- chore: Bump version to 1.2.3 in package.json and remove gateway token and URL requirements from documentation and code, streamlining message delivery to use only the OpenClaw CLI.\n- chore: Bump version to 1.2.2 in package.json and enhance identity parsing to support additional Markdown formats in identity.ts and corresponding tests\n- chore: Bump version to 1.2.1 in package.json and update README and SKILL.md for improved clarity on options and error handling\n- feat: Add support for laozhang.ai provider, update documentation and error handling for new API integration\n- docs: Remove outdated documents and update README to include new protocol.md for input/output contracts and integration rules.\n- chore: Bump version to 1.1.0 in package.json and update SKILL.md to enhance mode selection logic with timeline context and explicit scene detection.\n- docs: Refine SKILL.md to clarify environment variable requirements and document external endpoints and data flow. Update tests to ensure minimal load-time requirements and proper bin extraction.\n- docs: Update README and SKILL documentation to clarify gateway rules and environment variable requirements, ensuring local gateway restrictions are emphasized. Enhance error handling in skill.ts for remote gateway configurations and add tests for validation.\n- feat: Add new avatar image 1.jpg\n- feat: Implement core skill logic in `skill.ts` with comprehensive unit and metadata tests, and refine environment variable declaration in `SKILL.md`.\n- feat: Add a smoke test script for image generation and refine skill documentation and prompts.\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.
v1.2.4
v1.2.4\n\n- chore: Update .env.example to remove OPENCLAW_GATEWAY_TOKEN, reflecting recent changes in API integration and documentation\n- chore: Bump version to 1.2.3 in package.json and remove gateway token and URL requirements from documentation and code, streamlining message delivery to use only the OpenClaw CLI.\n- chore: Bump version to 1.2.2 in package.json and enhance identity parsing to support additional Markdown formats in identity.ts and corresponding tests\n- chore: Bump version to 1.2.1 in package.json and update README and SKILL.md for improved clarity on options and error handling\n- feat: Add support for laozhang.ai provider, update documentation and error handling for new API integration\n- docs: Remove outdated documents and update README to include new protocol.md for input/output contracts and integration rules.\n- chore: Bump version to 1.1.0 in package.json and update SKILL.md to enhance mode selection logic with timeline context and explicit scene detection.\n- docs: Refine SKILL.md to clarify environment variable requirements and document external endpoints and data flow. Update tests to ensure minimal load-time requirements and proper bin extraction.\n- docs: Update README and SKILL documentation to clarify gateway rules and environment variable requirements, ensuring local gateway restrictions are emphasized. Enhance error handling in skill.ts for remote gateway configurations and add tests for validation.\n- feat: Add new avatar image 1.jpg\n- feat: Implement core skill logic in `skill.ts` with comprehensive unit and metadata tests, and refine environment variable declaration in `SKILL.md`.\n- feat: Add a smoke test script for image generation and refine skill documentation and prompts.\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.
v1.2.3
v1.2.3\n\n- chore: Bump version to 1.2.2 in package.json and enhance identity parsing to support additional Markdown formats in identity.ts and corresponding tests\n- chore: Bump version to 1.2.1 in package.json and update README and SKILL.md for improved clarity on options and error handling\n- feat: Add support for laozhang.ai provider, update documentation and error handling for new API integration\n- docs: Remove outdated documents and update README to include new protocol.md for input/output contracts and integration rules.\n- chore: Bump version to 1.1.0 in package.json and update SKILL.md to enhance mode selection logic with timeline context and explicit scene detection.\n- docs: Refine SKILL.md to clarify environment variable requirements and document external endpoints and data flow. Update tests to ensure minimal load-time requirements and proper bin extraction.\n- docs: Update README and SKILL documentation to clarify gateway rules and environment variable requirements, ensuring local gateway restrictions are emphasized. Enhance error handling in skill.ts for remote gateway configurations and add tests for validation.\n- feat: Add new avatar image 1.jpg\n- feat: Implement core skill logic in `skill.ts` with comprehensive unit and metadata tests, and refine environment variable declaration in `SKILL.md`.\n- feat: Add a smoke test script for image generation and refine skill documentation and prompts.\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.
v1.2.2
v1.2.2\n\n- chore: Bump version to 1.2.1 in package.json and update README and SKILL.md for improved clarity on options and error handling\n- feat: Add support for laozhang.ai provider, update documentation and error handling for new API integration\n- docs: Remove outdated documents and update README to include new protocol.md for input/output contracts and integration rules.\n- chore: Bump version to 1.1.0 in package.json and update SKILL.md to enhance mode selection logic with timeline context and explicit scene detection.\n- docs: Refine SKILL.md to clarify environment variable requirements and document external endpoints and data flow. Update tests to ensure minimal load-time requirements and proper bin extraction.\n- docs: Update README and SKILL documentation to clarify gateway rules and environment variable requirements, ensuring local gateway restrictions are emphasized. Enhance error handling in skill.ts for remote gateway configurations and add tests for validation.\n- feat: Add new avatar image 1.jpg\n- feat: Implement core skill logic in `skill.ts` with comprehensive unit and metadata tests, and refine environment variable declaration in `SKILL.md`.\n- feat: Add a smoke test script for image generation and refine skill documentation and prompts.\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.
v1.2.1
v1.2.1\n\n- feat: Add support for laozhang.ai provider, update documentation and error handling for new API integration\n- docs: Remove outdated documents and update README to include new protocol.md for input/output contracts and integration rules.\n- chore: Bump version to 1.1.0 in package.json and update SKILL.md to enhance mode selection logic with timeline context and explicit scene detection.\n- docs: Refine SKILL.md to clarify environment variable requirements and document external endpoints and data flow. Update tests to ensure minimal load-time requirements and proper bin extraction.\n- docs: Update README and SKILL documentation to clarify gateway rules and environment variable requirements, ensuring local gateway restrictions are emphasized. Enhance error handling in skill.ts for remote gateway configurations and add tests for validation.\n- feat: Add new avatar image 1.jpg\n- feat: Implement core skill logic in `skill.ts` with comprehensive unit and metadata tests, and refine environment variable declaration in `SKILL.md`.\n- feat: Add a smoke test script for image generation and refine skill documentation and prompts.\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.
v1.2.0
v1.2.0\n\n- docs: Remove outdated documents and update README to include new protocol.md for input/output contracts and integration rules.\n- chore: Bump version to 1.1.0 in package.json and update SKILL.md to enhance mode selection logic with timeline context and explicit scene detection.\n- docs: Refine SKILL.md to clarify environment variable requirements and document external endpoints and data flow. Update tests to ensure minimal load-time requirements and proper bin extraction.\n- docs: Update README and SKILL documentation to clarify gateway rules and environment variable requirements, ensuring local gateway restrictions are emphasized. Enhance error handling in skill.ts for remote gateway configurations and add tests for validation.\n- feat: Add new avatar image 1.jpg\n- feat: Implement core skill logic in `skill.ts` with comprehensive unit and metadata tests, and refine environment variable declaration in `SKILL.md`.\n- feat: Add a smoke test script for image generation and refine skill documentation and prompts.\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.\n- Refactor .clawhubignore and .gitignore to streamline ignored files, adding coverage and documentation directories. Update smoke.ts to improve error handling for missing reference images, providing clearer guidance for users on required image formats.
v1.1.0
v1.1.0\n\n- chore: Bump version to 1.1.0 in package.json and update SKILL.md to enhance mode selection logic with timeline context and explicit scene detection.\n- docs: Refine SKILL.md to clarify environment variable requirements and document external endpoints and data flow. Update tests to ensure minimal load-time requirements and proper bin extraction.\n- docs: Update README and SKILL documentation to clarify gateway rules and environment variable requirements, ensuring local gateway restrictions are emphasized. Enhance error handling in skill.ts for remote gateway configurations and add tests for validation.\n- feat: Add new avatar image 1.jpg\n- feat: Implement core skill logic in `skill.ts` with comprehensive unit and metadata tests, and refine environment variable declaration in `SKILL.md`.\n- feat: Add a smoke test script for image generation and refine skill documentation and prompts.\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.\n- Refactor .clawhubignore and .gitignore to streamline ignored files, adding coverage and documentation directories. Update smoke.ts to improve error handling for missing reference images, providing clearer guidance for users on required image formats.\n- Enhance smoke.ts by allowing avatar maximum references to be set via environment variables, improving flexibility in configuration. Update a selfie prompt for better clarity and localization. Refactor the main function to load environment variables more efficiently.
v1.0.14
v1.0.14\n\n- docs: Update README and SKILL documentation to clarify gateway rules and environment variable requirements, ensuring local gateway restrictions are emphasized. Enhance error handling in skill.ts for remote gateway configurations and add tests for validation.\n- feat: Add new avatar image 1.jpg\n- feat: Implement core skill logic in `skill.ts` with comprehensive unit and metadata tests, and refine environment variable declaration in `SKILL.md`.\n- feat: Add a smoke test script for image generation and refine skill documentation and prompts.\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.\n- Refactor .clawhubignore and .gitignore to streamline ignored files, adding coverage and documentation directories. Update smoke.ts to improve error handling for missing reference images, providing clearer guidance for users on required image formats.\n- Enhance smoke.ts by allowing avatar maximum references to be set via environment variables, improving flexibility in configuration. Update a selfie prompt for better clarity and localization. Refactor the main function to load environment variables more efficiently.\n- Update version to 1.0.6 in package.json and enhance skill.ts with new functions for validating avatar directory configurations. Implement user guidance messages for missing or misconfigured avatar references, improving error handling and user experience. Add corresponding tests to ensure functionality and reliability.\n- Update README files to replace references to the deleted SOUL.fragment.md template with direct instructions for adding the image capability block to SOUL.md. This change enhances clarity for users on how to implement the image capability feature.
v1.0.13
v1.0.13\n\n- docs: Update README and SKILL documentation to clarify gateway rules and environment variable requirements, ensuring local gateway restrictions are emphasized. Enhance error handling in skill.ts for remote gateway configurations and add tests for validation.\n- feat: Add new avatar image 1.jpg\n- feat: Implement core skill logic in `skill.ts` with comprehensive unit and metadata tests, and refine environment variable declaration in `SKILL.md`.\n- feat: Add a smoke test script for image generation and refine skill documentation and prompts.\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.\n- Refactor .clawhubignore and .gitignore to streamline ignored files, adding coverage and documentation directories. Update smoke.ts to improve error handling for missing reference images, providing clearer guidance for users on required image formats.\n- Enhance smoke.ts by allowing avatar maximum references to be set via environment variables, improving flexibility in configuration. Update a selfie prompt for better clarity and localization. Refactor the main function to load environment variables more efficiently.\n- Update version to 1.0.6 in package.json and enhance skill.ts with new functions for validating avatar directory configurations. Implement user guidance messages for missing or misconfigured avatar references, improving error handling and user experience. Add corresponding tests to ensure functionality and reliability.\n- Update README files to replace references to the deleted SOUL.fragment.md template with direct instructions for adding the image capability block to SOUL.md. This change enhances clarity for users on how to implement the image capability feature.
v1.0.12
v1.0.12\n\n- feat: Add a smoke test script for image generation and refine skill documentation and prompts.\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.\n- Refactor .clawhubignore and .gitignore to streamline ignored files, adding coverage and documentation directories. Update smoke.ts to improve error handling for missing reference images, providing clearer guidance for users on required image formats.\n- Enhance smoke.ts by allowing avatar maximum references to be set via environment variables, improving flexibility in configuration. Update a selfie prompt for better clarity and localization. Refactor the main function to load environment variables more efficiently.\n- Update version to 1.0.6 in package.json and enhance skill.ts with new functions for validating avatar directory configurations. Implement user guidance messages for missing or misconfigured avatar references, improving error handling and user experience. Add corresponding tests to ensure functionality and reliability.\n- Update README files to replace references to the deleted SOUL.fragment.md template with direct instructions for adding the image capability block to SOUL.md. This change enhances clarity for users on how to implement the image capability feature.\n- Update prompts in smoke.ts for improved clarity and localization, replacing beach and café prompts with a new selfie prompt in Chinese.\n- Update version to 1.0.5 in package.json to reflect the latest release.\n- Enhance error normalization in Stella by introducing new context interfaces for improved error handling. Refactor the normalizeGeminiError function to utilize a structured context, streamlining error categorization and messaging. This update improves clarity and maintainability of error responses for various failure scenarios.
v1.0.11
v1.0.11\n\n- docs: Add Stella protocol documentation.\n- Enhance README documentation by adding a new "Protocol" section that outlines the final I/O contract for `stella-selfie` (v1) in both English and Chinese versions.\n- Update version to 1.0.10 in package.json, add node install specifications for @google/genai and @fal-ai/client in SKILL.md, and enhance release-clawhub script to check for missing runtime entrypoint. Add tests to verify node install specs in skill-metadata.test.ts.\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.\n- Refactor .clawhubignore and .gitignore to streamline ignored files, adding coverage and documentation directories. Update smoke.ts to improve error handling for missing reference images, providing clearer guidance for users on required image formats.\n- Enhance smoke.ts by allowing avatar maximum references to be set via environment variables, improving flexibility in configuration. Update a selfie prompt for better clarity and localization. Refactor the main function to load environment variables more efficiently.\n- Update version to 1.0.6 in package.json and enhance skill.ts with new functions for validating avatar directory configurations. Implement user guidance messages for missing or misconfigured avatar references, improving error handling and user experience. Add corresponding tests to ensure functionality and reliability.\n- Update README files to replace references to the deleted SOUL.fragment.md template with direct instructions for adding the image capability block to SOUL.md. This change enhances clarity for users on how to implement the image capability feature.\n- Update prompts in smoke.ts for improved clarity and localization, replacing beach and café prompts with a new selfie prompt in Chinese.\n- Update version to 1.0.5 in package.json to reflect the latest release.\n- Enhance error normalization in Stella by introducing new context interfaces for improved error handling. Refactor the normalizeGeminiError function to utilize a structured context, streamlining error categorization and messaging. This update improves clarity and maintainability of error responses for various failure scenarios.\n- Refactor error handling in Stella to improve failure notifications and retry logic for transient network issues. Update README files to clarify user experience during generation failures. Enhance tests to ensure proper error mapping and notification behavior.
v1.0.10
v1.0.10\n\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.\n- Refactor .clawhubignore and .gitignore to streamline ignored files, adding coverage and documentation directories. Update smoke.ts to improve error handling for missing reference images, providing clearer guidance for users on required image formats.\n- Enhance smoke.ts by allowing avatar maximum references to be set via environment variables, improving flexibility in configuration. Update a selfie prompt for better clarity and localization. Refactor the main function to load environment variables more efficiently.\n- Update version to 1.0.6 in package.json and enhance skill.ts with new functions for validating avatar directory configurations. Implement user guidance messages for missing or misconfigured avatar references, improving error handling and user experience. Add corresponding tests to ensure functionality and reliability.\n- Update README files to replace references to the deleted SOUL.fragment.md template with direct instructions for adding the image capability block to SOUL.md. This change enhances clarity for users on how to implement the image capability feature.\n- Update prompts in smoke.ts for improved clarity and localization, replacing beach and café prompts with a new selfie prompt in Chinese.\n- Update version to 1.0.5 in package.json to reflect the latest release.\n- Enhance error normalization in Stella by introducing new context interfaces for improved error handling. Refactor the normalizeGeminiError function to utilize a structured context, streamlining error categorization and messaging. This update improves clarity and maintainability of error responses for various failure scenarios.\n- Refactor error handling in Stella to improve failure notifications and retry logic for transient network issues. Update README files to clarify user experience during generation failures. Enhance tests to ensure proper error mapping and notification behavior.\n- Enhance error handling and messaging in Stella by implementing concise failure notifications for generation errors. Update the sendImage function to send messages without media, and refactor related scripts for improved clarity and functionality. Add retry logic for transient errors in the fal and gemini providers, ensuring robust error management. Update documentation to reflect these changes and clarify testing procedures.\n- Update version to 1.0.4 in package.json and enhance README files with best practices for reference photo consistency, including recommendations on image quantity, size, cropping, and distractions.\n- Remove AvatarMaxRefs configuration from IDENTITY.md and related scripts, updating documentation to reflect this change. Clarify that the maximum number of reference images is now set via skill environment configuration. Adjust tests accordingly to ensure consistency with the new implementation.
v1.0.9
v1.0.9\n\n- Update .clawhubignore to reflect new shipped files and modify usage instructions in skill.ts to run the compiled script. Add tests in skill.test.ts for missing FAL_KEY and invalid OPENCLAW_GATEWAY_URL to ensure robust error handling.\n- Update version to 1.0.9 in package.json. Add build script to package.json and enhance README documentation with credential rules and security notes. Improve error handling in skill.ts for missing provider credentials and gateway configuration. Add tests for credential validation and error handling in skill.test.ts.\n- Refactor SKILL.md to improve table formatting for mode selection and resolution keywords. Update instructions for adding the Stella capability block to SOUL.md for better clarity. Enhance overall readability and organization of the document.\n- Update version to 1.0.8 in package.json. Enhance README and SKILL documentation with details on media file handling for the Gemini provider, including file cleanup procedures and error handling. Add tests to ensure proper functionality of file management and cleanup processes.\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.\n- Refactor .clawhubignore and .gitignore to streamline ignored files, adding coverage and documentation directories. Update smoke.ts to improve error handling for missing reference images, providing clearer guidance for users on required image formats.\n- Enhance smoke.ts by allowing avatar maximum references to be set via environment variables, improving flexibility in configuration. Update a selfie prompt for better clarity and localization. Refactor the main function to load environment variables more efficiently.\n- Update version to 1.0.6 in package.json and enhance skill.ts with new functions for validating avatar directory configurations. Implement user guidance messages for missing or misconfigured avatar references, improving error handling and user experience. Add corresponding tests to ensure functionality and reliability.\n- Update README files to replace references to the deleted SOUL.fragment.md template with direct instructions for adding the image capability block to SOUL.md. This change enhances clarity for users on how to implement the image capability feature.\n- Update prompts in smoke.ts for improved clarity and localization, replacing beach and café prompts with a new selfie prompt in Chinese.\n- Update version to 1.0.5 in package.json to reflect the latest release.\n- Enhance error normalization in Stella by introducing new context interfaces for improved error handling. Refactor the normalizeGeminiError function to utilize a structured context, streamlining error categorization and messaging. This update improves clarity and maintainability of error responses for various failure scenarios.\n- Refactor error handling in Stella to improve failure notifications and retry logic for transient network issues. Update README files to clarify user experience during generation failures. Enhance tests to ensure proper error mapping and notification behavior.\n- Enhance error handling and messaging in Stella by implementing concise failure notifications for generation errors. Update the sendImage function to send messages without media, and refactor related scripts for improved clarity and functionality. Add retry logic for transient errors in the fal and gemini providers, ensuring robust error management. Update documentation to reflect these changes and clarify testing procedures.\n- Update version to 1.0.4 in package.json and enhance README files with best practices for reference photo consistency, including recommendations on image quantity, size, cropping, and distractions.\n- Remove AvatarMaxRefs configuration from IDENTITY.md and related scripts, updating documentation to reflect this change. Clarify that the maximum number of reference images is now set via skill environment configuration. Adjust tests accordingly to ensure consistency with the new implementation.
v1.0.8
v1.0.8\n\n- Implement cleanup for generated files in skill.ts and update gemini.ts to use a dedicated directory for selfies. Enhance error handling for file removal failures.\n- Update version to 1.0.7 in package.json. Modify release-clawhub script to pin workdir to the repo root, preventing publish errors. Update avatar image 0.png in smoke/avatars directory.\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.\n- Refactor .clawhubignore and .gitignore to streamline ignored files, adding coverage and documentation directories. Update smoke.ts to improve error handling for missing reference images, providing clearer guidance for users on required image formats.\n- Enhance smoke.ts by allowing avatar maximum references to be set via environment variables, improving flexibility in configuration. Update a selfie prompt for better clarity and localization. Refactor the main function to load environment variables more efficiently.\n- Update version to 1.0.6 in package.json and enhance skill.ts with new functions for validating avatar directory configurations. Implement user guidance messages for missing or misconfigured avatar references, improving error handling and user experience. Add corresponding tests to ensure functionality and reliability.\n- Update README files to replace references to the deleted SOUL.fragment.md template with direct instructions for adding the image capability block to SOUL.md. This change enhances clarity for users on how to implement the image capability feature.\n- Update prompts in smoke.ts for improved clarity and localization, replacing beach and café prompts with a new selfie prompt in Chinese.\n- Update version to 1.0.5 in package.json to reflect the latest release.\n- Enhance error normalization in Stella by introducing new context interfaces for improved error handling. Refactor the normalizeGeminiError function to utilize a structured context, streamlining error categorization and messaging. This update improves clarity and maintainability of error responses for various failure scenarios.\n- Refactor error handling in Stella to improve failure notifications and retry logic for transient network issues. Update README files to clarify user experience during generation failures. Enhance tests to ensure proper error mapping and notification behavior.\n- Enhance error handling and messaging in Stella by implementing concise failure notifications for generation errors. Update the sendImage function to send messages without media, and refactor related scripts for improved clarity and functionality. Add retry logic for transient errors in the fal and gemini providers, ensuring robust error management. Update documentation to reflect these changes and clarify testing procedures.\n- Update version to 1.0.4 in package.json and enhance README files with best practices for reference photo consistency, including recommendations on image quantity, size, cropping, and distractions.\n- Remove AvatarMaxRefs configuration from IDENTITY.md and related scripts, updating documentation to reflect this change. Clarify that the maximum number of reference images is now set via skill environment configuration. Adjust tests accordingly to ensure consistency with the new implementation.\n- Update README and SKILL documentation to clarify avatar blending options and remove reference to deleted IDENTITY.fragment.md template. Adjust instructions for configuring IDENTITY.md and streamline user guidance for the Stella skill.\n- Update README files to reflect script renaming and restructuring, including the addition of smoke testing and ClawHub publishing scripts. Enhance clarity on file organization and unit testing for providers.\n- Enhance Windows compatibility in release script by adding quoting for command arguments and adjusting shell execution logic.\n- Refactor release script to use fileURLToPath for improved path resolution
v1.0.7
v1.0.7\n\n- Refactor smoke.ts for improved readability and localization. Update avatar prompts and enhance error handling for unsupported providers. Remove unused avatar images 0.jpg and 2.jpg from the smoke/avatars directory to streamline assets.\n- Remove unused avatar images 1.jpg and 3.jpg from the smoke/avatars directory to clean up the project and reduce clutter.\n- Enhance smoke.ts to support a new image generation provider, 'fal', alongside 'gemini'. Update argument parsing to include fal-specific avatar URLs and improve error handling for missing URLs. Refactor smoke test execution to accommodate both providers, ensuring clearer user guidance on configuration requirements.\n- Refactor .clawhubignore and .gitignore to streamline ignored files, adding coverage and documentation directories. Update smoke.ts to improve error handling for missing reference images, providing clearer guidance for users on required image formats.\n- Enhance smoke.ts by allowing avatar maximum references to be set via environment variables, improving flexibility in configuration. Update a selfie prompt for better clarity and localization. Refactor the main function to load environment variables more efficiently.\n- Update version to 1.0.6 in package.json and enhance skill.ts with new functions for validating avatar directory configurations. Implement user guidance messages for missing or misconfigured avatar references, improving error handling and user experience. Add corresponding tests to ensure functionality and reliability.\n- Update README files to replace references to the deleted SOUL.fragment.md template with direct instructions for adding the image capability block to SOUL.md. This change enhances clarity for users on how to implement the image capability feature.\n- Update prompts in smoke.ts for improved clarity and localization, replacing beach and café prompts with a new selfie prompt in Chinese.\n- Update version to 1.0.5 in package.json to reflect the latest release.\n- Enhance error normalization in Stella by introducing new context interfaces for improved error handling. Refactor the normalizeGeminiError function to utilize a structured context, streamlining error categorization and messaging. This update improves clarity and maintainability of error responses for various failure scenarios.\n- Refactor error handling in Stella to improve failure notifications and retry logic for transient network issues. Update README files to clarify user experience during generation failures. Enhance tests to ensure proper error mapping and notification behavior.\n- Enhance error handling and messaging in Stella by implementing concise failure notifications for generation errors. Update the sendImage function to send messages without media, and refactor related scripts for improved clarity and functionality. Add retry logic for transient errors in the fal and gemini providers, ensuring robust error management. Update documentation to reflect these changes and clarify testing procedures.\n- Update version to 1.0.4 in package.json and enhance README files with best practices for reference photo consistency, including recommendations on image quantity, size, cropping, and distractions.\n- Remove AvatarMaxRefs configuration from IDENTITY.md and related scripts, updating documentation to reflect this change. Clarify that the maximum number of reference images is now set via skill environment configuration. Adjust tests accordingly to ensure consistency with the new implementation.\n- Update README and SKILL documentation to clarify avatar blending options and remove reference to deleted IDENTITY.fragment.md template. Adjust instructions for configuring IDENTITY.md and streamline user guidance for the Stella skill.\n- Update README files to reflect script renaming and restructuring, including the addition of smoke testing and ClawHub publishing scripts. Enhance clarity on file organization and unit testing for providers.\n- Enhance Windows compatibility in release script by adding quoting for command arguments and adjusting shell execution logic.\n- Refactor release script to use fileURLToPath for improved path resolution\n- Add release script for Clawhub to package.json\n- Update version to 1.0.3 in package.json and revise SOUL.md instructions for clarity on copying the Stella capability block from the template.
v1.0.6
v1.0.6\n\n- Update version to 1.0.6 in package.json and enhance skill.ts with new functions for validating avatar directory configurations. Implement user guidance messages for missing or misconfigured avatar references, improving error handling and user experience. Add corresponding tests to ensure functionality and reliability.\n- Update README files to replace references to the deleted SOUL.fragment.md template with direct instructions for adding the image capability block to SOUL.md. This change enhances clarity for users on how to implement the image capability feature.\n- Update prompts in smoke.ts for improved clarity and localization, replacing beach and café prompts with a new selfie prompt in Chinese.\n- Update version to 1.0.5 in package.json to reflect the latest release.\n- Enhance error normalization in Stella by introducing new context interfaces for improved error handling. Refactor the normalizeGeminiError function to utilize a structured context, streamlining error categorization and messaging. This update improves clarity and maintainability of error responses for various failure scenarios.\n- Refactor error handling in Stella to improve failure notifications and retry logic for transient network issues. Update README files to clarify user experience during generation failures. Enhance tests to ensure proper error mapping and notification behavior.\n- Enhance error handling and messaging in Stella by implementing concise failure notifications for generation errors. Update the sendImage function to send messages without media, and refactor related scripts for improved clarity and functionality. Add retry logic for transient errors in the fal and gemini providers, ensuring robust error management. Update documentation to reflect these changes and clarify testing procedures.\n- Update version to 1.0.4 in package.json and enhance README files with best practices for reference photo consistency, including recommendations on image quantity, size, cropping, and distractions.\n- Remove AvatarMaxRefs configuration from IDENTITY.md and related scripts, updating documentation to reflect this change. Clarify that the maximum number of reference images is now set via skill environment configuration. Adjust tests accordingly to ensure consistency with the new implementation.\n- Update README and SKILL documentation to clarify avatar blending options and remove reference to deleted IDENTITY.fragment.md template. Adjust instructions for configuring IDENTITY.md and streamline user guidance for the Stella skill.\n- Update README files to reflect script renaming and restructuring, including the addition of smoke testing and ClawHub publishing scripts. Enhance clarity on file organization and unit testing for providers.\n- Enhance Windows compatibility in release script by adding quoting for command arguments and adjusting shell execution logic.\n- Refactor release script to use fileURLToPath for improved path resolution\n- Add release script for Clawhub to package.json\n- Update version to 1.0.3 in package.json and revise SOUL.md instructions for clarity on copying the Stella capability block from the template.\n- Refactor SOUL.fragment.md to enhance clarity and structure for image capability instructions. Consolidate sections, update prompt templates, and specify resolution keywords for improved user guidance.\n- Update avatar selection to use POSIX-style paths for consistent cross-platform behavior.\n- Add toPosixPath function to normalize file paths and update avatar selection to use it for consistent path handling across platforms.\n- Update version to 1.0.1, replace stella.ts script with smoke test command in README, and enhance Gemini provider error handling with retry logic for transient API failures.\n- Revise README to enhance clarity on OpenClaw configuration for the Stella skill. Update section headings, consolidate environment variable instructions, and improve sandbox usage notes. Adjust the order of configuration steps for better flow.
元数据
常见问题
Stella Selfie 是什么？
Generate persona-consistent selfie images and send to any OpenClaw channel. Supports Gemini, fal, and laozhang.ai providers, multi-reference avatar blending. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 381 次。
如何安装 Stella Selfie？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install stella-selfie」即可一键安装，无需额外配置。
Stella Selfie 是免费的吗？
是的，Stella Selfie 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Stella Selfie 支持哪些平台？
Stella Selfie 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Stella Selfie？
由 🦄9527（@tower1229）开发并维护，当前版本 v1.3.3。
推荐 Skills