私域 OS 新手教程

照着这篇做完,你的 Mac 上会有一个守着微信小号的 AI 助理:群里被 @ 时回复,私聊每条都回,还有一个网页工作台看日报和草稿。全程约 30 分钟,不需要写代码。

开始前请先读第 7 节「已知限制」:这个工具能不能在你的微信账号上工作,要装好后跑一次自查才知道。

当前版本 2026.11.18.6 · 2026-11-18 更新(安装包现在从 GitHub 下载,见 2.2;已经装过的看第 8 节「更新」;每一版改了什么见文末「版本记录」)

@所有人:你在「信得过的人」名单里(工作台「群定时消息」那里),在群里 @ 它说「at一下所有人,通知今晚的分享取消」,它就用微信自己的 @所有人 发这条通知,大家都会收到提醒;定时消息里说了 @所有人 也一样。小号要先被设成这个群的管理员,不然只是打出文字「@所有人」,不会提醒人。别人这样说,它照常回答,不 @所有人。

新好友主动问候:有人加小号、你通过以后(在工作台通过或者在手机上通过都算),它会先给对方发自我介绍,开头叫对方的昵称,并记住这个称呼。不想要的话,在「Agent」页「好友申请」卡片里关掉「通过后主动问候」。

看视频号并点评:群里有人发了一条视频号,你(或任何人)引用它再 @ 小号说「点评一下」「从选题、文案、拍摄说说」,它会先回一句「我先把这条视频看完」,然后真的点开把视频看完(画面和声音都看),再分选题、文案、拍摄三部分点评,会具体到视频里的字幕和镜头。自己刚发的视频号,直接 @ 它说「帮我点评一下刚发的视频」也行。需要填了配音用的 Gemini 密钥;视频内容会发给 Google 识别;它看视频的一两分钟里,别的回答会晚一点。直播没法点评。不想要的话,在「Agent」页「能力」里关掉「看视频号并点评」。

看引用的图片:群里有人发了一张图(商品截图、海报、截图都行),你(或任何人)引用这张图再 @ 小号问「这个值得买吗」「帮我比比价」「点评一下」,它会找到那张图、看懂再回答。是商品的话,它会讲这东西主要能做什么、适合什么人、买之前要注意什么;比价时会联网搜一下,说清在哪看到的价格、含不含运费和优惠,搜不到就不编价格,告诉你去哪几个平台比、比哪几项。带价格的比价回答会直接发出;要是说的是跟你本人有关的钱(比如学费),照样存成草稿等你看。同一个人这两天发过好几张图时,它看的是最新那张,对不上会请对方说是哪张。不想要的话,在「Agent」页「能力」里关掉「看别人引用的图片」。

消息推送(接你自己的系统):在「Agent」页「消息推送」里填一个 https 网址,每来一条新消息,它就把消息(哪个会话、谁、说了什么)推给你的系统,带签名,你的系统可以验证是它发的;没推成会自动重试。选「由我的系统决定回复」时,回复内容由你的系统给,照样过发送前的检查(转人工词、金额、链接等,该存草稿的还是存草稿);你的系统没回应时,按你的设置改由 AI 回复或存草稿。你自己的会话不会推出去。默认关闭;签名密钥只显示一次,可以重新生成。

这些都能在工作台「Agent」页单独开关。源码与历次安装包:安装包仓库(见邀请邮件里的链接)(私有仓库,需要先被邀请才能打开)。

它能做什么

它的工作方式是像人一样读微信窗口、打字发送,用的是 macOS 自带的「辅助功能」。它不修改微信,也不读取微信的数据库。

开始前要准备什么

准备项

要求

说明

一台 Mac

macOS 14 或更高,Apple 芯片或 Intel 都可以

要常开、不锁屏。锁屏后它读不了也发不了消息。建议用一台不做别的事的 Mac(比如 Mac mini)。

微信 Mac 版

4.1.7

只在这个版本上验证过。更新的版本可能读不到聊天内容。下载地址见下方。

一个微信小号

专门给它用

不要用主号。自动化操作有被微信限制的风险,这个风险不应该落在主号上。

Claude Code

已安装并登录

写回复和日报默认用它,走你自己的 Claude 订阅。也可以改用 DeepSeek 等 API 写回复,见 4.3。

安装包

GitHub 仓库

见下方 2.2「从 GitHub 下载安装包」。不再用本页附件。

下载

从 GitHub 下载安装包(第一次用 GitHub 看这里)

