Skip to content

接入模型 ​

人格要接上 AI 模型才能思考和说话。有两条路:Claude 订阅,或者自己的 API Key。两条可以同时开着,每个人格各选各的。

不会配?

直接问人格:「我有一个 DeepSeek 的 key,怎么接?」它会告诉你每一步点哪里。

两个地方,各管一件事 ​

在哪管什么
系统设置(主窗口右上角「设置」)存「钥匙」:Claude 订阅、API Key。存着不等于在用。
人格管理 → 某个人格 → 「AI」页这个人格用哪把钥匙、哪个引擎、哪个模型。

先在系统设置里存好,再到人格那边选用。

方式一:Claude 订阅 ​

有 Claude Pro 或 Max 订阅,就能让人格用订阅来跑。

  1. 打开系统设置 →「模型服务」→「Claude 订阅」,点「开启」。
  2. 确认后会下载 Anthropic 的 Claude Agent SDK(约 110 MB),下载完点「立即重启」。
  3. 重启后点「登录 Claude」,在浏览器里登录授权。
  4. 看到「已开启并登录」就好了。

然后到人格的「AI」页,「接入方式」选「用订阅账号」。

方式二:API Key ​

存一把 Key ​

打开系统设置 →「模型服务」→「API 凭据」,点「+ 加一条」,先点你用的那家:

系统设置里的 API 凭据:先点厂家

列表里有 Claude、OpenAI、Google Gemini、千问(大陆 / 国际)、豆包、DeepSeek、Kimi、智谱 GLM、MiniMax、xAI Grok、Mistral。点了之后地址自动填好,你只要把服务商给的 Key 粘进去。不在列表里的(比如各种网关),点「其他 · 自己填地址」,填上网关给的地址和 Key。

填完点「保存」,再点「测试」确认能连上。可以存多条。勾了「默认」的那条,是人格没选凭据、或选的那条被删掉时用的。

让人格用它 ​

新建人格时,接入方式选用 Key,再在「要多聪明?」里点一档:「最强 · 很贵」「强」「日常 · 推荐」「省钱」。程序当场在这把 Key 上试出这一档能用的模型;这把 Key 上已经有人格在用的模型,会标「这把 key 上用过」。想自己指定型号,展开「自己选型号」。

已经建好的人格,到人格管理 → 这个人格 →「AI」页改:

  1. 接入方式:选「用系统设置里存的 key」,再选是哪一条。
  2. 引擎:一般选「Butler 引擎(多模型)」。
  3. 模型:从下拉里选;列表里没有的,选「其它 · 手动输入模型名」自己填。

人格的「AI」页

改完要重新打开这个人格才生效。

手填模型名的写法

从下拉里选的模型名已经带好了前缀,不用管。手填时:走 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」页各选各的,互不影响。

Apache-2.0 Licensed