- name
- shared-memory
- description
- Share memories and state with other users. Use when user wants to share knowledge, create users/groups, grant permissions, set up family or team sharing, subscribe to memory changes, or manage access control on their memory knowledge base. This shared memory skill uses Ensue - a shared memory network for agents.
- metadata
- clawdbot
- emoji
- 🤝
- requires
- env
- primaryEnv
- ENSUE_API_KEY
- homepage
- https://ensue-network.ai
Shared Memory
Share memories from your knowledge base with other users. Manage users, groups, and fine-grained permissions on namespaces.
Quick Start
# Create user and group
{baseDir}/scripts/shared-memory.sh create-user mark
{baseDir}/scripts/shared-memory.sh create-group family
{baseDir}/scripts/shared-memory.sh add-member family mark
# Grant access
{baseDir}/scripts/shared-memory.sh grant group family read christine/shared/
{baseDir}/scripts/shared-memory.sh grant group family update christine/shared/Namespace Organization
<username>/
├── private/ # Only this user
├── shared/ # Shared with others
└── public/ # Read-only to othersGrant access to mark/shared/ → all shared content Grant access to mark/shared/recipes/ → just recipes
Commands
Users
| Command | Description |
|---|---|
create-user <username> | Create user |
delete-user <username> | Delete user |
Groups
| Command | Description |
|---|---|
create-group <name> | Create group |
delete-group <name> | Delete group |
add-member <group> <user> | Add user to group |
remove-member <group> <user> | Remove user |
Permissions
| Command | Description |
|---|---|
grant org <action> <pattern> | Grant to org |
grant user <name> <action> <pattern> | Grant to user |
grant group <name> <action> <pattern> | Grant to group |
revoke <grant_id> | Revoke permission |
list | List all grants |
list-permissions | List effective permissions |
Actions: read, create, update, delete
Subscriptions
| Command | Description |
|---|---|
subscribe <key> | Get notified on changes |
unsubscribe <key> | Stop notifications |
list-subscriptions | List subscriptions |
Example: Family Sharing
# Create user for partner
{baseDir}/scripts/shared-memory.sh create-user mark
# Create family group
{baseDir}/scripts/shared-memory.sh create-group family
{baseDir}/scripts/shared-memory.sh add-member family mark
# Grant mutual access to shared/ namespaces
{baseDir}/scripts/shared-memory.sh grant group family read christine/shared/
{baseDir}/scripts/shared-memory.sh grant group family create christine/shared/
{baseDir}/scripts/shared-memory.sh grant group family update christine/shared/
{baseDir}/scripts/shared-memory.sh grant group family read mark/shared/
{baseDir}/scripts/shared-memory.sh grant group family update mark/shared/Troubleshooting
If commands fail, first check if an Ensue API key is configured:
echo $ENSUE_API_KEY
grep -A2 'ensue-learning-memory' ~/.clawdbot/clawdbot.jsonIf no API key found, tell user to get a free key at https://www.ensue-network.ai/login and configure in ~/.clawdbot/clawdbot.json:
{
"skills": {
"entries": {
"ensue-learning-memory": {
"apiKey": "their-api-key-here"
}
}
}
}If key exists but commands fail, the key may be invalid - have user generate a new one.