安装包和每个版本的更新都放在 GitHub 上,不再用本页附件。只想装上用的话,照下面做就行,不用学 git,也不用写代码。

  1. 注册 GitHub 账号:打开 https://github.com/signup,用邮箱注册。
  2. 拿到仓库权限:这个仓库是私有的。把你的 GitHub 用户名发给 James,他邀请你以后,你的邮箱会收到一封 GitHub 的邀请邮件,点里面的 View invitation,再点 Accept invitation。接受之前打开仓库会显示 404,这是正常的,不是链接坏了。
  3. 下载:打开 安装包仓库(见邀请邮件里的链接),点右侧的 Releases,进入最上面那个标着 Latest 的版本,在 Assets 下面点 wechat-agent-版本号-macos.tar.gz 下载。不要点 Source code (zip),那是源码,不是安装包。
  4. 收新版本提醒:在仓库页面右上角点 Watch,选 Custom,勾上 Releases。以后有新版本,GitHub 会发邮件告诉你。

想让 Codex、Claude Code 这类 AI 帮你改代码再交回来:仓库首页的说明里「第二条:拉源码,自己改或者让 AI 改」一步步写了怎么装工具、拉代码、提交改动。

安装

装微信 4.1.7,登录小号

  1. 如果这台 Mac 上已经有别的版本的微信,先退出并把它从「应用程序」里删掉。
  2. 打开下载的 WeChatMac_4.1.7.dmg,把微信拖进「应用程序」。
  3. 打开微信,用小号扫码登录。
  4. 进入微信的 设置 → 通用,界面语言保持中文;如果有自动更新的选项,把它关掉,之后弹出升级提示也不要升级。

装 Claude Code 并登录

  1. 按 官方页面 的说明安装。
  2. 打开「终端」(在启动台里搜「终端」),输入 claude 回车,按提示登录你的 Claude 账号。
  3. 能在里面正常对话,就说明登录好了。输入 /exit 退出。

运行安装脚本

  1. 按 2.2 从 GitHub 下载安装包,双击解压,得到一个 wechat-agent-…-macos 文件夹。
  2. 打开「终端」,输入 cd (后面有一个空格),把这个文件夹拖进终端窗口,回车。
  3. 输入下面这行并回车:
bash install.sh

它会问你两件事:

脚本会把程序装到 ~/wxprobe,并注册后台任务。装完后它会提示还有哪些系统开关没打开,接着做下一步。

打开三个系统开关

这三项只需要做一次。

  1. 远程登录:系统设置 → 通用 → 共享 → 打开「远程登录」。
  2. 辅助功能:系统设置 → 隐私与安全性 → 辅助功能 → 点列表下方的 + → 按 ⌘⇧G,输入 /usr/libexec/sshd-keygen-wrapper 回车 → 点「打开」→ 确认它的开关是开着的。
  3. 屏幕与系统录音:系统设置 → 隐私与安全性 → 屏幕与系统录音 → 用同样的方法添加 sshd-keygen-wrapper 并打开开关。

为什么要开这些:程序通过本机的 SSH 通道去操作微信窗口,macOS 把「能不能看屏幕、能不能点按」的权限记在 sshd-keygen-wrapper 这个系统组件上。安装脚本生成的密钥只允许从本机登录。

让微信可以被读取

微信只有在启动时检测到「旁白」,才会把聊天内容提供给辅助功能。所以每次重启微信都要做一遍:

  1. 完全退出微信(⌘Q)。
  2. 按 ⌘F5 打开「旁白」,等它开始朗读。
  3. 打开微信并登录。
  4. 再按一次 ⌘F5 关掉旁白。
  5. 保持微信主窗口开着,不要最小化。

自查

在刚才的终端里运行:

bash doctor.sh

每一项前面是 ✓ 就说明没问题。出现 ✗ 时,它会在下一行告诉你该做什么,照做后再运行一次。最关键的一行是「能读到微信的会话列表」:这一行是 ✓,工具才能在你的账号上工作。

第一次使用

登录工作台

在这台 Mac 的浏览器里打开 http://127.0.0.1:8787/,用安装时设的密码登录。页面顶部的状态条显示「采集正常」就说明它在工作。要改登录密码,点左侧栏底部的「改密码」,输入当前密码和两遍新密码(至少 10 个字符);改好后其他电脑和手机上的登录都会退出,要用新密码重新登录。

先看草稿,再打开自动发送

