← Back to Skills Marketplace
534
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install usememos-api
Description
Interact with UseMemos instance — a lightweight, self-hosted memo hub. Create, search, list memos and upload attachments.
Usage Guidance
This skill appears to be a straightforward client for a UseMemos instance. Before installing: (1) ensure you point USEMEMOS_URL to a trusted UseMemos server; (2) treat USEMEMOS_TOKEN as a secret — storing it in skills/usememos/.env is plaintext, so use file permissions or a short-lived token where possible and rotate tokens regularly; (3) the upload scripts will transmit any file path you pass them to the configured server, so avoid calling them (or allow the agent to call them) with sensitive local file paths; (4) if you are concerned about autonomous agent behavior, restrict or disable autonomous invocation for agents with broad local filesystem access or use a token with limited scope/expiration.
Capability Analysis
Type: OpenClaw Skill
Name: usememos-api
Version: 1.0.3
The usememos-api skill is a legitimate integration for the UseMemos self-hosted note-taking platform. It provides a suite of Python scripts (e.g., create_memo.py, upload_attachment.py) that use the standard library to perform CRUD operations via the UseMemos REST API. The code is well-documented, includes integration tests, and handles authentication securely through environment variables without any evidence of malicious intent, data exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
Name/description match the included scripts and API reference. Required binaries (python3) and required env vars (USEMEMOS_URL, USEMEMOS_TOKEN) are exactly what a UseMemos client needs.
Instruction Scope
SKILL.md and scripts are focused on UseMemos API calls (create/list/search memos, upload/link attachments, comments). The scripts auto-load a .env from the skill directory, and the upload scripts read arbitrary file paths you pass and POST their base64 content to the configured USEMEMOS_URL. That's expected for an 'upload' feature, but it means the skill can be used to transmit any local file you tell it to — be cautious about giving it access to sensitive files.
Install Mechanism
Instruction-only skill with included Python scripts; there is no package download or extract step. No external install URLs or third-party package installs present.
Credentials
Only USEMEMOS_URL and USEMEMOS_TOKEN are required and the primaryEnv is USEMEMOS_TOKEN — this is proportional. Note: the recommended setup stores the token in a plaintext .env file inside the skill directory (loaded automatically), so token storage and file permissions are worth reviewing.
Persistence & Privilege
always is false and the skill does not request system-wide privileges or modify other skill configurations. It runs as a normal, user-invokable skill and only requires standard runtime presence (python3).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install usememos-api - After installation, invoke the skill by name or use
/usememos-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Added scripts/load_env.py to automatically load environment variables from a .env file in the skill directory.
- Updated setup instructions: scripts now read environment variables from the .env file; manual export is no longer required.
- Revised documentation for improved clarity on configuration and token setup.
- Minor improvements in usage notes.
v1.0.2
- Added memo comment management support with the new script `memo_comments.py`.
- You can now list, add, and delete comments on memos via the command line.
v1.0.1
### Fixed
- **Attachment linking bug**: uploading multiple images to a memo replaced all
previous attachments instead of appending — only the last image survived.
The PATCH now fetches existing attachments first and appends the new one.
### Added
- Integration tests for image uploads (1 PNG, 2 PNGs, 1 JPG, 3 JPGs) that
run against a live UseMemos instance using the actual scripts
- `package.sh` script for packaging the skill for clawhub.ai publishing
v1.0.0
Initial release — create, search, list memos and upload attachments via UseMemos API
Metadata
Frequently Asked Questions
What is UseMemos?
Interact with UseMemos instance — a lightweight, self-hosted memo hub. Create, search, list memos and upload attachments. It is an AI Agent Skill for Claude Code / OpenClaw, with 534 downloads so far.
How do I install UseMemos?
Run "/install usememos-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is UseMemos free?
Yes, UseMemos is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does UseMemos support?
UseMemos is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created UseMemos?
It is built and maintained by Minde (@minstn); the current version is v1.0.3.
More Skills