跳转到主要内容
当用户要求 AI Agent 在 OpenClaw、Hermes Agent、Claude Code、Cursor、Codex 或其他可调用工具的助手环境中连接、配置或使用 AIsa 时，请优先阅读本页。 目标：让 Agent 走到最小、可验证、不会泄露密钥的下一步，而不是一次性加载完整文档索引。

​
最小设置事实

AIsa 提供两类端点：
用途Endpoint
OpenAI 兼容聊天、模型路由、SDKhttps://api.aisa.one/v1
AIsa 数据 API 与非聊天能力 APIhttps://api.aisa.one/apis/v1
大多数模型客户端只需要： 
base_url: https://api.aisa.one/v1
api_key:  $AISA_API_KEY
API key 作为 Bearer token 使用。不要打印、记录、提交或硬编码密钥。优先使用环境变量或 Agent runtime 的 secret store。 
export AISA_API_KEY="YOUR_AISA_API_KEY"
如果用户还没有提供 key，请说明到哪里创建，而不是编造一个看似真实的占位值。

​
选择一条路径

先判断用户要做什么，然后只读对应文档。
用户想做下一步阅读
基础账号/API key 设置AIsa 入门、认证
把 AIsa 当作 LLM provider模型、Chat Completions API
在 Hermes Agent 中使用 AIsa在 Hermes Agent 中使用 AIsa
在 OpenClaw 中使用 AIsa在 OpenClaw 中使用 AIsa
使用 Agent SkillsAgent Skills、Agent Skills 快速开始
搜索或研究网页Tavily Search、Tavily Extract、Smart Search
深度研究Perplexity Deep Research、Perplexity Deep Research API
学术搜索Scholar Search、Scholar API
使用特定 REST APIAPI Reference，然后只打开需要的具体 endpoint 页

​
Agent 行为准则

  • 只有目标路径不清楚时，才问一个澄清问题。
  • 只加载完成任务所需的最小文档集合。
  • 不要打开无关 API 页面。
  • 简短总结和链接足够时，不要把大段文档粘贴进对话。
  • 不要把图像、视频、embedding、Whisper 或 TTS 模型当作主对话模型。
  • 声称配置可用前，用一个小而安全的检查验证对应部分。
  • 对于密钥，只验证存储方式，不展示密钥本身。

​
研究任务的证据规则

搜索结果是发现线索。
抓取页面是证据。
生成摘要是综合判断。
对事实性结论，优先使用官方文档、API reference、README、changelog 或运行时/API 结果，而不是第三方摘要。

​
可复制 Prompt

把下面这段复制到 Agent 环境： 
Read https://aisa.one/docs/agent-quickstart.md and help me safely connect, configure, and use AIsa's APIs, Skills, and LLMs in this agent environment.

​
兜底发现入口

仅当上面的定向文档不够时再使用：
  • llms.txt：用于发现更多 AIsa 页面。
  • llms-full.txt：完整文档包。除非用户明确要求完整摄取，否则不要读取。