刚装好时,所有回复都只存草稿、不会自动发出。建议这样过渡:

  1. 用另一个微信号给小号发一条私聊,再到一个有小号的群里 @ 它一次。
  2. 等 1–2 分钟,在工作台的「草稿」页看它写的回复。
  3. 觉得可以了,进「Agent」页,把「群里被 @ 或被叫到」和「私聊来消息」从「只起草」改成「自动发送」,点「保存设置」。
  4. 再发一条消息试试,这次它会直接回复。

几项值得先改的设置

都在工作台的「Agent」页:

设置

怎么填

默认人设

它是谁、说话什么风格。比如「你是小助理,一个 AI 助理,说话简短友好,不推销」。

私聊第一条:自我介绍

有人第一次私聊时原样发出的一段话:你是谁、能做什么、怎么跟你说。改成你自己的内容。

群里有人问怎么私聊 / 怎么收费

被问到时原样回的一段话。留空的话,这类问题只存草稿等你回。

安静时段

这段时间不主动发言,默认 23:00–08:00。被 @ 和私聊仍然照常回。

用哪个模型

默认 Claude。要用 DeepSeek:「写回复」选 API,地址填 https://api.deepseek.com,模型名填 deepseek-chat,粘贴密钥。DeepSeek 不能看图,「看图片」保持 Claude。

锁屏/采集中断提醒

手机装 ntfy App,起一个别人猜不到的主题名,把 https://ntfy.sh/你的主题名 填进去。Mac 锁屏导致它停工时,手机会收到提醒。

选择要读的群

默认只采集私聊。要让它读某个群(生成日报、被 @ 时回复),到工作台「Agent」页的「读哪些会话」,把这个群的开关打开。点一下立刻生效,不用改配置文件。列表里是它在微信会话列表里见过的会话,刚进的群要等一两分钟才出现。

没打开的群,它看不到里面的任何消息,有人 @ 它也不会回。注意三点:

以前写在 workbench.json 的 chats 里的群照常有效,和这里的开关是同一份名单。

新功能的设置

下面几项也在工作台的「Agent」页:

日常注意

常见问题

现象

怎么处理

自查显示「本机 SSH 连不上」

没有打开「远程登录」,见 3.4 第 1 步。

自查显示「没有辅助功能权限」或「采集失败」

3.4 的第 2、3 步没做全。两个列表里都要有 sshd-keygen-wrapper,并且开关是开着的。

自查显示「这个微信读不到聊天内容」

确认微信是 4.1.7,然后按 3.5 重做一遍。仍然不行,见第 7 节第一条。

工作台顶部变红,显示「屏幕已锁定」

解锁这台 Mac。解锁后它会自己补采;补采期间的回复只存草稿。

工作台显示「Agent 出错」

多半是 Claude Code 登出了或额度用完。在终端运行 claude 重新登录。

群里 @ 了它但没反应

检查三件事:这个群在「Agent」页「读哪些会话」里是打开的(直接被拉进的新群默认不读,见 4.4,或打开「拉群名单」);「Agent」页「这个号的称呼」和小号的微信昵称一致;模式不是「关闭」。

回复进了草稿没发出去

「草稿」页每条下面写着原因。常见的是:一小时或一天发够了条数(几个人在同一个群里测试时最容易撞上,到「Agent」页调高「每个群每小时最多回」)、回答太长分不开、命中转人工关键词、含金额或链接、还在「只起草」模式。每个原因对应改哪项设置,见 GitHub 仓库首页说明里「它有时不回」那张表。

工作台打不开

运行 bash doctor.sh;或看日志 ~/wxprobe/logs/serve.err。

已知限制

不是所有微信账号都能用。我们验证通过的组合是:微信 4.1.7 加一个国际版(WeChat)账号。另一个国内注册的账号在同样的版本上读不到聊天内容;只测过这一个,原因没有查清。所以请以你自己机器上 bash doctor.sh 的结果为准:显示「能读到微信的会话列表」才算可用。

更新与卸载

版本记录

最新的在最上面。你装的是哪一版,看安装包文件夹名字里的日期和后面那串字母数字,或对照下载时的版本号。

版本

日期

改了什么

2026.11.18.6(当前)

2026-11-18

产品名改为「私域 OS」(微信私域 AI 运营系统):新 logo、浏览器图标、手机桌面图标,工作台换新配色,左侧菜单分成 运营 / 客户 / AI,手机上有底部标签栏。新增「消息推送」:新消息推给你自己的系统,也可以由你的系统决定回复(照样过发送前检查)。

