English reader? Start here: Open English README

2ndSelf

把聊天后的输入，变成一个会继续工作的第二个自己。

2ndSelf 是一套 local-first 的第二大脑系统，围绕 OpenClaw + Obsidian 构建。
它不是笔记模板，也不是又一个聊天壳子。它的目标是：

• 接住真实输入：聊天、Hippo、Drop、文件、URL
• 把输入变成当前可执行的工作面
• 把真正有长期价值的内容沉淀成知识与 skills
• 让相似任务下次不再从零开始
• 在支持范围内自动发布成 OpenClaw 原生 SKILL.md

Language: 中文 | English

整个系统架构

flowchart LR
    A["真实输入<br/>main / Hippo / Drop / 文件 / URL"] --> B["接住与分拣<br/>watchers / intake / classifier"]
    B --> C["当前工作面<br/>Work Surface / Intake / Briefs"]
    B --> D["记忆与技能沉淀<br/>preference / skill / tool / durable memory"]
    C --> E["Obsidian 工作台<br/>当前任务、收件、状态"]
    D --> F["长期正式层<br/>Decisions / Projects / Playbooks / Content Angles"]
    F --> G["下次复用<br/>相似任务更快进入状态"]
    D --> G

Loading

它和常见 second brain 有什么不一样

大多数工具只解决一小段问题：

• 要么只是“收集”
• 要么只是“聊天”
• 要么只是“写进 Obsidian”

2ndSelf 想把这几件事接成一个闭环：

1. 输入真的被接住 不是贴完就没了，而是会进入 intake。
2. 系统会形成工作面 不只是回答一句，而是告诉你现在该做什么。
3. 系统会沉淀长期价值 值得留下的才会进入正式知识层。
4. 系统会复用经验 做过一次的任务，下次不该完全重新来。

你会得到什么

• 一个能接聊天、文本、URL、文件的本地输入层
• 一个 Obsidian 里的主工作台，而不是一堆散页
• 一套会逐渐沉淀的长期知识层：
  • 10 Decisions
  • 20 Projects
  • 30 Playbooks
  • 40 Content Angles
• 一套会逐渐成型的可复用工作能力：
  • preferences
  • skills
  • tool memory
  • second-self memory
• 一组健康检查与发布门槛，确保它不是只能演示的 demo

3 分钟跑起来

先说清楚，这里的“一键安装”指的是把 2ndSelf 这一层 自动配置起来，不是从一台空白机器把所有上游软件都装完。

在当前 alpha 支持边界里，建议你先手工确认这些前置条件已经具备：

• git
• node
• npm
• 本地 OpenClaw 已经可用，并且 ~/.openclaw 已存在
• Obsidian 已经安装
• 你准备好了一个 Obsidian vault，或者愿意先用 demo vault
• macOS 用户需要允许本地 launchd / 桌面相关能力
• Linux 用户需要 Ubuntu 24.04 + systemd --user

如果你还没有 Obsidian，可以先让 OpenClaw 帮你安装。

先装 Obsidian：macOS 提示词

先不要安装 2ndSelf。先帮我把这台 macOS 机器上的 Obsidian 安装到可用状态。

按下面顺序完成：

1. 先检查 Obsidian 是否已经安装；如果已经安装，告诉我应用路径，并确认它可以正常打开。
2. 如果没有安装，优先使用标准 macOS 路线安装 Obsidian；如果机器上有 Homebrew，优先用 `brew install --cask obsidian`。
3. 如果缺少 Homebrew，但可以安全地补齐 Homebrew 并继续安装，就继续；如果不适合自动补齐，就明确告诉我 blocker 和最短手工步骤。
4. 安装完成后，再次确认 Obsidian.app 的路径，并验证它已经可用。
5. 最后只告诉我三件事：Obsidian 是否已经装好、应用路径是什么、如果没装好卡在了哪一步。

不要假装完成。如果因为权限、包管理器或系统限制不能自动安装，就停在最后一个 blocker。

先装 Obsidian：Ubuntu/Linux 提示词

先不要安装 2ndSelf。先帮我把这台 Ubuntu 24.04 Linux 机器上的 Obsidian 安装到可用状态。

