常见问题

遇到问题，第一步永远是把情况告诉人格：报错原文、你做了什么、期望是什么。它能看到很多你看不到的东西，多数问题它自己就能查清楚。

安装和启动

Mac 第一次打开时问「确定要打开吗」 这是系统对所有从网上下载的 App 的提醒，点「打开」即可。安装包签了名，也通过了苹果的公证。

Windows 提示「Windows 已保护你的电脑」 点「更多信息」→「仍要运行」。

人格不说话

「还没选模型，暂时无法回复」 人格管理 → 这个人格 →「AI」页，选一个模型。

报 401、key 不对 系统设置 →「模型服务」→「API 凭据」，那一条点「测试」。不通就重新复制粘贴 Key，注意前后别带空格。用订阅的，看「Claude 订阅」那里是不是还显示「已开启并登录」。

报 400，时好时坏 多半是网关或服务商临时拒收，过一会儿再发。一直这样，换一条线路，或者把报错原文发给人格。

回复里出现「网络断了，连着重试了 6 次都没接上」 模型服务中途断开时，程序会自己重试，断掉前显示的半句话会撤掉。6 次都没接上才出这句提示，等一会儿再发一次就行。

改了设置没生效 接入方式、模型、搜索这类设置，改完要重新打开那个人格。

记忆

它不记得刚才说的话 聊得太长时人格会整理上下文，重新开始一段对话，聊天原话不会全部带过去，但要紧的事它已经记进了记忆。想让它记住的，明说「记住：……」。

它记错了 直接纠正：「不对，应该是……」。它会改掉旧的那条。

通道

机器人收不到消息 全能管家要开着；打开这个人格，看卡片是不是「运行中」。飞书、钉钉改了权限或事件后要重新发布版本；Discord 要打开「Message Content Intent」。详见 通道。

搜索

搜不到东西 看 联网搜索。在中国大陆，加一个 Tavily 通常就能解决。

数据在哪

所有数据都在你自己的电脑上。Mac 默认在 ~/Library/Application Support/butler，Windows 默认在 %APPDATA%\butler。每个人格的资料在建人格时选的目录里。

想知道现在放在哪、或者想搬到别的盘：打开系统设置 →「高级」→「数据位置」。这里显示当前路径，「打开文件夹」直接在访达或资源管理器里打开；「搬到别处…」选好新目录后，程序会先重启，把整份数据复制过去，复制成功才切换，原来那份保留不动，你确认没问题再自己删。

同一个数据文件夹只能开一个全能管家。已经开着一个时再打开，会直接切到已开的那个窗口。