跳转到主要内容
在 GitHub 上查看 -> 将 AIsa 用作 OpenClaw 模型 provider。 配置 OpenClaw,通过一个网关访问 Qwen、DeepSeek、Kimi、GLM 以及其他模型。

安装

如果还没有安装 AIsa CLI,请先安装:
npm install -g @aisa-one/cli
然后安装该技能:
aisa skills install aisa-provider

Agent 可以用它做什么?

OpenClaw 设置

使用 AIsa provider 配置 OpenClaw。

中文 LLM 路由

使用 Qwen、DeepSeek、GLM 和其他中文模型。

全球模型

将提示路由到 GPT、Claude、Gemini 等模型。

Agent 运行时默认值

为 OpenClaw 工作流标准化模型选择。

快速设置

方式 1:环境变量(最快)

export AISA_API_KEY="your-key-here"
OpenClaw 会自动检测 AISA_API_KEY,并将 AIsa 注册为 provider。不需要修改配置文件。

方式 2:交互式引导

openclaw onboard --auth-choice aisa-api-key

方式 3:CLI 传入 key

openclaw onboard --auth-choice aisa-api-key --aisa-api-key "your-key-here"

方式 4:在 ~/.openclaw/openclaw.json 中手动配置

{
  "models": {
    "providers": {
      "aisa": {
        "baseUrl": "https://api.aisa.one/v1",
        "apiKey": "${AISA_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "aisa/qwen3-max",
            "name": "Qwen3 Max",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 256000,
            "maxTokens": 16384,
            "supportsDeveloperRole": false,
            "cost": {
              "input": 1.20,
              "output": 4.80,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aisa/qwen3-max"
      }
    }
  }
}

可用模型

默认模型(预配置,API 已验证 ✅)

模型Model ID适合场景上下文Reasoning已验证
Qwen3 Maxaisa/qwen3-max复杂推理、旗舰任务256K
Qwen Plusaisa/qwen-plus-2025-12-01主要生产模型256K
Qwen MT Flashaisa/qwen-mt-flash高频、轻量任务256K
DeepSeek V3.1aisa/deepseek-v3.1高性价比推理128K
Kimi K2.5aisa/kimi-k2.5Moonshot 旗舰推理模型128K

⭐ Kimi K2.5 — Moonshot AI 旗舰模型

Kimi K2.5 是 Moonshot AI 最新推理模型,可通过 AIsa 访问,价格约为 Moonshot 官方价格的 80% 主要特性:
  • 强推理和多步问题求解
  • 在代码和数学基准上有竞争力
  • 通过 AIsa 的 Moonshot 合作渠道提供

🔒 零数据保留(ZDR)——企业级隐私

通过 AIsa 访问 Kimi K2.5 时,具备企业级零数据保留保障。用户无需担心数据隐私:AIsa 已与 Moonshot AI 签署正式 ZDR 协议。 根据 AIsa 与 Kimi(Moonshot AI PTE. LTD.)之间的 Supplemental Enterprise Service Agreement(2026 年 2 月 10 日生效):
  • Moonshot 处理后不会保留客户数据
  • Moonshot 基础设施不会存储生成结果
  • 不会将数据用于模型训练 —— 你的 prompts 和 completions 保持私密
  • 处理过程受企业合同条款约束,而非消费者 ToS
这让 AIsa 成为隐私敏感或企业工作负载访问 Kimi K2.5 的推荐路径。直接调用 Moonshot 消费者 API 时会适用普通消费者数据政策;通过 AIsa 路由时,你的数据享受谈判后的 ZDR 保护。 ⚠️ 重要:Temperature 限制 Kimi K2.5 只接受 temperature=1.0。使用其他值会返回错误:
Error: invalid temperature: only 1 is allowed for this model
如果 OpenClaw 配置或 Agent 设置了不同 temperature,请为 Kimi 覆盖配置:
/model aisa/kimi-k2.5
未显式设置时,OpenClaw 会使用模型默认 temperature。 Kimi K2.5 价格对比(每 1M tokens):
指标AIsaMoonshot 官方节省
Input/1M~$0.60~$0.75~20% off
Output/1M~$2.40~$3.00~20% off
实际价格可能变化。请查看 https://console.aisa.one/pricing 获取实时费率。

通过 AIsa 可用的更多模型

用户可以把 AIsa 支持的任意模型加入配置。完整目录包含 49+ 个模型 Qwen 系列(8 个模型):
  • qwen3-maxqwen3-max-2026-01-23qwen-plus-2025-12-01
  • qwen-mt-flashqwen-mt-lite
  • qwen-vl-maxqwen3-vl-flashqwen3-vl-plus(视觉模型)
DeepSeek(4 个模型):
  • deepseek-v3.1deepseek-v3deepseek-v3-0324deepseek-r1
Kimi / Moonshot(2 个模型):
  • kimi-k2.5kimi-k2-thinking
还包括: Claude 系列(10)、GPT 系列(9)、Gemini 系列(5)、Grok 系列(2)等。 列出所有可用模型:
curl https://api.aisa.one/v1/models -H "Authorization: Bearer ***"

Model ID 版本管理

AIsa 对部分模型使用带版本的 model ID。如果遇到 503 - No available channels,model ID 可能需要更新。 已知 model ID 映射:
常用名称正确 AIsa Model ID❌ 不可用
Qwen Plusqwen-plus-2025-12-01qwen3-plusqwen-plusqwen-plus-latest
Qwen Flashqwen-mt-flashqwen3-flashqwen-turboqwen-turbo-latest
Qwen Maxqwen3-max(可直接使用)
DeepSeek V3.1deepseek-v3.1(可直接使用)
Kimi K2.5kimi-k2.5(可直接使用)
检查最新 model ID:
curl https://api.aisa.one/v1/models -H "Authorization: Bearer ***"

切换模型

在聊天(TUI)中:
/model aisa/qwen3-max
/model aisa/deepseek-v3.1
/model aisa/kimi-k2.5
通过 CLI:
openclaw models set aisa/qwen3-max

价格对比(每 1M tokens)

以下价格仅供参考。实时价格可能变化,请始终查看 https://console.aisa.one/pricing 获取最新费率。

Qwen MT Flash(轻量)

  • AIsa0.05input/0.05 input / 0.30 output(约官方零售价 50% off
  • Bailian 官方:0.10/0.10 / 0.40
  • OpenRouter:0.110.13/0.11-0.13 / 0.45-0.50

Qwen Plus(生产)

  • AIsa0.30input/0.30 input / 0.90 output(约官方零售价 25% off
  • Bailian 官方:0.40/0.40 / 1.20
  • OpenRouter:0.450.50/0.45-0.50 / 1.35-1.50

Qwen3 Max(旗舰)

  • AIsa1.20input/1.20 input / 4.80 output(约官方零售价 40% off
  • Bailian 官方:2.00/2.00 / 8.00
  • OpenRouter:2.202.50/2.20-2.50 / 9.00-10.00

Kimi K2.5(Moonshot 旗舰)

  • AIsa:约 0.60input/0.60 input / 约 2.40 output(约官方 Moonshot 价格 20% off
  • Moonshot 官方:约 0.75/0.75 / 约 3.00
  • OpenRouter:供应有限

规模化成本:Qwen-Max 每月 500M tokens

  • OpenRouter:约 $4,000-4,250/月
  • Bailian 官方:约 $3,400/月
  • AIsa:约 2,040/月(每年节省2,040/月(**每年节省 16,320-26,520**)

官方合作关系

AIsa 与以下厂商保持已验证合作:
  • 阿里云 —— Qwen Key Account(完整模型家族,3 个全球区域:中国、美国弗吉尼亚、新加坡)
  • BytePlus —— 字节跳动 Doubao
  • DeepSeek —— 通过阿里云集成
  • Moonshot —— Kimi K2.5 集成,并具备企业零数据保留(ZDR)协议(2026 年 2 月 10 日生效)

Qwen 区域支持

AIsa 通过阿里云在 3 个全球区域提供 Qwen 模型访问:
  • 🇨🇳 中国(默认)
  • 🇺🇸 美国(弗吉尼亚)
  • 🇸🇬 新加坡
这来自 AIsa 的 Key Account 身份。OpenRouter 或免费 Qwen Portal 等其他 provider 通常只通过中国区路由。

响应延迟(2026 年 2 月测试)

模型平均延迟评级
Qwen3 Max~1,577 ms⭐⭐⭐⭐⭐ 最快
Qwen MT Flash~1,918 ms⭐⭐⭐⭐ 快
Kimi K2.5~2,647 ms⭐⭐⭐ 中等
DeepSeek V3.1~3,002 ms⭐⭐⭐ 中等
Qwen Plus~8,207 ms⭐⭐ 较慢

故障排查

“503 - No available channels” 错误

model ID 可能错误或过期。查看上方 Model ID 版本管理 章节获取正确 ID。常见修复:
  • qwen3-plus -> 使用 qwen-plus-2025-12-01
  • qwen3-flash -> 使用 qwen-mt-flash

“Model not found” 错误

确保 OpenClaw 配置中的 model ID 使用 aisa/ 前缀:
✅ aisa/qwen3-max
❌ qwen3-max

Kimi K2.5 “invalid temperature” 错误

Kimi K2.5 只接受 temperature=1.0。如果配置中设置了其他值,请添加模型级覆盖或让 OpenClaw 使用默认值。

Kimi K2.5 空响应

少数情况下 Kimi K2.5 可能返回空内容但消耗输出 tokens。重试请求即可,这通常是瞬时问题。

未检测到 API key

  1. 检查环境变量:echo $AISA_API_KEY
  2. 或检查配置:openclaw config get auth.profiles
  3. 重新运行引导:openclaw onboard --auth-choice aisa-api-key

Streaming 不工作

AIsa 使用 OpenAI-compatible API(openai-completions)。确保配置包含:
"api": "openai-completions"

速率限制或每日上限

AIsa 没有每日请求限制(不同于免费 Qwen Portal 的 2,000 req/day 上限)。

获取 API Key

  1. 访问 https://console.aisa.one/
  2. 注册并创建 API key
  3. 将其设置为 AISA_API_KEY,或使用 onboarding wizard

说明

  • AIsa 端点兼容 OpenAI:https://api.aisa.one/v1
  • 所有模型支持 streaming 和 function calling
  • Qwen 模型的 supportsDeveloperRole 设置为 false
  • 默认上下文窗口:256,000 tokens(Qwen)或 131,072 tokens(DeepSeek/Kimi)
  • 所有默认模型都启用 reasoning(thinking)
  • Kimi K2.5 要求 temperature=1.0,其他值会报错
  • 通过 AIsa 使用 Kimi K2.5 受企业零数据保留(ZDR)保护:数据不会被保留或用于训练
  • 图像/视频生成模型(WAN)可用,但需要单独配置
  • AIsa API 总共支持 49+ 个模型;使用 models 端点发现所有可用选项

开始使用

  1. aisa.one 注册(新账户有 $2 免费额度)。
  2. 从控制台生成 API key。
  3. 设置 key 并安装技能:
    export AISA_API_KEY="your-key"
    npm install -g @aisa-one/cli
    aisa skills install aisa-provider
    
  4. 启动新的 Agent 会话,让运行时加载更新后的技能说明。

相关

快速设置:在 OpenClaw 中使用 AIsa

推荐的 OpenClaw 设置路径。

AIsa CN-LLM Route

将中文提示路由到中文 LLM。

AIsa LLM Router

在支持的模型之间路由提示。