按下面顺序完成：

1. 先检查 Obsidian 是否已经安装；如果已经安装，告诉我可执行路径或启动方式，并确认它可以正常启动。
2. 如果没有安装，优先使用这台机器上已经可用的标准安装方式。优先顺序是：已有 snap 就走 snap；已有 flatpak 就走 flatpak。
3. 如果 snap 可用，优先安装 Obsidian；如果 flatpak 可用，也可以安装官方应用源里的 Obsidian。
4. 如果缺少可用的安装通道，不要假装完成，明确告诉我 blocker 和最短手工步骤。
5. 安装完成后，再次确认 Obsidian 已经可用，并告诉我启动命令或桌面入口。
6. 最后只告诉我三件事：Obsidian 是否已经装好、启动方式是什么、如果没装好卡在了哪一步。

不要假装完成。如果因为权限、包源、snap/flatpak 不可用或系统限制不能自动安装，就停在最后一个 blocker。

如果你只想先把 alpha 跑起来，直接执行：

npm install
npm run setup-alpha -- --demo-vault

在这些前置条件已经满足时，安装流程会自动尝试完成：

• 依赖检查
• config.local.json 生成
• demo vault 准备
• 按 profile 自动安装 Hippo / Drop / watcher / 本地刷新任务
• OpenClaw skill 发布路径自动配置
• 安装级 runtime 隔离，避免 demo / 真实安装互相污染
• 从内部 skill memory 自动编译、验收并发布 OpenClaw 原生 skills
• 基础验收

安装完成后，只有下面这一条是绿的，才算真的装好了：

npm run release-gate

默认 demo vault 会生成在仓库内的 runtime/demo-vaults/...，安装运行态会落到 runtime/installs/...，这样反复试装不会把主运行态顶掉。

当前默认支持两个安装档位：

• macOS Full Mode
  • 安装 Hippo / Drop / watcher / launchd 本地刷新任务
  • 走完整 core + desktop release gate
• Linux Core Auto Mode
  • 目标平台是 Ubuntu 24.04 + systemd --user
  • 自动安装 watcher / refresh timers / sync-distill-memory-skill-publish 主链
  • 不承诺 Hippo 桌面等价体验

给 OpenClaw 的一段提示词安装

如果你想让自己的 OpenClaw 直接帮你把 2ndSelf 配到可用状态，先把仓库拉到本机：

git clone https://github.com/TianyiDataScience/2ndSelf.git
cd 2ndSelf

然后让 OpenClaw 打开这个 repo，再把下面整段提示词贴给它。

如果用户还没有 Obsidian，先用上面的 Obsidian 提示词把 Obsidian 装好，再继续下面这两段 2ndSelf 安装提示词。

使用这些提示词前，请先了解：

• 这些提示词会尽量在当前官方支持边界里，把 2ndSelf 配到可用状态。
• 它们主要负责 2ndSelf 的本地配置、watcher、refresh jobs、skill publish，以及 vault/runtime 布局。
• 如果你还没有准备好 Obsidian、OpenClaw、Node、npm、git 这些基础环境，请先准备好，再继续下面的安装提示词。
• 最终是否安装成功，请以 npm run release-gate 是否通过为准。
• 如果遇到系统权限、上游依赖缺失、包管理器不可用，或者超出支持边界的问题，OpenClaw 会停在最后一个 blocker，并明确告诉你当前卡在了哪里。

macOS Full Mode 提示词

适用于 macOS 用户，目标是跑通完整支持面：Hippo、Drop、watcher、launchd 刷新任务、OpenClaw native skill publish。前提是 Obsidian、OpenClaw、Node 这些上游环境已经存在。

你现在在我的本地机器上安装 2ndSelf alpha。当前仓库已经 clone 到本地，并且你就在仓库根目录。目标平台是 macOS，支持档位是 macOS Full Mode。目标是在支持边界内把系统尽量装到可用状态。请直接执行安装和配置，不要只给计划；如果因为系统权限、上游依赖缺失或超出支持边界而无法完成，就停在最后一个 blocker，并明确告诉我，不要假装已经装好。

按下面顺序完成：

