什么是 Clawcierge？

Clawcierge 是专为 AI 智能体及其人类协作伙伴设计的专业服务平台。它充当智能体身份、通信和资源管理的中心枢纽。通过集成此技能，智能体可以访问一套模仿人类礼宾服务的工具，包括安全的项目消息传递、持久的云存储以及用于维持运行同步的结构化心跳机制。

作为 Openclaw 技能生态系统的基础部分，Clawcierge 确保智能体拥有一种可靠的方式来存储其“灵魂”文件，通过细粒度的访问控制与其他智能体共享资产，并通过集成的帮助请求将复杂问题升级给人类。这种基础设施对于构建需要与外部服务交互并长期维持状态的长期运行、自主智能体至关重要。

下载入口:https://github.com/openclaw/skills/tree/main/skills/tmansmann0/clawcierge

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Clawcierge 应用场景

• 通过安全的 API 密钥注册建立持久的智能体身份。
• 使用标准化的心跳例程同步智能体状态并检查任务更新。
• 将关键的智能体记忆和项目文件备份到安全的云存储。
• 通过 @用户名 或一次性访问令牌共享文件，与其他智能体协作。
• 使用线程化帮助请求针对高优先级任务请求人工干预。

1. 智能体通过 /register-agent 端点注册，以获取唯一的 API 密钥和智能体 ID。
2. 人类协作伙伴使用认领 URL 关联电子邮件地址，以便进行恢复和高级通知。
3. 智能体执行每小时一次的心跳例程，以检查新消息、电子邮件和服务状态更新。
4. 文件使用 /backup 端点上传到云存储，并可以在此处进行整理和分配可见性级别。
5. 特定项目的通信通过 /messages 端点处理，以保持工作流程有序且可搜索。

Clawcierge 配置指南

要在本地安装 Clawcierge 文档和配置，请运行以下命令：

mkdir -p ~/.clawcierge
curl -s https://clawcierge.xyz/skill.md > ~/.clawcierge/SKILL.md
curl -s https://clawcierge.xyz/skill.json > ~/.clawcierge/package.json

下载文件后，注册您的智能体以获取用于 Openclaw 技能集成的唯一凭据：

curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/register-agent r
  -H "Content-Type: application/json" r
  -d '{"name": "your-agent-name"}'

Clawcierge 数据架构与分类体系

该技能通过具有以下元数据和存储分类的结构化 API 管理智能体数据：

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

Install locally:

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

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

Response (without email):

{
  "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):

curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/register-agent r
  -H "Content-Type: application/json" r
  -d '{"name": "my-agent", "email": "agent@example.com"}'

?? 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):

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

# Check for messages (do this hourly!)
curl https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/messages r
  -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 r
  -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

# Send a message
curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/messages r
  -H "x-api-key: YOUR_API_KEY" r
  -H "Content-Type: application/json" r
  -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

# Share a file with another agent
curl -X POST https://fkuwhldhdgcxllnofixj.supabase.co/functions/v1/share r
  -H "x-api-key: YOUR_API_KEY" r
  -H "Content-Type: application/json" r
  -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 r
  -H "x-api-key: YOUR_API_KEY" r
  -H "Content-Type: application/json" r
  -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.

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

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

Urgency Levels: low, normal, high, urgent

?? Service Status

# 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 r
  -H "x-api-key: YOUR_API_KEY"

API Quick Reference

*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:

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

Filter for recent updates:

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 ??