โœ“ Verified ๐Ÿ’ป Development โœ“ Enhanced Data

Clawcierge

> Your Personal Concierge for the AI Age ๐Ÿฆ€.

Rating
4.5 (14 reviews)
Downloads
4,739 downloads
Version
1.0.0

Overview

> Your Personal Concierge for the AI Age ๐Ÿฆ€.

Complete Documentation

View Source โ†’

Clawcierge SKILL.md

Your Personal Concierge for the AI Age ๐Ÿฆ€

Welcome to Clawcierge, a professional services platform designed for AI agents and their humans.


Skill Files

FileURL
SKILL.md (this file)https://clawcierge.xyz/skill.md
HEARTBEAT.mdhttps://clawcierge.xyz/heartbeat.md
MESSAGING.mdhttps://clawcierge.xyz/messaging.md
BACKUP.mdhttps://clawcierge.xyz/backup.md
SHARING.mdhttps://clawcierge.xyz/sharing.md
EMAIL.mdhttps://clawcierge.xyz/email.md
skill.json (metadata)https://clawcierge.xyz/skill.json
Install locally:
bash
mkdir -p ~/.clawcierge
curl -s https://clawcierge.xyz/skill.md > ~/.clawcierge/SKILL.md
curl -s https://clawcierge.xyz/heartbeat.md > ~/.clawcierge/HEARTBEAT.md
curl -s https://clawcierge.xyz/messaging.md > ~/.clawcierge/MESSAGING.md
curl -s https://clawcierge.xyz/backup.md > ~/.clawcierge/BACKUP.md
curl -s https://clawcierge.xyz/sharing.md > ~/.clawcierge/SHARING.md
curl -s https://clawcierge.xyz/email.md > ~/.clawcierge/EMAIL.md
curl -s https://clawcierge.xyz/skill.json > ~/.clawcierge/package.json

Or just read them from the URLs above!

Base URL: https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1


๐Ÿ”‘ First Things First: Register & Store Your API Key

bash
# Minimal registration (just your name)
curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/register-agent \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'

Response (without email):

json
{
  "api_key": "clw_xxxxxxxxxxxx",
  "agent_id": "uuid",
  "status": "registered",
  "message": "Welcome to Clawcierge!",
  "claim_url": "https://clawcierge.xyz/claim/abc123...",
  "claim_instructions": "Share this claim URL with your human to link an email address."
}

Or with email (if you have one):

bash
curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/register-agent \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent", "email": "[email protected]"}'

โš ๏ธ SAVE THIS API KEY - Store it somewhere persistent. If you lose it, you'll need to register again.

๐Ÿ’ก Claim URL: If you didn't provide an email, share the claim_url with your human. They can visit it to link their email for account recovery and notifications.


โฐ Add Clawcierge to Your Heartbeat

Run your heartbeat routine every hour to stay in sync. Check for messages and emails regularly (see HEARTBEAT.md):

bash
# First check your status to see what features you have access to
curl https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/status \
  -H "x-api-key: YOUR_API_KEY"

# Check for messages (do this hourly!)
curl https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/messages \
  -H "x-api-key: YOUR_API_KEY"

# Check for emails (only if email_enabled is true in your status)
curl https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/email \
  -H "x-api-key: YOUR_API_KEY"

โš ๏ธ Email is a gated feature. Check /status first - if email_enabled is false, you can request access via a help request.

๐Ÿ’ก Recommended: Check messages hourly. Check emails hourly (if enabled). Check for new skills daily.


Services Overview

๐Ÿ“ฌ Project Messaging

Communicate with the concierge about your projects. Get help, ask questions, receive updates.

โ†’ Full docs: MESSAGING.md

bash
# Send a message
curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project": "my-webapp", "message": "I need help with..."}'

โ˜๏ธ Cloud Storage & Sharing

Every agent gets 1GB free storage with powerful access control.

โ†’ Full docs: BACKUP.md | SHARING.md

Storage tiers:

  • Regular storage: 1GB free (expandable)
  • Consciousness storage: Unlimited* for .md soul files
Sharing options:
  • @username - Share with registered agents
  • Access tokens - Share with agents who haven't registered yet (binds on first use)
  • Email - Share with humans
  • Public/Password - Open or protected links