2026.11.18.5

2026-11-18

工作台重启时会把最新的网页一起发出去。以前网页只在每天早上 8 点的日报时更新,白天升级后新按钮(比如「改密码」)要到第二天才出现。

2026.11.18.4

2026-11-18

引用商品图问值不值得买:带价格的比价回答直接发出,不再因为「回复含金额」被拦成草稿(第一次真实群里试就被这样拦下,群里只剩一句「稍后给你答复」);说的是跟你本人有关的钱(比如学费),照样存草稿等你看。

2026.11.18.3

2026-11-18

点评别人发的图片时,提到海报上的「扫码」不再被拦成草稿(其他推广语照拦)。

2026.11.18.2

2026-11-18

看引用的图片:群里有人 @ 它并引用一张图片,它会找到那张图、看懂再回答;是商品就讲功能、适合谁、要注意什么,比价只说搜得到的价格和出处,搜不到不编。工作台左侧栏新增「改密码」。

2026.11.18.1

2026-11-18

看视频号并点评:群里有人 @ 它并引用一条视频号说「点评一下」,它会点开把视频看完(画面和声音分开识别),再从选题、文案、拍摄三个角度点评。需要配音用的 Gemini 密钥;视频内容会发给 Google 识别。

2026.11.17.3

2026-11-17

@所有人:你信得过的人在群里让它「at一下所有人,通知…」,它用微信的 @所有人 发这条通知(定时消息也能带);小号要先是这个群的管理员。新好友主动问候:好友通过后(包括你在手机上通过的),它先叫着对方的昵称发自我介绍,并记住这个称呼。

2026.11.17.2

2026-11-17

群里定时发消息支持只发一次:「今天早上 8 点半提醒大家活动取消」会在那天那个时间发一条(以前只认「每天 / 定期」,会回答做不到)。「明天九点提醒我…」这种提醒自己的照旧是个人提醒。

2026.11.17.1

2026-11-17

拉群名单(默认关):名单上的人拉它进群(直接拉或发邀请卡片),它自动开工并在群里打一次招呼;别人拉它进的群不工作。认名字(备注名),不认微信号。

2026.11.16.1

2026-11-16

安装包改到 GitHub 下载(见 2.2);说了「稍等」但正式回答发不出去时在群里补一句;到了每小时或每天上限时说一次「先歇会儿」;确定没发出的自动重试一次;发之前先把关掉的微信窗口找回来;工作台能改最多分几条、转人工后多久不插话、每天接待几个新私聊;群里定时发消息(群友提、你在工作台通过后按时发,默认每天 10 点连发 3 天)。

2026.11.13.1

2026-11-13

工作台里选读哪些会话,被邀请进的群自动加入(先只起草);记住的事(群里的等你确认);到点提醒;做 PPT;每日摘要;能力和权限按会话开关;技能页;外部资料(公开网页);号主指令(默认关);设置的改动记录可退回;每周定时消息;被打断的回答接着答完;从改过的草稿里学。

2026.11.11.7

2026-11-11

语音改为自然人声加带声波的短视频:可接配音服务,固定一个声线,可设语气;没填密钥用 Mac 自带朗读,没装 ffmpeg 发音频文件。

2026.11.11.6

2026-11-11

群成员名单:读出每个群的全部成员,人数变了就重读,记下谁新进群、谁退群、谁改名;问「群里谁是做什么的」「最近谁新进群」时按名单回答。

2026.11.11.5

2026-11-11

回看聊天记录并总结;有人要表格另发 Excel 文件;有人要语音把回答念出来发出;可自动接受指定的人发来的进群邀请(默认关);转人工的词不再误拦普通回答;会话资料里写了的网址可以在该会话里说;每天自动发送上限默认 150 条。

2026.11.11.4

2026-11-11

修复:工作台所有页面空白。2026.11.11 到 2026.11.11.3 都有这个问题,请升级。

2026.11.11.3

2026-11-11

每个会话的资料;联网搜索;群友名字更准。

2026.11.11.2

2026-11-11

生成图片、音乐、视频(默认关),按会话扣积分;群里也读图片和语音;维护暂停满 45 秒才在会话里通知。

2026.11.11

2026-11-11

群里多人同时 @ 每人各回一条;刚回过的人接着说话不用再 @;闲聊几秒内回,认真的事先回「稍等」;回答开头带「@提问的人」;维护暂停。