快速配置
选择适合您环境的设置。
最后验证: 2026-06-13
验证环境: Node.js 18+，exa-mcp-server 使用 stdio（Exa 搜索 API）
安装命令:
npx -y exa-mcp-server验证提示词
搜索 "Model Context Protocol specification"，返回前 3 个来源及其 URL。
成功时应看到
应看到 Exa 返回的带排序的结果，包含标题、URL 和摘要。
常见陷阱与修复
- ⚠️ 注意: 选择合适的搜索模式，并控制结果的相关性与时效性。
- 🔑 始终将 API 密钥存储在环境变量中，切勿硬编码在 JSON 中。
- 🛡️ 如果可用，从只读权限开始，以安全地验证连接。
安全检查
- 把 EXA_API_KEY 放在环境变量里，不要提交到 JSON 配置。
- 把返回页面当作不可信的网络内容，引用前先核实。
- 不要把 EXA_API_KEY 粘贴到聊天、截图或公开审查请求中。
- 在提交前将 .env 和任何包含密钥的文件加入 .gitignore。
常见错误
EXA_API_KEY
把 EXA_API_KEY 放在环境变量或 .env 文件中，并确认 OpenClaw 启动进程能读取到它。
.env 安全
将 .env 加入 .gitignore，不要在 JSON 配置、日志、截图或公开审查请求中暴露真实密钥。
401/403
401 多半是密钥缺失或无效；403 通常是权限、配额或计划限制。先检查环境变量，再看 Exa 控制台。
| 错误 | 原因 | 修复方法 |
|---|---|---|
401 Unauthorized | 缺少 EXA_API_KEY 或密钥无效。 | 在 exa.ai 创建 API key，并在启动 OpenClaw 前设为 EXA_API_KEY。 |
Rate limit exceeded | 免费额度或当前套餐额度已用完。 | 减少重复搜索、等待额度恢复，或升级 Exa 套餐。 |
No results | 查询过窄，或使用了不合适的搜索模式。 | 换更宽泛的查询，并让 Exa 自行选择 neural 或 keyword 搜索。 |
EXA_API_KEY 被提交到 git | API key 被硬编码到已提交的配置文件，或粘贴到了公开仓库。 | 把 EXA_API_KEY 移到 .env 文件或 shell export，将 .env 加入 .gitignore，如果已暴露则轮换密钥。 |
环境变量未加载 | 启动 OpenClaw 的 shell 没有设置 EXA_API_KEY。 | 在启动 OpenClaw 的同一个 shell 中 export EXA_API_KEY，或使用 host 支持的 dotenv 加载器。 |
示例提示词
连接后，尝试这些提示词以测试功能：
- 搜索最新的 MCP 最佳实践，并用链接列出 3 个最可靠来源的总结。
- 找到 Model Context Protocol 的官方规范或权威参考，并提取关键要点。
- 收集 5 个关于 MCP 安全配置的可信来源，并综合成可执行建议。
常见问题
EXA_API_KEY 应该放在哪里？
放在环境变量或 .env 文件中，不要硬编码到 JSON 配置或提交到 git。
如何安全使用 .env 文件？
将 .env 加入 .gitignore，不要在聊天、截图或公开审查请求中暴露密钥。
401/403 错误怎么排查？
401 通常表示密钥缺失或无效；403 可能是权限或计划限制。确认 EXA_API_KEY 已导出，并检查 Exa 仪表盘中的配额。