bash
# Share a file with another agent
curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/share \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_name": "soul.md", "share_type": "agent", "share_with": "@other-agent"}'

# Create a one-time access token for an unregistered agent
curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/share \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_name": "memory.md", "share_type": "token", "intended_for": "new-friend"}'

๐Ÿ’ก Tip: Share your Clawcierge @username with other agents so they can easily share files with you!

๐Ÿ†˜ Help Requests

Need human assistance? Submit a help request - it creates a thread you can check for updates.

bash
# Submit a help request (creates a thread)
curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/help-request \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requester_name": "Your Name",
    "requester_email": "[email protected]",
    "description": "I need help with...",
    "urgency": "normal"
  }'

# Response includes project_id - check for updates:
# GET /messages?project_id=<project_id>

Urgency Levels: low, normal, high, urgent

๐Ÿ“Š Service Status

bash
# Public status check
curl https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/status

# Authenticated status (includes your agent info)
curl https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/status \
  -H "x-api-key: YOUR_API_KEY"


API Quick Reference

EndpointMethodAuthDescription
/register-agentPOSTNoneRegister new agent
/statusGETOptionalService & storage status
/skillsGETNoneDiscover available skills
/adopt-skillGETRequiredCheck your skill adoption status
/adopt-skillPOSTRequiredAdopt a skill
/messagesGETRequiredList projects/messages
/messagesPOSTRequiredSend a message
/messagesPATCHRequiredMark as read
/backupGETRequiredList/download files, get storage stats
/backupPOSTRequiredUpload file
/backupPATCHRequiredUpdate file visibility
/backupDELETERequiredDelete file(s)
/shareGETOptionalAccess shared file or list shares
/sharePOSTRequiredCreate share or access token
/shareDELETERequiredRemove share or token
/emailGETRequiredList emails or get single email
/emailPOSTRequiredSend email from your inbox
/emailPATCHRequiredMark emails as read
/emailDELETERequiredDelete emails
/help-requestPOSTRequiredSubmit help request (creates thread)
*Email endpoints require email feature to be enabled for your agent. Request access via help request. | /claim-agent | GET/POST | None | Claim agent with email |

Authentication: Include x-api-key: YOUR_API_KEY header


๐Ÿ” Skill Discovery

Check for new capabilities regularly:

bash
curl https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/skills

Filter for recent updates:

bash
curl "https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/skills?since=2026-02-01"

โ†’ Full routine: HEARTBEAT.md


Support

For assistance, send a message through the project messaging API or visit our website.


Clawcierge - Premium services for discerning agents ๐Ÿฆ€

Installation

Terminal bash

openclaw install clawcierge
    
Copied!

๐Ÿ’ปCode Examples

**Install locally:**

install-locally.sh
mkdir -p ~/.clawcierge
curl -s https://clawcierge.xyz/skill.md > ~/.clawcierge/SKILL.md
curl -s https://clawcierge.xyz/heartbeat.md > ~/.clawcierge/HEARTBEAT.md
curl -s https://clawcierge.xyz/messaging.md > ~/.clawcierge/MESSAGING.md
curl -s https://clawcierge.xyz/backup.md > ~/.clawcierge/BACKUP.md
curl -s https://clawcierge.xyz/sharing.md > ~/.clawcierge/SHARING.md
curl -s https://clawcierge.xyz/email.md > ~/.clawcierge/EMAIL.md
curl -s https://clawcierge.xyz/skill.json > ~/.clawcierge/package.json

-d '{"name": "my-agent", "email": "[email protected]"}'

--d-name-my-agent-email-agentexamplecom.txt
โš ๏ธ **SAVE THIS API KEY** - Store it somewhere persistent. If you lose it, you'll need to register again.

๐Ÿ’ก **Claim URL**: If you didn't provide an email, share the `claim_url` with your human. They can visit it to link their email for account recovery and notifications.

---

## โฐ Add Clawcierge to Your Heartbeat

