在 AstrBot 中接入小马算力（TokenPony）作为对话模型

如果你已经在用 AstrBot 搭聊天机器人，但内置 AI 一直没接上模型，或者想换一个更省事的模型来源，那么把 TokenPony（小马算力）接进来是个直接的选择。它提供兼容 OpenAI 风格的接口与 API Key，AstrBot 也内置了对应的提供商类型，因此不需要写代码，只要在 WebUI 里填几项配置就能完成对接。这篇教程面向已经部署好 AstrBot、能打开 WebUI 的读者，从头走一遍「创建密钥 → 新增提供商 → 拉取并启用模型 → 测试 → 绑定到配置文件」的完整流程。如果你还想了解站内其他算力与模型接入工具的用法，可以看小马算力这一条目。

准备工作

动手之前，先把下面几样东西备齐，后面每一步都会用到。

一个可用的 AstrBot 实例：已经部署完成，并且能通过浏览器打开它的 WebUI。部署方式不限，Docker、面板、命令行都可以，只要 WebUI 能正常登录即可。
一个小马算力账号：需要先注册并登录。没有账号的话，后面的 API Key 无从谈起。
一个 API Key：在小马算力的 API Keys 页面新建。这个 Key 相当于密码，创建后请立刻复制留存，不要发到公开的群聊或仓库里。
要使用的模型名称：在小马算力的模型页面挑选一个准备用于对话的模型，把它的名称准确记下来。后面在 AstrBot 里启用模型、或者手动填写自定义模型 ID 时，都要和这个名字对得上。
API Base URL：AstrBot 选择 TokenPony 类型后通常会带出默认地址，保存前确认一下它与你账号实际使用的接入地址一致即可。

这里有一个容易被忽略的点：API Key 和模型名称是两个独立的信息。很多人只记了 Key，到模型列表那一步发现拉不到想要的模型，又得回头去小马算力页面重新查。建议在开始配置前，把 Key 和模型名称一起放在手边的记事本里。

操作步骤

第一步：在小马算力侧创建 API Key

登录小马算力后，进入 API Keys 页面，新建一个 API Key。创建完成后页面会显示这串密钥，把它复制下来留存备用。如果页面上提供了备注或命名功能，建议按用途起个名字，比如「AstrBot 对话」，这样以后要轮换或吊销时不会搞混。

需要提醒的是，密钥的显示通常只在创建时完整出现一次，关掉页面后可能就看不到了。如果确实没保存，一般只能重新创建一个新的 Key，再把 AstrBot 里的旧配置替换掉。

第二步：在小马算力侧确认模型名称

接着进入模型页面，浏览可用的模型，挑一个适合对话场景的，把模型名称完整记录下来。注意记录的是模型 ID 或名称本身，不是页面上展示的中文别名或宣传标题。后面在 AstrBot 里如果自动拉取列表失败，需要手动填「自定义模型」时，填的就是这个名称。

第三步：在 AstrBot 中新增 TokenPony 提供商

回到 AstrBot 的 WebUI，按下面的路径操作：

打开左侧或顶部的「模型提供商」页面。
切换到「对话」分类。
点击「新增」按钮。
在提供商类型列表中选择 TokenPony。

选中类型后会进入配置表单，需要填写的内容主要有三项：

提供商名称：自己起一个便于识别的名字，比如「tokenpony-chat」。这个名字只用于在 AstrBot 内部区分不同的提供商条目，不影响实际调用。
API Key：粘贴第一步创建的那串密钥。
API Base URL：确认地址正确。选择 TokenPony 类型时一般会预填默认值，除非你明确知道自己需要换地址，否则保持默认即可。

填完之后点击「保存并获取模型」。这一步会带着你填的 Key 去请求模型列表，成功的话页面会展示出可用的模型。

第四步：启用需要的模型

模型列表出来之后，找到你要用的那个模型，点击它右侧的 + 号，把它加入已启用列表。确认该模型处于启用状态，否则即使提供商配置正确，AstrBot 也不会拿它来对话。

