接入模型
人格要接上 AI 模型才能思考和说话。有两条路:Claude 订阅,或者自己的 API Key。两条可以同时开着,每个人格各选各的。
不会配?
直接问人格:「我有一个 DeepSeek 的 key,怎么接?」它会告诉你每一步点哪里。
两个地方,各管一件事
| 在哪 | 管什么 |
|---|---|
| 系统设置(主窗口右上角「设置」) | 存「钥匙」:Claude 订阅、API Key。存着不等于在用。 |
| 人格管理 → 某个人格 → 「AI」页 | 这个人格用哪把钥匙、哪个引擎、哪个模型。 |
先在系统设置里存好,再到人格那边选用。
方式一:Claude 订阅
有 Claude Pro 或 Max 订阅,就能让人格用订阅来跑。
- 打开系统设置 →「模型服务」→「Claude 订阅」,点「开启」。
- 确认后会下载 Anthropic 的 Claude Agent SDK(约 110 MB),下载完点「立即重启」。
- 重启后点「登录 Claude」,在浏览器里登录授权。
- 看到「已开启并登录」就好了。
然后到人格的「AI」页,「接入方式」选「用订阅账号」。
方式二:API Key
存一把 Key
打开系统设置 →「模型服务」→「API 凭据」,点「+ 加一条」,先点你用的那家:

列表里有 Claude、OpenAI、Google Gemini、千问(大陆 / 国际)、豆包、DeepSeek、Kimi、智谱 GLM、MiniMax、xAI Grok、Mistral。点了之后地址自动填好,你只要把服务商给的 Key 粘进去。不在列表里的(比如各种网关),点「其他 · 自己填地址」,填上网关给的地址和 Key。
填完点「保存」,再点「测试」确认能连上。可以存多条。勾了「默认」的那条,是人格没选凭据、或选的那条被删掉时用的。
让人格用它
新建人格时,接入方式选用 Key,再在「要多聪明?」里点一档:「最强 · 很贵」「强」「日常 · 推荐」「省钱」。程序当场在这把 Key 上试出这一档能用的模型;这把 Key 上已经有人格在用的模型,会标「这把 key 上用过」。想自己指定型号,展开「自己选型号」。
已经建好的人格,到人格管理 → 这个人格 →「AI」页改:
- 接入方式:选「用系统设置里存的 key」,再选是哪一条。
- 引擎:一般选「Butler 引擎(多模型)」。
- 模型:从下拉里选;列表里没有的,选「其它 · 手动输入模型名」自己填。

改完要重新打开这个人格才生效。
手填模型名的写法
从下拉里选的模型名已经带好了前缀,不用管。手填时:走 OpenAI 兼容接口的(千问、豆包、Kimi 和大多数网关)前面加 compat/,如 compat/qwen-plus;OpenAI 官方前面加 openai/;Claude 直接写型号。不确定就先点「测试」,或者问人格。
在顶栏直接换
想常换模型,打开系统设置 →「通用」→「快速切换模型」,勾「在顶栏显示」。主窗口人格名字右边会出现「key · 模型 ▾」,点开就能给当前人格换 Key 和模型。换 Key 时人格会先把手头的对话存进记忆,再重新打开。
两种引擎有什么区别
| Butler 引擎(多模型) | Claude Code | |
|---|---|---|
| 是什么 | 全能管家自带的 | Anthropic 官方的 Claude Agent SDK |
| 能接的模型 | Claude、OpenAI、国内大模型、各种网关 | 只有 Claude |
| 什么时候用 | 用 API Key 时的默认选择 | 用 Claude 订阅时自动用它 |
用订阅的人格固定走 Claude Code;用 Key 的人格两种都能选,「引擎」这一项只有装了 Claude 订阅组件后才会出现。
联网搜索
用 Butler 引擎时,人格默认用模型自带的搜索(有的模型没有)。搜不了或想换,见 联网搜索。
常见问题
人格说「还没选模型,暂时无法回复」 去人格管理 → 这个人格 →「AI」页选一个模型。
报 401 或「key 不对」 系统设置里那条 Key 点「测试」。不通就重新复制粘贴一遍 Key,注意前后不要带空格。
报 400,有时好有时坏 多半是网关或服务商那边临时拒收,等一会儿再发。一直这样,换一条线路试试,或者把报错原文发给人格让它帮你看。
想让几个人格用不同的模型 每个人格的「AI」页各选各的,互不影响。
