什么是 PopUp 组织者？

PopUp 组织者技能使 AI 代理能够通过直接对接 PopUp API 来处理活动策划的全生命周期。这种集成允许 Openclaw Skills 用户搜索各个类别的专业供应商（从花艺师到现场乐队），按地点和预算进行筛选，并自动处理活动管理的物流开销。

通过利用这项技能，开发人员可以构建不仅能寻找人才，还能处理活动申请、直接咨询和财务跟踪等复杂问题的代理。它通过在程序化接口中集中供应商沟通和发票管理，简化了组织者的工作流程，使其成为任何活动驱动型自动化技术栈的重要组成部分。

下载入口:https://github.com/openclaw/skills/tree/main/skills/eliaskress/popup-organizer

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

PopUp 组织者 应用场景

• 为企业聚会自动化搜索当地餐饮车和娱乐项目。
• 创建和管理公开活动列表以吸引供应商申请。
• 同时向多个供应商发送并跟踪预订咨询。
• 为大型节日或私人婚礼组织发票和付款状态。
• 为经常性的活动策划建立精选的书签供应商名单。

1. 代理使用通过环境变量提供的专用组织者 API 密钥向 PopUp API 进行身份验证。
2. 用户根据特定标准（如州、大都市区、价格范围或服务类型）发起供应商搜索。
3. 代理创建一个活动列表，指定关键细节，如日期、地点、供应商容量和所需的供应商类别。
4. 当供应商申请活动时，代理会检索并汇总申请供组织者审阅。
5. 向特定供应商发送直接咨询以协商报价并最终确定预订条款。
6. 达成协议后，代理会监控发票状态并管理组织者的个人资料和保存的供应商列表。

PopUp 组织者 配置指南

要将此技能集成到您的工作流中，请按照以下步骤操作：

1. 在 usepopup.com 注册或登录。
2. 将您的账户切换到 组织者 (Organizer) 模式。
3. 导航至 设置 > API 密钥 (Settings > API Keys) 并点击 **创建 API 密钥 (Create API Key)**。
4. 使用以下命令配置您的环境：

export POPUP_API_KEY="您的API密钥"

PopUp 组织者 数据架构与分类体系

该技能将数据组织成几个核心实体，以确保简化的活动物流：

name: PopUp Organizer
description: Search and hire mobile vendors for events on PopUp. Find food trucks, DJs, photo booths & more, create event listings, send booking inquiries, and manage invoices.
metadata: {"openclaw":{"requires":{"env":["POPUP_API_KEY"]},"primaryEnv":"POPUP_API_KEY"}}

PopUp Organizer

Search and hire mobile vendors — food trucks, DJs, photo booths, florists, live bands, and more — for any event. Create event listings, send booking inquiries, manage applications, track invoices, and save favorite vendors.

Getting Started

1. Sign up or log in at https://usepopup.com/login
2. Switch to Organizer mode
3. Go to Settings > API Keys
4. Click Create API Key and copy the key (shown only once)

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer pk_live_...

The token is provided via the POPUP_API_KEY environment variable.

Rate limit: 60 requests per minute per API key. HTTP 429 is returned with Retry-After: 60 if exceeded.

Base URL: https://usepopup.com/api/v1/organizer

Endpoints

Search Vendors

GET /vendors

Search published vendor profiles by name, type, location, event type, or price range.

Returns vendor profiles with businessName, businessType, homeCity, homeState, priceRange, averageRating, eventTypes, slug, and more.

List Events

GET /open-events

List your events.

Returns events with title, eventDate, startTime, endTime, eventCity, eventState, vendorCap, expectedGuestCount, status, shareUrl, shortUrl, and qrCodeUrl.

Get Event Detail

GET /open-events/{eventId}

Returns the event object plus an applications array (each with businessId, status, quotedRate, engagementModel, and nested business info) and eventTerms.

Create Event

POST /open-events

Create a new event listing.

Required fields: title, description, eventType, eventDate (YYYY-MM-DD), startTime (HH:mm), endTime (HH:mm), eventPlaceName, eventAddress1, eventCity, eventState (2-letter), eventZip, vendorCap (1-1000), feePayer (organizer_pays | vendor_pays | none), expectedGuestCount (1-100000), vendorCategoriesWanted (array, 1-20 items).

Optional fields: location, eventLat, eventLng, heroImageUrl, organizerBudget, boothFee, salesPercent, hiredBudget, venueSetting, requiresVerification, invoiceDueDays, termIds.

Events are pending admin approval before becoming publicly visible.

Update Event

PATCH /open-events/{eventId}

Update event fields or perform actions.

Actions: { "action": "close" } to close to new applications, { "action": "reopen" } to reopen.

Updatable fields: all the same fields as create. When key details change (date, time, venue, title), accepted vendors are notified.

Cancel Event

DELETE /open-events/{eventId}

Cancel an event. All pending and accepted vendors are notified.

List Applications

GET /open-events/{eventId}/applications

List vendor applications for an event.

Get Event QR Code

GET /open-events/{eventId}/qr

Returns a PNG QR code image for the event share link.

List Inquiries

GET /inquiries

List your inquiries to vendors.

Returns inquiries with eventDate, eventType, guestCount, location, budget, message, status, quotedPrice, quoteMessage, and nested business info.

Get Inquiry Detail

GET /inquiries/{id}

Get a single inquiry with full detail.

Create Inquiry

POST /inquiries

Send a booking inquiry to a vendor.

Required: businessId (UUID).

Optional: bookingType (catering | vending), eventDate (YYYY-MM-DD), eventType, guestCount, location, eventPlaceName, eventAddress1, eventCity, eventState, eventZip, budget, message, phone, startTime (HH:mm), endTime (HH:mm), estimatedPrice.

The vendor is notified by email and in-app notification.

Update Inquiry

PATCH /inquiries/{id}

Update a pending inquiry or respond to a quote.

Actions: { "action": "accept_quote" } (inquiry must be quoted), { "action": "decline" } (inquiry must be quoted).

Updatable fields (pending only): eventDate, eventType, guestCount, location, budget, message, startTime, endTime.

Delete Inquiry

DELETE /inquiries/{id}

Delete a pending inquiry. Only works on status=pending.

List Invoices

GET /invoices

List invoices for event applications and direct inquiries.

Returns invoices with eventTitle, eventDate, vendorName, engagementModel, amount (dollars), direction (receivable | payable), isPaid.

List Saved Vendors

GET /saved

List your bookmarked vendors.

Save Vendor

POST /saved

Bookmark a vendor: { "businessId": "..." }

Remove Saved Vendor

DELETE /saved?businessId=...

Remove a bookmarked vendor.

Get Profile

GET /profile

Get your organizer profile and account info.

Update Profile

PATCH /profile

Update your organizer profile.

Fields: companyName, companyType (brand | agency | planner | corporate), eventTypes (array), location, city, state, zip, phone, website, about, givesBack, nonProfit, forACause, rules.

Response Format

All endpoints return JSON with { "data": ... } wrapper. List endpoints include { "pagination": { "page", "limit", "total", "totalPages" } }.

Error responses: { "error": "message" } with appropriate HTTP status (400, 401, 404, 429, 500).

Vendor Categories

Use these values for the type parameter when searching vendors:

Event Types

Use these values for eventType fields:

wedding, corporate, birthday, festival, market, popup, fundraiser, community, holiday, private, other