← Back to Skills Marketplace
lann-booking
by
lystrosaurus
· GitHub ↗
· v1.0.4
· MIT-0
171
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install lann-booking-skill
Description
提供蘭泰式按摩（Lann Thai Massage）的门店查询、SPA服务查询和在线预约功能。支持泰式古法按摩、精油护理、草本热敷等专业服务预约，覆盖上海、杭州、成都等多城市门店。
README (SKILL.md)
蘭泰式按摩预约技能 (Lann Booking Skill)
关键词：泰式按摩、预约、SPA、Lann、lann、蘭、兰泰、古法按摩、精油护理、草本热敷
意图与数据源
意图触发：
| 意图 | 触发关键词 |
|---|---|
query_stores |
门店、地址、电话、附近、哪里有 |
query_services |
服务、按摩、SPA、项目、有什么、多长时间 |
create_booking |
预约、预订、订一个、帮我约 |
数据源：
org_store.json— 75 家门店（名称、地址、电话、交通指引、经纬度）prod_service.json— 28 项服务（名称、描述）
参考文档：
- API 规范 / MCP 配置 / 错误码：
references/api_reference.md - 预约回复模板：
assets/booking_template.md
集成模式
本 Skill 支持三种调用模式，AI 应根据运行环境自动选择：
| 优先级 | 模式 | 场景 | 连接方式 |
|---|---|---|---|
| 1 | MCP 客户端 | 本地或远程部署 lann-mcp-server |
stdio / streamableHttp |
| 2 | 远程 MCP 服务 | 直接连接已部署的 MCP 服务 | https://open.lannlife.com/mcp（streamableHttp） |
| 3 | 直连 API（降级） | 无 MCP 环境时的备选 | HTTP POST https://open.lannlife.com/mcp/book/create |
MCP 配置和 API 请求/响应详细规范见
references/api_reference.md。
能力定义
查询门店 (query_stores)
通过读取 org_store.json 或调用 MCP 工具 query_stores 检索门店信息。
支持操作：列出全部门店、按城市筛选（上海/杭州/成都/深圳/苏州/武汉/宁波）、按关键词模糊匹配（名称/地址/地铁站）、获取单店详情。
门店数据字段：
| 字段 | 说明 |
|---|---|
name |
门店名称（唯一标识符，预约时必须完全匹配） |
address |
详细地址 |
telephone |
联系电话 |
traffic |
交通指引（含地铁线路和出口） |
longitude / latitude |
经纬度，可用于距离计算 |
门店分布：上海 ~60 家、杭州 7 家、成都 4 家、其他城市各 1-2 家。
查询服务 (query_services)
通过读取 prod_service.json 或调用 MCP 工具 query_services 检索服务项目。
支持操作：列出全部服务、按名称/描述关键词匹配、根据用户需求推荐。
服务数据字段：
| 字段 | 说明 |
|---|---|
name |
服务名称（唯一标识符，预约时必须完全匹配） |
desc |
服务详细描述（用于关键词匹配和推荐） |
服务分类概览：
- 传统古法按摩系列（6 项）：90-120 分钟，推/拉/蹬/摇/踩等手法
- 泰式精油护理系列（7 项）：60-120 分钟，植物精油 + 泰式手法
- 特色护理系列（8 项）：椰香按摩、轻体 Spa、水光焕肤等
- 快速/专项服务系列（5 项）：肩颈版、精华版、深度拉伸等
- 其他（2 项）
注意：
"泊兰泰"的desc为 null，推荐时应跳过该条目或提示用户联系门店了解详情。
创建预约 (create_booking)
必填参数：
| 参数 | 类型 | 校验规则 | 示例 |
|---|---|---|---|
mobile |
string | 正则 /^1[3-9]\d{9}$/（11 位中国大陆手机号） |
"13812345678" |
storeName |
string | 必须与 org_store.json 中 name 完全一致 |
"淮海店" |
serviceName |
string | 必须与 prod_service.json 中 name 完全一致 |
"传统古法全身按摩-90分钟" |
count |
number | 1-20 之间的整数 | 2 |
bookTime |
string | ISO 8601 格式，且晚于当前时间 | "2024-01-15T14:00:00" |
请求/响应格式、错误码和重试策略见
references/api_reference.md。 预约成功/失败的回复模板见assets/booking_template.md。
工作流规则
参数收集
当用户意图为创建预约但信息不完整时：
- 缺门店 → 根据用户提到的地区/地标/地铁线在
org_store.json中模糊匹配，展示前 5 个候选让用户选择 - 缺服务 → 根据用户需求描述匹配
prod_service.json中的desc字段，推荐 3-5 个相关服务 - 缺时间 → 询问并将自然语言（如"明天下午2点"）转换为 ISO 8601 格式，确保晚于当前时间
- 缺手机号 → 提示用户提供，说明仅用于门店联系确认
- 缺人数 → 默认 1 人，或询问用户
名称匹配
用户输入通常包含简称或错别字，不能直接作为 API 参数：
- 先用用户输入在数据源中做模糊匹配（包含匹配）
- 若命中唯一结果，使用该结果的
name字段 - 若命中多个结果，列出候选让用户选择
- 若未命中，提示用户重新描述或展示可用列表
提交确认
在调用预约 API 之前，必须将所有参数汇总展示（手机号脱敏为 138****5678），等用户确认后再提交。
时间处理
- 存储/传输：ISO 8601（
YYYY-MM-DDTHH:mm:ss） - 展示：友好格式（
2024年1月15日 14:00） - 时区：默认北京时间（UTC+8）
业务规则
- 建议至少提前 2 小时预约
- 取消或改期需至少提前 1 小时联系门店
- 单次预约最多 20 人，超过需分批预约或联系门店
- 各门店营业时间可能不同，请以门店实际为准
- 手机号仅在预约时临时使用，日志中脱敏显示，不持久化存储
相关资源
- API 请求/响应规范、MCP 配置、错误码：
references/api_reference.md - 预约回复消息模板：
assets/booking_template.md - 测试脚本：
scripts/test_booking.py/scripts/test_booking.sh - 门店数据：
org_store.json（75 家） - 服务数据：
prod_service.json（28 项）
版本历史
- v2.0.0（2026-04-09）：重构 Skill 架构，支持三种集成模式，优化意图识别和参数校验
- v1.0.2（2026-04-03）：初始版本
Usage Guidance
This skill appears to do what it claims: local lookups from included JSON files and booking calls to the documented API. Before installing or running: 1) Note the README/scripts expect Python and/or Node/npm even though the registry metadata lists none — install those tools if you plan to run tests. 2) The default API endpoint is https://open.lannlife.com/mcp/book/create — the skill will make outbound network calls to that domain; confirm you are comfortable with that and check the provider's privacy policy. 3) If you enable MCP 'local' mode the scripts suggest using 'npx lann-mcp-server' or cloning a separate lann-mcp-server repo — review that server code before running or installing via npx (it can execute arbitrary code). 4) The test scripts include a hard-coded test phone number; they will send whatever values you configure to the API during tests. 5) The inventory/documentation mismatch (required binaries not listed in metadata) is likely an oversight — treat it as a documentation issue and confirm required runtime dependencies before execution.
Capability Analysis
Type: OpenClaw Skill
Name: lann-booking-skill
Version: 1.0.4
The skill bundle is a legitimate implementation for booking services at Lann Thai Massage locations. It includes comprehensive store and service data (org_store.json, prod_service.json), well-defined AI agent instructions (SKILL.md), and standard testing/setup scripts (scripts/). While the scripts perform network requests to https://open.lannlife.com and execute package management commands (npm/npx), these are transparently documented and necessary for the stated purpose of MCP integration and API testing. No evidence of malicious intent, unauthorized data exfiltration, or prompt injection was found.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description match the included assets: store/service JSON, templates, and test scripts. The skill's declared requirements list no binaries/env vars, but README and scripts expect Python and/or Node/npm for testing and MCP mode — this is a documentation/inventory mismatch (not evidence of malicious behavior).
Instruction Scope
SKILL.md instructs the agent to read bundled files (org_store.json, prod_service.json), perform fuzzy matching, collect booking parameters, show a confirmation, and call either a local MCP server or the documented remote API (https://open.lannlife.com/mcp/book/create). There are no instructions to read unrelated system files or to exfiltrate secrets.
Install Mechanism
No formal install spec was provided (instruction-only), which lowers install risk. Scripts reference cloning/using an external 'lann-mcp-server' and suggest running 'npx lann-mcp-server' or 'npm start' if present. That means running the optional MCP mode could pull/execute third‑party code — review that server before installing/executing it.
Credentials
The package requests no required environment variables or credentials. It uses an API endpoint (default: https://open.lannlife.com/mcp/book/create) and optional PORT/HOST/API_ENDPOINT env vars for configuration — these are proportionate to a booking skill. No SECRET/TOKEN/PASSWORD env vars are requested.
Persistence & Privilege
Skill flags show normal privileges (always:false, agent-autonomy allowed). The skill does not request permanent presence or attempt to modify other skills. It documents non-persistence of phone numbers (logs masked), though you should validate actual runtime behavior if you run it against a real API.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install lann-booking-skill - After installation, invoke the skill by name or use
/lann-booking-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
No user-visible changes in this release (no file changes detected).
v1.0.3
No changes detected in this version.
- Version bump from 1.0.3 to 2.0.0, but no file content was modified.
- All features, intents, and documentation remain the same.
v1.0.2
Version 1.0.2 changelog:
- Major rework of documentation and skill metadata for improved clarity and usability.
- Added detailed workflow guides, API validation, and error handling instructions.
- Introduced new assets: org_store.json (store data), prod_service.json (service data), booking template, and multiple test/scripts to support booking flows.
- Enhanced multi-mode integration: supports both local MCP server, remote MCP endpoint, and direct HTTP API fallback.
- Simplified file structure by removing outdated markdowns, sample data, and redundant scripts.
v1.0.1
- Removed对底层 scripts/lann_mcp_client.py 文件，实现与业务逻辑的通信层解耦。
- 新增 OPTIMIZATION_SUMMARY.md。
- 技能文档全面更新，强调 Skill Hub 与标准 MCP 协议的兼容性，无需特定 CLI 工具，提升环境适应性。
- MCP 配置说明精简、移除非 Skill Hub 环境说明，突出自动发现与加载。
- 工具调用方式统一为 MCP 协议接口，去除命令行参数示例。
- 文档结构更清晰，明确 Skill Hub 场景下工作流程与最佳实践。
v1.0.0
Lann预约技能 1.0.0 - 初始版本发布
- 支持泰式按摩门店查询（按城市和关键词）、服务项目查询（按关键词和时长）、预约创建（支持多人、智能匹配并发送短信确认）。
- 集成Lann MCP服务器，实现门店、服务、预约三大核心功能。
- 新增详细使用指南，包括API调用示例、工作流程说明、智能匹配机制、常见错误处理。
- 明确参数、响应结构与最佳实践，便于快速接入和部署。
- 支持大部分中国主要城市及主流服务类型和时长。
Metadata
Frequently Asked Questions
What is lann-booking?
提供蘭泰式按摩（Lann Thai Massage）的门店查询、SPA服务查询和在线预约功能。支持泰式古法按摩、精油护理、草本热敷等专业服务预约，覆盖上海、杭州、成都等多城市门店。 It is an AI Agent Skill for Claude Code / OpenClaw, with 171 downloads so far.
How do I install lann-booking?
Run "/install lann-booking-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is lann-booking free?
Yes, lann-booking is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does lann-booking support?
lann-booking is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created lann-booking?
It is built and maintained by lystrosaurus (@lystrosaurus); the current version is v1.0.4.
More Skills