前提条件
开始之前,请确保你已具备:- AIsa 账户(console.aisa.one),通过浏览器登录
- macOS、Linux 或 Windows WSL2 终端
1. 安装 Hermes Agent
运行官方安装脚本:2. 添加 AIsa MCP 服务器
在终端中运行以下命令(不要在 Hermes 会话内执行):hermes mcp login aisa。
使用 API key 代替 OAuth
使用 API key 代替 OAuth
对于无头(headless)机器,可以使用 header 认证添加服务器:当 Hermes 询问服务器是否需要认证时输入
Y,然后在 API key / Bearer token 处粘贴你的 AIsa key。Hermes 会将其作为 MCP_AISA_API_KEY 存储在 .env 文件中,并在 config.yaml 中引用。3. 验证
Connected 和 Tools discovered: 7。启动新的 Hermes 会话以加载这些工具,或在当前运行的会话中运行 /reload-mcp。
4. 使用 AIsa 能力
search、list_categories、get_details、batch_get_schema 和 batch_quote(对具体调用进行报价而不实际执行)完全免费;use 和 batch_use 会执行实际调用并按次计费。
尝试输入:
可选:将 AIsa 用作模型提供商
Hermes 也可以运行 AIsa 目录中的模型。这需要 AIsa API key(console.aisa.one/api-keys)。 运行:
当 Hermes 询问 API 端点和 API key 时,输入:
选择模式 1. Auto-detect 或 2. Chat Completions;两者均可正常工作,因为 base URL 以 /v1 结尾。推荐使用模式 2,因为它更明确且更易于调试。
如果选择模式 4,请从 base URL 中移除然后输入模型编号或键入模型名称,例如/v1;Anthropic 客户端会自动追加/v1/messages。
gpt-5.5。请选择文本、推理或代码模型,不要选择图像、视频、Embedding、Whisper 或 TTS 模型。当 Hermes 询问上下文长度时,按 Enter 键自动检测。
快速参考
故障排查
相关
在 OpenClaw 中使用 AIsa
将 AIsa 添加到其他智能体运行时。
通过 MCP 连接
其他客户端的 MCP 配置指南。
模型目录
在选择 Hermes 默认模型前,浏览支持的模型列表。