SKILL.md for the Memos skill

Purpose

This skill provides a simple interface to the Memos API (https://usememos.com/docs/api). It lets you create, read, delete, and list memos from OpenClaw.

How it works

The skill is implemented in Python and uses the
```
requests
```
library.
It requires two environment variables:
- ```
MEMOS_URL
```
  – REQUIRED. Base URL of your Memos instance (e.g.,
```
https://demo.usememos.com
```
  ).
- ```
MEMOS_TOKEN
```
  – REQUIRED. Personal access token for authentication.
If either
```
MEMOS_URL
```
or
```
MEMOS_TOKEN
```
is not set, the skill will abort with a clear error.

Commands

Command	Description	Usage example
`create <content> [visibility]`	Create a new memo. `visibility` defaults to `PUBLIC` (options: PRIVATE, PROTECTED, PUBLIC). The tag `#openclaw` is appended automatically.	`openclaw skill-run create "Hello world" "PUBLIC"`
`get <id>`	Retrieve a memo by its ID. ID can be in format `memos/123` or just `123` .	`openclaw skill-run get 123`
`delete <id> [force]`	Delete a memo. Optional `force` (true/false) will delete even if it has associated data.	`openclaw skill-run delete 123 true`
`list [pageSize]`	List memos with pagination. `pageSize` defaults to 20 (max 1000).	`openclaw skill-run list 50`

Direct Python Usage

You can also run the commands directly with Python:

# Create a memo
python3 skills/memos/memos.py create "My memo content" "PUBLIC"
Get a memo by ID
python3 skills/memos/memos.py get j9THXDmYtueosTTeHcC5NA
Delete a memo
python3 skills/memos/memos.py delete j9THXDmYtueosTTeHcC5NA
Delete with force
python3 skills/memos/memos.py delete j9THXDmYtueosTTeHcC5NA true
List memos (default 20)
python3 skills/memos/memos.py list
List with custom page size

python3 skills/memos/memos.py list 50

All commands return JSON output on success and JSON error messages on stderr when errors occur.

Referencing Memos in OpenClaw

When you create or retrieve a memo, the API returns a memo object with a

uid

field. To reference a memo in OpenClaw's output, format it as a markdown link:

[memo description](https://demo.usememos.com/memos/{uid})

Example: If the API returns

{"uid": "ABC123xyz", "name": "memos/ABC123xyz", ...}

, reference it as:

Created [your memo](https://demo.usememos.com/memos/ABC123xyz)

The URL format is:

{MEMOS_URL}/memos/{uid}

where

uid

is extracted from the response.

Error handling

The skill includes comprehensive error handling:

API Errors: Returns detailed error messages including HTTP status codes and API response details
Network Errors: Handles timeouts (30s default) and connection failures
Validation: Validates parameters before making API calls (e.g., visibility options, pageSize range)
Exit codes: Returns 0 on success, 1 on error when run from command line
Error output: All errors are output as JSON to stderr for easy parsing

Example error responses:

{
  "error": "Memos API Error",
  "message": "HTTP 404: Not Found - Memo not found",
  "status_code": 404
}

Extending the skill

Add new commands by following the pattern of existing ones.
If the Memos API adds new endpoints, you can create corresponding functions.

NOTE: This skill is meant for personal use; never share your

MEMOS_TOKEN

publicly.

Memos

AI Skill Market Insights

Be Part of the 0+ Developer Community

SKILL.md for the Memos skill

Purpose

How it works

Commands

Direct Python Usage

Get a memo by ID

Delete a memo

Delete with force

List memos (default 20)

List with custom page size

Referencing Memos in OpenClaw

Error handling

Extending the skill

Quick Start

Manual Installation

TEAR & SHARE

Tags

writing-plans

executing-plans

plan-ceo-review

Office Automation

Todo Manager

Channels

Learn

Compare

Company