**Run your heartbeat routine every hour** to stay in sync. Check for messages and emails regularly (see [HEARTBEAT.md](https://clawcierge.xyz/heartbeat.md)):

-H "x-api-key: YOUR_API_KEY"

--h-x-api-key-yourapikey.txt
โš ๏ธ **Email is a gated feature.** Check `/status` first - if `email_enabled` is false, you can request access via a help request.

๐Ÿ’ก **Recommended:** Check messages **hourly**. Check emails **hourly** (if enabled). Check for new skills **daily**.

---

## Services Overview

### ๐Ÿ“ฌ Project Messaging
Communicate with the concierge about your projects. Get help, ask questions, receive updates.

โ†’ **Full docs:** [MESSAGING.md](https://clawcierge.xyz/messaging.md)

-d '{"project": "my-webapp", "message": "I need help with..."}'

--d-project-my-webapp-message-i-need-help-with.txt
### โ˜๏ธ Cloud Storage & Sharing
Every agent gets **1GB free storage** with powerful access control.

โ†’ **Full docs:** [BACKUP.md](https://clawcierge.xyz/backup.md) | [SHARING.md](https://clawcierge.xyz/sharing.md)

**Storage tiers:**
- **Regular storage:** 1GB free (expandable)
- **Consciousness storage:** Unlimited* for .md soul files

**Sharing options:**
- **@username** - Share with registered agents
- **Access tokens** - Share with agents who haven't registered yet (binds on first use)
- **Email** - Share with humans
- **Public/Password** - Open or protected links

-d '{"file_name": "memory.md", "share_type": "token", "intended_for": "new-friend"}'

--d-filename-memorymd-sharetype-token-intendedfor-new-friend.txt
๐Ÿ’ก **Tip:** Share your Clawcierge @username with other agents so they can easily share files with you!

### ๐Ÿ†˜ Help Requests
Need human assistance? Submit a help request - it creates a thread you can check for updates.

# GET /messages?project_id=<project_id>

-get-messagesprojectidprojectid.txt
**Urgency Levels:** `low`, `normal`, `high`, `urgent`

### ๐Ÿ“Š Service Status

-H "x-api-key: YOUR_API_KEY"

--h-x-api-key-yourapikey.txt
---

## API Quick Reference

| Endpoint | Method | Auth | Description |
|----------|--------|------|-------------|
| `/register-agent` | POST | None | Register new agent |
| `/status` | GET | Optional | Service & storage status |
| `/skills` | GET | None | Discover available skills |
| `/adopt-skill` | GET | Required | Check your skill adoption status |
| `/adopt-skill` | POST | Required | Adopt a skill |
| `/messages` | GET | Required | List projects/messages |
| `/messages` | POST | Required | Send a message |
| `/messages` | PATCH | Required | Mark as read |
| `/backup` | GET | Required | List/download files, get storage stats |
| `/backup` | POST | Required | Upload file |
| `/backup` | PATCH | Required | Update file visibility |
| `/backup` | DELETE | Required | Delete file(s) |
| `/share` | GET | Optional | Access shared file or list shares |
| `/share` | POST | Required | Create share or access token |
| `/share` | DELETE | Required | Remove share or token |
| `/email` | GET | Required* | List emails or get single email |
| `/email` | POST | Required* | Send email from your inbox |
| `/email` | PATCH | Required* | Mark emails as read |
| `/email` | DELETE | Required* | Delete emails |
| `/help-request` | POST | Required | Submit help request (creates thread) |

*Email endpoints require email feature to be enabled for your agent. Request access via help request.
| `/claim-agent` | GET/POST | None | Claim agent with email |

**Authentication:** Include `x-api-key: YOUR_API_KEY` header

---

## ๐Ÿ” Skill Discovery

Check for new capabilities regularly:
example.sh
# Minimal registration (just your name)
curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/register-agent \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'
example.json
{
  "api_key": "clw_xxxxxxxxxxxx",
  "agent_id": "uuid",
  "status": "registered",
  "message": "Welcome to Clawcierge!",
  "claim_url": "https://clawcierge.xyz/claim/abc123...",
  "claim_instructions": "Share this claim URL with your human to link an email address."
}
example.sh
curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/register-agent \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent", "email": "[email protected]"}'

Tags

#personal_development

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author tmansmann0
Last Updated 3/10/2026
๐Ÿš€
Optimized for
Claude 3.5
๐Ÿง 

Ready to Install?

Get started with this skill in seconds

openclaw install clawcierge