如果自动拉取没有成功，或者列表里没有你想要的模型，还有一条备用路径：先点「保存配置」，再通过「自定义模型」手动填写准确的模型 ID。这里填写的名称必须和小马算力模型页面上显示的一致，多一个空格或大小写不对都可能导致调用失败。

第五步：测试模型是否可用

已配置的模型旁边一般会有「测试模型」按钮，点一下就能检查这条链路是否通。测试通过说明 Key、Base URL、模型名称三者都对得上；如果报错，优先回头检查这三项，尤其是模型名称是否与平台侧完全一致。

第六步：把对话模型绑定到配置文件

提供商配好只是「可用」，还要告诉 AstrBot 在哪个配置文件里用它。操作路径是：

进入「配置文件」页面。
选择你要使用的那份配置文件。
找到「AI」→「模型」这一组设置。
把「对话模型」设为刚刚添加并启用的那个模型。
点击右下角的「保存配置」。

这一步是让 AstrBot 内置 AI 生效的关键。很多人在提供商页面看到模型已启用就以为完事了，结果机器人回复仍然是默认行为，原因就是配置文件里的「对话模型」还指向别处或者为空。

一个完整示例

下面把整个流程串一遍，假设你要给一个已经部署好的 AstrBot 接入小马算力的对话模型。

平台侧准备

注册并登录小马算力。
在 API Keys 页面新建一个 Key，复制保存，记为 sk-xxxxxxxx。
在模型页面选定一个对话模型，记下它的名称，记为 your-model-id。

AstrBot 侧配置

浏览器打开 AstrBot WebUI 并登录。
进入「模型提供商」→「对话」→「新增」。
提供商类型选择 TokenPony。

填写表单：

提供商名称：tokenpony-chat
API Key：sk-xxxxxxxx
API Base URL：（保持默认，确认与账号实际接入地址一致）

点击「保存并获取模型」，等待模型列表返回。
在列表中找到 your-model-id，点击右侧 + 启用。
点击该模型旁的「测试模型」，确认返回正常。

绑定到配置文件

进入「配置文件」，选中目标配置文件。
在「AI」→「模型」中，把「对话模型」设为 your-model-id。
点击右下角「保存配置」。

完成后，AstrBot 的内置 AI 就会使用这条 TokenPony 的模型链路来生成回复。如果之后想换模型，只需回到模型提供商页面启用另一个模型，再在配置文件里把「对话模型」改过去并保存即可，不必重新创建提供商。

注意事项

模型名称必须精确匹配：自动拉取失败而改用手动填写「自定义模型」时，模型 ID 要和平台侧完全一致。名称对不上是这类接入最常见的失败原因。
「保存并获取模型」依赖网络与密钥：这一步会实时请求模型列表，如果 Key 填错、Base URL 不对或者网络不通，列表就出不来。此时不要反复点，先核对 Key 和地址。
启用与绑定是两件事：在提供商页面点 + 只是把模型加入可用集合；真正决定 AstrBot 用哪个模型对话的，是配置文件里「AI」→「模型」下的「对话模型」选项。两步都做完才算配置完成。
密钥要妥善保管：API Key 泄露意味着他人可以消耗你的额度。不要把 Key 写进公开仓库、截图或群聊；怀疑泄露时应在平台侧吊销并重新创建。
价格、配额与可用模型以官网当前信息为准：小马算力的计费方式、额度限制、模型上下架情况都可能调整，配置前请以平台页面当时展示的信息为准，本文不给出具体数字。
多份配置文件要分别设置：如果你的 AstrBot 里有多份配置文件，每份都需要单独指定「对话模型」，改了一份不会自动同步到其他份。

按上面的顺序走完，从创建密钥到绑定配置文件，整条链路就通了。之后无论是换模型还是加新的提供商，都可以沿用同一套思路：先在平台侧拿到 Key 和模型名称，再在 AstrBot 里新增、启用、测试，最后回到配置文件里指定。