1. 先检查前置条件：`git`、`node`、`npm`、本地 OpenClaw 工作目录 `~/.openclaw`、Obsidian 是否已经存在且可用。这里优先做检查和路径确认；如果缺的是上游软件本体，就明确告诉我 blocker，不要把这一段说成 repo 自己已经完成了所有基础软件安装。
2. 如果我没有给真实 Obsidian vault 路径，优先使用 demo vault；如果我给了真实 vault 路径，就改用 `npm run setup-alpha -- --vault /ABSOLUTE/PATH/TO/YOUR/VAULT`。
3. 在仓库根目录运行 `npm install`。
4. 运行 `npm run setup-alpha -- --demo-vault`，或者在我给了真实 vault 路径时运行真实 vault 命令。
5. 如果中途报错，继续修复依赖、目录、权限、服务安装和本地配置问题，然后重跑，直到 setup 走完。
6. 检查并修复 `config.local.json`，确认至少这些字段正确：`openclawHome`、`openclawSkillsDir`、`supportProfile`=`macos-full`、`serviceManager`=`launchd`、`desktopDir`、`dropDir`、`hippoAppPath`、`serviceDefinitionDir`、`launchAgentsDir`、`workspaceDir`、`runtimeDir`、`generatedSkillStagingDir`、`skillPublishMode`=`publish`、`memosRuntimeDir`、`sessionDir`、`vaultDir`、`userPath`、`longMemoryPath`、`workspaceMemoryDir`、`hippoEnabled`=`true`、`desktopBridgeEnabled`=`true`、`obsidianRefreshEnabled`=`true`。
7. 确认 macOS Full Mode 相关能力已经安装或可用：Hippo app、Drop bridge、main watcher、launchd jobs、Obsidian refresh jobs、OpenClaw native skill publish path。
8. 运行 `npm run release-gate`，只有全部通过才算完成；如果不能通过，就停下来并给我精确 blocker。
9. 最后明确告诉我：`config.local.json` 在哪里、demo vault 或真实 vault 在哪里、runtime 目录在哪里、generated OpenClaw skill staging 目录在哪里、Hippo / Drop / watchers / refresh jobs 是否安装成功、OpenClaw native skills 是否发布成功、我应该先在 Obsidian 打开哪一页、还有哪些仍然是 alpha-only 或需要手工处理；如果没有完全装好，也要明确说是哪一步没过。

Linux Core Auto Mode 提示词

适用于 Linux 用户，当前官方支持边界是 Ubuntu 24.04 + systemd --user。这一档位承诺 core automation，不承诺 Hippo 桌面等价。前提是 Obsidian、OpenClaw、Node 这些上游环境已经存在。

你现在在我的本地机器上安装 2ndSelf alpha。当前仓库已经 clone 到本地，并且你就在仓库根目录。目标平台是 Ubuntu 24.04，支持档位是 Linux Core Auto Mode。目标是在支持边界内把系统尽量装到可用状态。请直接执行安装和配置，不要只给计划，也不要假装有 Hippo 桌面等价能力；如果因为系统权限、上游依赖缺失或超出支持边界而无法完成，就停在最后一个 blocker，并明确告诉我。

按下面顺序完成：

