1. 为什么要在 iOS 上折腾一个开源 AI 助手Kelivo 是一个手机端开源 AI 助手客户端能在 iOS 上直接调用 OpenAI API 格式的模型服务支持自定义供应商、多模型切换、流式响应和本地保存 API Key。它适合两类人一类是手里已经有 OpenAI 兼容接口、想在手机上随时对话的开发者另一类是不想被单一模型绑定、希望一个 App 里同时挂 GPT、Qwen、DeepSeek 的普通用户。我平时在电脑上写代码用命令行工具但出门在外只有手机时临时想验证一段逻辑、查一个报错、让模型帮我改几句文案掏出笔记本并不现实。Kelivo 解决的就是这个场景App Store 直接下载配置一个 Base URL 和 API Key就能把手机变成一个可切换模型的 AI 终端。它本身不提供模型只负责把请求发到你配置的服务端所以选一个稳定、模型全、接入简单的 API 平台就成了关键。这篇就按 iOS 实机流程从拿 Key 到配置供应商、添加模型、发请求验证一步步跑通并把我踩过的几个坑写清楚。2. 前置准备TaoToken 账号与 API KeyKelivo 需要一个 OpenAI 兼容的接口地址和密钥。我这边用的是 TaoToken它的接口格式和 OpenAI 一致Kelivo 里选 OpenAI 类型供应商就能直接对接不用改代码。先到官网注册并登录https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后进入控制台找到 API Keys 管理页新建一个密钥。建议按用途命名比如kelivo-ios方便以后区分和吊销。创建后立刻复制保存页面刷新后通常不再完整显示。控制台地址https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要记住两个值后面填进 Kelivo配置项值说明Base URLhttps://taotoken.net/api不带 UTM直接作为接口根地址API Key控制台复制的那串只显示一次丢了就重建注意Base URL 末尾不要自己加/v1或斜杠Kelivo 会按 OpenAI 规范拼接路径多写反而容易 404。具体以接入文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content3. Kelivo 安装与供应商配置骨架3.1 iOS 安装步骤打开 App Store搜索 Kelivo确认开发者为开源项目对应主体后安装。当前主要是 iOS 版本Android 可以关注项目仓库的更新动态。安装完成后首次打开界面是干净的对话列表没有广告和强制登录。3.2 添加 OpenAI 类型供应商点左上角调出侧边栏进「设置」选「供应商」右上角「」在类型里选「OpenAI」。这一步很关键Kelivo 把 OpenAI 兼容接口统一归到这个类型下TaoToken 正好符合。填写三个字段名称随便写比如TaoTokenAPI Key粘贴刚才复制的密钥Base URLhttps://taotoken.net/api保存后回到供应商列表能看到刚建的条目。此时先别急着聊天还要加模型。3.3 添加模型并测试连通进「设置」→「模型」→「」输入模型名。模型名要和平台支持的标识一致比如gpt-4o、qwen3、deepseek-chat这类。填完保存回到供应商配置页点「测试」。显示测试成功说明 Key、地址、模型三者都对上了。如果测试失败先看下面第 5 节的排查表八成是 Base URL 多写了路径或 Key 带了空格。4. 验证请求从测试按钮到真实对话配置完成后做一次端到端验证确认不是只有测试按钮能过。第一步在聊天界面顶部选择刚添加的模型。第二步输入一句简单的话比如「用一句话说明什么是流式响应」。正常情况下文字会逐字出现这就是流式响应在工作。第三步观察返回速度和内容完整性如果卡住不动或报错回到设置检查模型名。想更贴近实际用途可以试一条组合指令用 Python 写一个读取 CSV 并统计每列缺失值的函数要求带类型注解和简短注释。模型返回代码后长按可以复制历史记录会自动保存支持搜索和导出 Markdown。我实测下来日常问答和代码片段的响应比较稳定切换模型也不用重新填 Key在聊天界面顶部直接换就行。对于需要长期在手机上做编码辅助、Agent 类任务的情况可以考虑 Coding Plan额度模型更省心https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content只想先验证模型效果用模型对话页快速试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content5. 本篇常见错误排查配置过程中最容易卡在几个固定位置对照下面处理。现象可能原因处理方式测试失败 401API Key 错误或已删除回控制台重建重新粘贴注意别带首尾空格测试失败 404Base URL 多写了/v1或结尾斜杠改成https://taotoken.net/api模型列表拉不到模型名拼写不符用平台文档里的准确标识别用展示名对话无响应网络环境或额度问题换网络重试检查账户额度流式输出中断模型名对应服务不支持流式换一个支持流式的模型再试还有一个隐蔽的坑iOS 键盘有时会把复制的 Key 自动补一个空格肉眼看不出来粘贴后手动删一下末尾再保存。另外 Kelivo 的 Key 是本地存储换设备要重新配置这是开源客户端的正常设计不是 bug。6. 继续用下去的几个建议跑通之后建议把常用模型固定两三个比如一个通用对话、一个代码专用避免每次翻列表。系统角色可以在设置里预设比如「你是简洁的代码助手只给可运行代码和必要说明」这样每次新对话不用重复交代。历史记录定期导出 Markdown 备份换手机时直接留档。Kelivo 的定位是客户端模型能力来自你配置的服务端所以接口的稳定性和模型覆盖度决定了最终体验。TaoToken 的接入文档里有完整的参数说明和示例遇到路径、鉴权细节可以直接查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要新建或管理密钥时走这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你也在 iOS 上用 Kelivo建议先把测试按钮跑绿再发第一条真实请求顺序别反能省不少排查时间。
