Elasticsearch OpenClaw 🔍

面向 AI 编排应用的现代 Elasticsearch 9.x 实践模式。

🔒 安全模型：默认只读

本技能**仅提供只读操作的相关文档**：包括搜索、聚合与分析功能。不包含任何写入操作（如索引、更新、删除），且代理不会执行任何写入操作。

注意：该技能需依赖外部凭据（Elasticsearch API 密钥）方可运行。ClawHub 安全扫描器可能将其标记为“可疑”——这是对接外部服务类技能的预期行为。所有代码均为透明的 Markdown 文档，请在授予权限前务必审阅。

快速开始 —— 本地开发

如需在本地搭建 Elasticsearch 9.x 并集成 Kibana，请使用官方 start-local 工具：

• 仓库地址：https://github.com/elastic/start-local
• 文档地址：https://www.elastic.co/start-local

启动成功后：

• Elasticsearch：http://localhost:9200
• Kibana：http://localhost:5601
• 凭据文件：elastic-start-local/.env

认证 —— 务必使用 API 密钥

# 测试连接
curl -s "$ELASTICSEARCH_URL" -H "Authorization: ApiKey $ELASTICSEARCH_API_KEY"

# Python 客户端（9.x）
from elasticsearch import Elasticsearch
es = Elasticsearch(ES_URL, api_key=API_KEY)

参考文档文件

按需加载以下文件，切勿一次性全部加载：

各模式适用场景指南

User asks about meaning / intent / "find products like X"
  → semantic_text + semantic query  →  references/semantic-search.md

User needs exact match + semantic combined
  → hybrid search (RRF)            →  references/vector-search.md

User asks about mapping, field types, analyzers, aggregations
  → classic patterns                →  references/classic-patterns.md

User uses Python elasticsearch library
  → always check                    →  references/python-client-9.md

安全最佳实践

• 始终优先使用 API 密钥而非用户名/密码进行认证
• 将 API 密钥的作用域严格限定于特定索引，并授予最小必要权限
• 针对 OpenClaw 的只读访问场景，应配置权限：privileges: ["read", "view_index_metadata"]
• 凭据须存于 .env 文件中，严禁硬编码至脚本中
• .env 文件必须加入 .gitignore

POST /_security/api_key
{
  "name": "openclaw-readonly",
  "role_descriptors": {
    "reader": {
      "indices": [{ "names": ["my-index"], "privileges": ["read"] }]
    }
  }
}

// 响应示例：
{
  "id": "VuaCfGcBCdbkQm-e5aOx",
  "name": "openclaw-readonly",
  "api_key": "ui2lp2axTNmsyakw9tvNnw",
  "encoded": "VnVhQ2ZHY0JDZGJrUW0tZTVhT3g6dWkybHAyYXhUTm1zeWFrdzl0dk5udw=="
}

⚠️ 请立即保存响应中的 encoded 字段值——该值后续无法再次获取。
请将其添加至：~/.openclaw/workspace-[name]/.env，键名为 ELASTICSEARCH_API_KEY