Camino AI 查询技能:自然语言地点搜索 - Openclaw Skills

作者:互联网

2026-03-30

AI教程

什么是 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 驱动的旅行路线或本地推荐。
  • 访问特定日期或时间范围的历史位置数据以进行趋势分析。
  • 通过附近兴趣点的易读摘要增强代理回复。
Camino AI 自然语言地点搜索 工作原理
  1. 用户向技能界面提供自然语言查询或特定的 OpenStreetMap ID。
  2. 如果缺失坐标,AI 会自动生成已知地标、城市或区域的纬度和经度。
  3. 该技能将处理后的请求发送到 Camino AI API,后者搜索其全球位置数据库。
  4. 结果可选择使用 AI 按相关性排序,以确保像“便宜的食物”这类描述性查询获得最佳匹配。
  5. 该技能返回一个结构化的 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 对象数组,包括 namelatlontypedistance_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

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: true for more relevant results when searching by attributes (e.g., "quiet", "cheap")
  • Enable answer: true when 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