常见问题

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

安装和启动

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。每个人格的资料在建人格时选的目录里。