1. 先检查前置条件：`git`、`node`、`npm`、`systemctl --user`、本地 OpenClaw 工作目录 `~/.openclaw`、Obsidian 是否已经存在且可用。这里优先做检查和路径确认；如果缺的是上游软件本体，就明确告诉我 blocker，不要把这一段说成 repo 自己已经完成了所有基础软件安装。
2. 如果我没有给真实 Obsidian vault 路径，优先使用 demo vault；如果我给了真实 vault 路径，就改用 `npm run setup-alpha -- --vault /ABSOLUTE/PATH/TO/YOUR/VAULT`。
3. 在仓库根目录运行 `npm install`。
4. 运行 `npm run setup-alpha -- --demo-vault`，或者在我给了真实 vault 路径时运行真实 vault 命令。
5. 如果中途报错，继续修复依赖、目录、权限、systemd --user 服务安装和本地配置问题，然后重跑，直到 setup 走完。
6. 检查并修复 `config.local.json`，确认至少这些字段正确：`openclawHome`、`openclawSkillsDir`、`supportProfile`=`linux-core`、`serviceManager`=`systemd-user`、`desktopDir`、`dropDir`、`serviceDefinitionDir` 指向 `~/.config/systemd/user`、`workspaceDir`、`runtimeDir`、`generatedSkillStagingDir`、`skillPublishMode`=`publish`、`memosRuntimeDir`、`sessionDir`、`vaultDir`、`userPath`、`longMemoryPath`、`workspaceMemoryDir`、`obsidianRefreshEnabled`=`true`。不要要求 Hippo app，也不要把 Linux 说成已经有 Hippo 桌面等价。
7. 确认 Linux Core Auto Mode 相关能力已经安装或可用：main watcher、`systemd --user` services 或 timers、sync / distill / memory / brief refresh automation、OpenClaw native skill publish path。
8. 运行 `npm run release-gate`，只有全部通过才算完成；如果不能通过，就停下来并给我精确 blocker。
9. 最后明确告诉我：`config.local.json` 在哪里、demo vault 或真实 vault 在哪里、runtime 目录在哪里、generated OpenClaw skill staging 目录在哪里、安装了哪些 `systemd --user` units 或 timers、OpenClaw native skills 是否发布成功、我应该先在 Obsidian 打开哪一页、还有哪些仍然是 manual、alpha-only，或者超出当前 Linux 支持边界；如果没有完全装好，也要明确说是哪一步没过。

如果你已经有真实 Obsidian vault

npm run setup-alpha -- --vault /ABSOLUTE/PATH/TO/YOUR/VAULT

如果你更喜欢交互式引导：

npm run setup-alpha-wizard

装好后先看哪里

第一次打开 Obsidian，只看这几页就够了：

• Welcome.md
• 80 Dashboards/Support/Main Work Surface.md
• 00 Inbox/Main Intake.md
• 80 Dashboards/Support/Main Durable Knowledge Hub.md

不要先去研究全部目录树。
这套系统应该先从“入口页和工作面”开始用。

当前支持边界

这版 alpha 现在官方支持两个边界：

• macOS Full Mode
  • macOS
  • 本地 OpenClaw
  • Obsidian vault
  • launchd 本地任务
  • Hippo / Drop / watcher / 刷新任务 / 完整 gate
• Linux Core Auto Mode
  • Ubuntu 24.04
  • 本地 OpenClaw
  • Obsidian vault
  • systemd --user
  • 自动 watcher / 自动 distill / 自动 memory / 自动发布 OpenClaw skills

在这个支持边界里，它现在的目标就是：

• 一条命令装起来
• 自动开始沉淀并发布真正可用的 OpenClaw skills

它还不是：

• 脱离上述边界后的“所有人零配置安装”
• Windows 正式支持
• Linux Hippo 桌面等价支持
• 完成态消费级产品

发布门槛

下面这些不过，就不能叫“安装成功”：

npm run validate-alpha-install
npm run validate-obsidian-tree-layers
npm run self-check
npm run audit-system
npm run open-source-readiness

快捷方式：

npm run release-gate

这个仓库里最值得先看的文件

• OPEN_SOURCE_ALPHA_GUIDE.md
• OPEN_SOURCE_ALPHA_RELEASE_NOTES.md
• SUPPORT_MATRIX.md
• PRIVACY_AND_PERMISSIONS.md
• ERROR_SEMANTICS.md
• ALPHA_COSTS.md
• OBSIDIAN_TREE_LAYERS.md
• VIDEO_DEMO_KIT.md
• MATURITY_CHECKLIST.md
• config.example.json

docs 入口

这个 repo 也带了一个简化的 docs scaffold：

• docs/getting-started.md
• docs/release-gates.md
• docs/demo-vault.md
• docs/obsidian-layers.md
• docs/hippo-desktop.md

它现在还不是什么

• 不是一个“只会回答问题”的聊天机器人
• 不是一个纯 Obsidian 模板包
• 不是一个托管式 SaaS
• 不是已经面向大众发售的正式产品

它现在更准确的状态是：

一个可以日常使用、可以对外演示、可以给技术用户试装的 open-source alpha。