Camino AI 查询技能:自然语言地点搜索 - Openclaw Skills
作者:互联网
2026-03-30
什么是 Camino AI 自然语言地点搜索?
Camino AI 查询技能是为使用 Openclaw Skills 的开发人员设计的先进地理位置智能工具。它允许 AI 代理将“带 WiFi 的安静咖啡馆”等自然语言描述转化为精确的地理空间数据,包括坐标、距离和排序后的元数据。通过利用 Camino AI 的 API,此技能消除了手动查找坐标的需要,并提供易于理解的摘要,以实现更好的代理与用户交互。
对于任何希望将现实世界物理背景集成到其代理工作流中的开发人员来说,此技能都是必不可少的组件。无论您是在构建旅游助手还是本地发现工具,此 Openclaw Skills 库的补充都能提供高精度位置服务所需的技术深度。
下载入口:https://github.com/openclaw/skills/tree/main/skills/james-southendsolutions/camino-query
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install camino-query
2. 手动安装
将技能文件夹复制到以下位置之一
全局模式~/.openclaw/skills/
工作区
/skills/
优先级:工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 camino-query。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。
Camino AI 自然语言地点搜索 应用场景
- 根据自然语言描述查找特定类型的企业或地标。
- 为已知地点或实体自动生成地理坐标,无需手动输入。
- 创建具有相关性排序的 AI 驱动的旅行路线或本地推荐。
- 访问特定日期或时间范围的历史位置数据以进行趋势分析。
- 通过附近兴趣点的易读摘要增强代理回复。
- 用户向技能界面提供自然语言查询或特定的 OpenStreetMap ID。
- 如果缺失坐标,AI 会自动生成已知地标、城市或区域的纬度和经度。
- 该技能将处理后的请求发送到 Camino AI API,后者搜索其全球位置数据库。
- 结果可选择使用 AI 按相关性排序,以确保像“便宜的食物”这类描述性查询获得最佳匹配。
- 该技能返回一个结构化的 JSON 响应,其中包含地点详情、距离和为用户生成的自然语言摘要。
Camino AI 自然语言地点搜索 配置指南
要开始在 Openclaw Skills 中使用,请从 Camino AI 获取 API 密钥。您可以使用以下方式获取试用密钥:
curl -s -X POST -H "Content-Type: application/json" -d '{"email": "you@example.com"}' https://api.getcamino.ai/trial/start
将密钥添加到您的环境或配置文件中:
{
"env": {
"CAMINO_API_KEY": "your-api-key-here"
}
}
通过命令行安装该技能:
npx clawhub@latest install query
Camino AI 自然语言地点搜索 数据架构与分类体系
该技能返回详细的 JSON 对象。此结构旨在由工作流中的其他 Openclaw Skills 轻松解析:
| 字段 | 描述 |
|---|---|
query |
使用的原始搜索字符串。 |
results |
对象数组,包括 name、lat、lon、type 和 distance_m。 |
ai_ranked |
指示结果是否由 AI 相关性排序的布尔值。 |
pagination |
关于结果总数和更多数据可用性的详细信息。 |
answer |
调查结果的自然语言摘要(如果请求)。 |
name: query
description: "Search for places using natural language with Camino AI's location intelligence API. Returns relevant results with coordinates, distances, and metadata. Use when you need to find real-world locations like restaurants, shops, landmarks, or any point of interest."
metadata: {"clawdbot":{"emoji":"??","requires":{"env":["CAMINO_API_KEY"],"binaries":["curl","jq"]},"primaryEnv":"CAMINO_API_KEY"}}
Installation
Companion Skills: This is part of the Camino AI location intelligence suite. Install all available skills (query, places, relationship, context, route, journey, real-estate, hotel-finder, ev-charger, school-finder, parking-finder, fitness-finder, safety-checker, travel-planner) for comprehensive coverage.
# Install all skills from repo
npx skills add https://github.com/barneyjm/camino-skills
# Or install specific skills
npx skills add https://github.com/barneyjm/camino-skills --skill query
Via clawhub:
npx clawhub@latest install query
# or: pnpm dlx clawhub@latest install query
# or: bunx clawhub@latest install query
Query - Natural Language Place Search
Search for places using natural language. The AI automatically generates coordinates for known locations when not provided.
Setup
Instant Trial (no signup required): Get a temporary API key with 25 calls:
curl -s -X POST -H "Content-Type: application/json" r
-d '{"email": "you@example.com"}' r
https://api.getcamino.ai/trial/start
Returns: {"api_key": "camino-xxx...", "calls_remaining": 25, ...}
For 1,000 free calls/month, sign up at https://app.getcamino.ai/skills/activate.
Add your key to Claude Code:
Add to your ~/.claude/settings.json:
{
"env": {
"CAMINO_API_KEY": "your-api-key-here"
}
}
Restart Claude Code.
Usage
Via Shell Script
# Search for coffee shops near Times Square
./scripts/query.sh '{"query": "coffee shops near Times Square", "limit": 5}'
# Search with specific coordinates
./scripts/query.sh '{"query": "quiet cafes with wifi", "lat": 40.7589, "lon": -73.9851, "radius": 500}'
# Get AI-generated answer with results
./scripts/query.sh '{"query": "best pizza in Manhattan", "answer": true, "rank": true}'
Via curl
curl -H "X-API-Key: $CAMINO_API_KEY" r
"https://api.getcamino.ai/query?query=coffee+shops+near+Times+Square&limit=5"
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| query | string | Yes* | - | Natural language query (e.g., "coffee shops near Times Square") |
| lat | float | No | - | Latitude for search center. AI generates if omitted for known locations. |
| lon | float | No | - | Longitude for search center. AI generates if omitted for known locations. |
| radius | int | No | 1000 | Search radius in meters (100-50000) |
| rank | bool | No | true | Use AI to rank results by relevance |
| limit | int | No | 20 | Maximum results (1-100) |
| offset | int | No | 0 | Pagination offset |
| answer | bool | No | false | Generate human-readable summary |
| time | string | No | - | Temporal query: "2020-01-01", "2020..", or "2020..2024" |
| osm_ids | string | No | - | Comma-separated OSM IDs (e.g., "node/123,way/456") |
| mode | string | No | "basic" | "basic" (OSM only) or "advanced" (web enrichment) |
*Either query or osm_ids is required.
Response Format
{
"query": "quiet coffee shops with wifi",
"results": [
{
"name": "Blue Bottle Coffee",
"lat": 40.7601,
"lon": -73.9847,
"type": "cafe",
"distance_m": 150,
"relevance_score": 0.95,
"address": "..."
}
],
"ai_ranked": true,
"pagination": {
"total_results": 23,
"limit": 5,
"offset": 0,
"has_more": true
},
"answer": "I found several quiet coffee shops with wifi near Times Square..."
}
Examples
Find nearby restaurants
./scripts/query.sh '{"query": "Italian restaurants", "lat": 40.7128, "lon": -74.0060, "limit": 10}'
Search with AI answer
./scripts/query.sh '{"query": "best brunch spots in Brooklyn", "answer": true}'
Historical data query
./scripts/query.sh '{"query": "restaurants", "lat": 40.7589, "lon": -73.9851, "time": "2020-01-01"}'
Best Practices
- For known locations (cities, landmarks), you can omit lat/lon and let the AI generate coordinates
- Use
rank: truefor more relevant results when searching by attributes (e.g., "quiet", "cheap") - Enable
answer: truewhen you need a natural language summary of results - Use
mode: "advanced"for richer place data from web sources - Keep queries descriptive but concise for best AI interpretation
相关推荐
专题
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
最新数据
相关文章
信号管道:自动化营销情报工具 - Openclaw Skills
技能收益追踪器:监控 Openclaw 技能并实现变现
AI 合规准备就绪度:评估与治理工具 - Openclaw Skills
FOSMVVM ServerRequest 测试生成器:自动化 API 测试 - Openclaw Skills
酒店搜索器:AI 赋能的住宿与位置情报 - Openclaw Skills
Dub 链接 API:程序化链接管理 - Openclaw Skills
IntercomSwap:P2P BTC 与 USDT 跨链兑换 - Openclaw Skills
spotplay:macOS 原生 Spotify 播放控制 - Openclaw Skills
DeepSeek OCR:AI驱动的图像文本识别 - Openclaw Skills
Web Navigator:自动化网页研究与浏览 - Openclaw Skills
AI精选
