Sentō 能跑在 macOS 上,但有个限制:macOS 没有像 Linux 那样的 systemd 和持久的用户级 cron session,所以智能体只在你 Mac 开着、你也启动了它的时候跑。任何需要 24/7 在线的场景,用 VPSDocker 更合适。

macOS 是唯一支持 iMessage 频道的主机,因为 iMessage 需要本地访问 Messages 数据库。

前提条件

  • macOS 13(Ventura)或更高版本
  • Node 20+(brew install node 或从 nodejs.org)
  • 一个 Claude 订阅(Pro 或 Max) — 认证在安装时自动完成

安装

npx sentoagent init

和 VPS 安装同样的流程。安装器检测到 macOS 会跳过 Linux 特有的 cron 持久化步骤。

iMessage 特定配置

如果你选了 iMessage 作为频道,还需要给你的终端"完全磁盘访问"权限:

  1. 系统设置 → 隐私与安全性 → 完全磁盘访问
  2. +,导航到 应用程序 → 实用工具 → 终端(或 iTerm、Warp、Ghostty,你用的那个)
  3. 打开它
  4. 重启你的终端

没这个,Sentō 读不了 ~/Library/Messages/chat.db,iMessage 智能体就收不到消息。

安装之后

智能体跑在一个 tmux session 里。检查它:

tmux attach -t <agent-name>

Ctrl-b d 分离,sento status 从外面检查。

重启后恢复

macOS 不自动重启智能体。重启后运行:

sento start

或者如果想要完全自动启动,自己在 ~/Library/LaunchAgents/ 里写一个 launchd plist 脚本 —— 默认不带。

开发用途

macOS 是开发 Sentō 本身最方便的环境(贡献代码、测试插件补丁等)。克隆 repo,从你的 dev checkout 运行 node bin/sento.js init 代替 npx