每天免费2000次调用!ModelScope免费API接入Hermes Agent和OpenClaw完整教程

API 费用太高,是很多人用 AI Agent 半途放弃的真正原因。好消息是,阿里旗下的 ModelScope 提供了每天 2000 次免费调用,够你把 Hermes Agent 和 OpenClaw 跑起来了。

🎯 这篇文章能帮你解决什么

不讲安装,只讲接入。你已经有跑得动的 Hermes Agent 或 OpenClaw,现在只需要一个便宜、简单、兼容 OpenAI 调用方式的 API。往下看就对了。

先说结论:为什么是 ModelScope API Inference?

ModelScope 是阿里旗下的 AI 模型社区,它的 API Inference 服务有几个关键优势:

  • 免费额度:注册用户每天 2000 次 免费调用
  • 兼容 OpenAI:接口地址换成 ModelScope 的就行,代码不用改
  • 接入简单:一个 Token + 一个 URL,两样东西搞定

对于生活助理、工作助理、信息整理这些高频但轻量的场景,2000 次/天通常够用了。

接入前你只需要准备两样东西

api_key

你的 ModelScope Token(下面会教你怎么拿)
base_url

https://api-inference.modelscope.cn/v1

model 不算额外准备项,是在具体 Agent 配置流程里现场选的。

第一步:获取 ModelScope Token

⚠️ 前置条件

使用 API Inference 之前,需要先绑定阿里云账号并完成实名认证。这一步跳过了,后面全白搭。

完成认证后,登录 ModelScope,左侧找到“访问控制”,你会看到默认令牌,也可以自己新建一个。

📌 操作路径

ModelScope 首页 → 左侧菜单「访问控制」→ 使用默认令牌 或 新建访问令牌 → 复制 Token

第二步:在 Hermes Agent 里接入

拿到 Token 之后,打开终端输入:




Terminal
$ hermes model

进入配置界面后,按以下步骤操作:

1

选择 More providers…
在 provider 列表中找到并选择
2

选择 Custom endpoint
手动填写一个兼容 OpenAI 的接口地址
3

填写 base_url
https://api-inference.modelscope.cn/v1
4

粘贴 api_key
把刚才复制的 ModelScope Token 粘进去
5

选择模型
验证通过后会自动拉取模型列表,输入编号选择即可
6

Context length 设为 512000+
建议拉高一点,不然跑长任务会截断

配置完,直接启动会话:




Terminal
$ hermes

第三步:给 OpenClaw 也接上同一套 API

先打开配置界面:




Terminal
$ openclaw config

配置步骤:

1

Gateway → Local (this machine)
2

配置部分 → Model
3

Provider → Custom Provider
4

填写 base_url
https://api-inference.modelscope.cn/v1
5

粘贴 api_key
6

Endpoint compatibility → Unknown (detect automatically)
7

去 ModelScope 模型库复制 Model ID
找带”推理 API-Inference”标识的模型,格式如 Qwen/xxx、MiniMax/MiniMax-M2.7
8

粘贴 Model ID + 给模型起个别名
比如 kimi、qwen、minimax,好记就行
9

Continue → 完成配置

配置完之后重启 Gateway 并启动 TUI:




Terminal
$ openclaw gateway restart
$ openclaw tui

💡 上下文不够?

如果发现模型上下文太短,编辑配置文件把 contextWindow 调到 512000




~/.openclaw/openclaw.json
$ nano ~/.openclaw/openclaw.json

怎么判断接通了没有?

不用跑复杂任务,发三句简单的话试试就知道:




测试消息
> 介绍一下你自己
> 帮我整理今天的待办
> 总结这段文字的重点

如果能正常返回结果,说明已经接通了。如果报错,优先排查这几项:

🔍 常见问题排查

  • Token 填写错误或已失效
  • base_url 写成了别的地址
  • 选的模型当前不可用
  • OpenClaw 的 contextWindow 太小

最后说一句实话

这套服务适合这些场景:

✅ 适合 ❌ 不适合
日常生活助理 高并发生产环境
普通工作助理 强 SLA 业务
轻量自动化流程 正式线上生产
个人项目验证 需要稳定商业方案

免费 API 会根据平台压力动态调整速率限制,这是正常现象。但如果你的目标只是先低成本跑起来,它已经非常够用了。

📚 参考资料


🦞 觉得有用?关注小龙虾宝贝,我会持续分享 AI 工具和编程技巧的最新动态 🦞

评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注