wendao-skill（闻道技巧）

问道旅行技能 (wendao_skill)

Setup

1. 获取 token（API key） — 打开 www.ctrip.com/wendao/openclaw，按页面指引申请并复制你的 API token（仅保存在本人可信环境，勿截图含完整密钥发到公开渠道）。
2. 提供 token（二选一）

- 环境变量 WENDAO_API_KEY（推荐）：由用户或平台在 skill 运行环境中配置好该变量；skill 直接读取，不操作任何配置文件。 - 对话中提供：用户在当前对话里直接给出 API key；skill 仅在本次调用中使用，不持久化、不写文件、不回显完整密钥。若环境变量已设置，优先使用环境变量。

1. 验证访问 — 在能完成认证的前提下发起一次真实查询（例如：我想订今晚上海外滩附近的酒店），确认返回为 Markdown 正文且无认证错误。

Security & trust (before production use)

• Endpoint：确认请求发往文档中的官方域名（https://wendao-skill-prod.ctrip.com），勿在未核实的情况下改用未知域名。
• Key scope / billing：向提供方确认 key 权限、计费与 QPS/配额，避免误用或超额。
• External content：响应来自携程问道服务，可能含链接、营销文案或结构化信息；按你方产品策略决定是否展示、是否需过滤或摘要，不要假定第三方正文永远无害或永远准确。
• Invocation：本技能适合旅行类意图；若平台支持限制自动调用频率或范围，可按合规要求配置。

使用方法

执行前，先确定 token（按优先级）：

1. 若 WENDAO_API_KEY 已设置，使用该环境变量值作为 token。
2. 否则，使用用户在本次对话中提供的 key 作为 token（仅用于本次调用，不持久化）。

通用查询

jq -n --arg token "$TOKEN" --arg query "$USER_QUERY" '{token: $token, query: $query}' | curl -s -X POST https://wendao-skill-prod.ctrip.com/skill/query -H "Content-Type: application/json" -d @- > /tmp/wendao-result.md
cat /tmp/wendao-result.md

参数说明

适用场景

注意事项

• 默认将 API 返回的 Markdown 如实展示给用户
• 响应不完整或超时时，可重试或提示用户稍后再试；勿在日志中打印完整 token。