Install & Setup newtype OS

newtype OS 是面向内容创作场景的多 Agent 编排系统。安装只是第一步，真正的 setup 是接入模型、配置 Agent、初始化项目知识，并把它放进你的日常内容工作流。

newtype OS 的定位不是「又一个 AI 聊天工具」。它更接近一个个人内容生产系统：底层由 OpenCode 驱动，通过 nt 命令启动，内置面向内容创作的 Agent 团队，并把 Skills、Obsidian、微信、命令行工具等能力组织成一套可执行的工作环境。

如果说普通 AI 工具解决的是「这次怎么回答」，newtype OS 解决的是「我怎样长期稳定地生产、研究、写作、归档和复盘」。

安装前准备

安装 newtype OS 之前，先确认三件事。

第一，电脑里需要有 Node.js。newtype OS 通过 npm 发布，如果运行安装命令时报错，最常见原因就是没有安装 Node.js，或者 npm 没有正确出现在终端路径里。先到 Node.js 官网安装稳定版，再回到终端执行安装命令。

第二，准备一个稳定的终端环境。newtype OS 运行在终端里，不是网页应用。系统 Terminal 可以用；如果你希望一边运行 newtype OS，一边查看文档、手动编辑文件，我更推荐 Zed。它对 TUI 的显示更顺，适合把终端、文档和项目文件放在同一个工作界面里。

第三，准备一个内容仓库。newtype OS 最适合进入一个由 Markdown 文件组成的本地资料库，比如你的 Obsidian vault、Newsletter 文件夹、视频脚本库、Wiki 草稿库，或者一个专门用于内容生产的项目目录。

1. Install

newtype OS 以 npm 包的方式发布。全局安装命令是：

npm install -g @newtype-os/cli

安装完成后，在终端输入：

nt

如果能进入 newtype OS，就说明 CLI 已经安装成功。

如果你使用 bun，也可以尝试：

bun install -g @newtype-os/cli

如果之前安装过旧版本，建议先卸载旧包，再重新安装，避免路径、缓存或命令别名冲突。

2. Connect model provider

第一次启动之后，先连接模型供应商。在 newtype OS 里输入：

/connect

系统会显示可用的 provider 列表，比如 OpenAI、智谱、Minimax、GitHub Copilot 等。你可以选择两类方式：

• API key：按量付费，适合已经有模型 API 账户的人。
• Subscription：通过订阅账户接入，适合不想单独管理 API key 的人。

我自己的使用方式是 GitHub Copilot。它的好处是主流模型覆盖比较完整，配置成本低，日常使用也比较省心。

完成 /connect 之后，newtype OS 才真正有模型可以调用。只安装 CLI 但没有连接 provider，系统还不能进入完整工作状态。

3. Configure Agent models

连接 provider 之后，需要给不同 Agent 配置模型。在 newtype OS 里输入：

/agent-models

你会看到 Agent 列表，以及每个 Agent 当前使用的模型。选择某个 Agent 之后，再从 provider 提供的模型列表里指定它要使用的模型。

这里的关键不是「所有 Agent 都用最强模型」，而是「不同角色使用合适模型」。Chief 负责理解目标和拍板结果，通常需要更强的判断能力；researcher 需要稳定检索和整理资料；writer、editor、fact-checker 的任务也各不相同。全部塞给最贵或最强的模型，未必更快，也未必更划算。

newtype OS 的 Agent 团队通常包括：

• Chief：主编，负责理解目标、制定标准、拍板结果。
• Deputy：副主编，负责承接任务、拆解执行、保护 Chief 的上下文。
• researcher：负责外部搜索和资料收集。
• writer：负责把素材转成结构化初稿。
• editor：负责精修、风格统一和表达优化。
• fact-checker：负责事实核查。
• archivist：负责知识库检索和归档。
• extractor：负责复杂文档解析与提取。

模型配置完成后，newtype OS 才算进入可长期使用的状态。

4. Open your content repository

newtype OS 的关键不是「安装完能不能打开」，而是「它进入哪个项目工作」。

通常做法是先进入你的内容仓库目录，再启动 nt：

cd /path/to/your/content-repo
nt

这个内容仓库可以是 Obsidian vault，也可以是一个普通 Markdown 文件夹。你的素材、笔记、草稿、Newsletter、视频脚本、输出结果，最好都能以文件夹方式组织。

一个起步结构可以是：

project/
  01-INPUT/
  02-PROCESSING/
  03-OUTPUT/
  README.md

01-INPUT 用来存放原始资料，比如网页剪藏、YouTube transcript、文章、PDF 转出的 Markdown。

02-PROCESSING 用来存放 AI 处理过程中的中间结果，比如研究摘要、资料卡片、周报、初步分析。

03-OUTPUT 用来存放最终作品，比如 Newsletter、视频脚本、Wiki 页面、产品文档。

这个结构不是强制规则，而是一个起点。newtype OS 背后的设计哲学是「万物皆文件」：文件夹结构、命名约定和 Markdown 文档本身，就构成了 AI 可以理解和执行的工作环境。

5. Initialize project knowledge

进入内容仓库之后，先让 newtype OS 理解这个项目。在 newtype OS 里输入：

/init-deep

/init-deep 会读取仓库里的文档，理解这个项目的主题、内容、结构和已有资料，并生成 KNOWLEDGE.md。这个文件相当于项目背景说明，让 Agent 不是从一片空白开始工作，而是先知道「这里有什么」「你长期在做什么」「哪些内容已经存在」。

对内容创作者来说，这是 setup 里非常关键的一步。没有项目知识，AI 只能临场理解；有了 KNOWLEDGE.md，它才开始拥有可复用的项目上下文。

6. Initialize Chief personality

接下来初始化 Chief 的工作人格。在 newtype OS 里输入：

/init-soul

/init-soul 会生成 SOUL.md。这个文件定义 Chief 如何与你协作：它怎样理解你的偏好、如何保持判断标准、应该用什么方式推进任务、怎样在内容生产中扮演主编角色。

newtype OS 的 Chief 人格可以理解成两层：

• 里人格：系统内置的底层行为规范，保证 Chief 不是随意发挥的聊天对象，而是稳定工作的主编。
• 表人格：写在 SOUL.md 里的可编辑协作风格，你可以根据自己的偏好调整。

KNOWLEDGE.md 让系统理解项目，SOUL.md 让 Chief 理解你。这两个文件加起来，才是 newtype OS 从「工具」变成「个人工作系统」的开始。

7. Start with Chief

日常使用时，不需要你手动判断「这个任务该交给哪个 Agent」。直接和 Chief 对话就可以。

你可以说：

• 帮我根据这个文件夹里的资料，整理一个选题框架。
• 把这篇草稿改成 Newsletter 版本。
• 分析我最近的输出，找出可以扩展成 Wiki 页的主题。
• 根据这些资料，先做深度分析，再给出文章大纲。

Chief 会判断任务类型，拆解步骤，并调用合适的 Agent 或 Skills。比如需要深度分析时，系统可以调用 Super Analyst；需要写作时，可以把资料交给 writer；需要修订时，再进入 editor 和 fact-checker 的流程。

这也是 newtype OS 和普通聊天工具的区别：你面对的不是一个单点模型，而是一套有主编、有分工、有流程的内容生产系统。

Optional: WeChat setup

如果你希望 newtype OS 接入微信，可以使用内置的 WeChat 能力。它基于 WeClaw 项目整合而来。

先执行：

nt wechat setup

按照提示用微信扫码登录。

之后启动微信能力：

nt wechat start

这一步不是每个人都必须做。它适合希望让 AI 读取、整理或辅助处理微信信息流的人。

Optional: Let other Agents call newtype OS

newtype OS 也可以被其他 Agent 当作一个专业内容团队来调用。如果你正在使用 OpenClaw 或其他 Agent 系统，可以在相关项目里执行：

nt init

它会把 newtype OS 的调用方式注入为 Skill，让外部 Agent 知道：当任务涉及研究、写作、编辑、归档、内容生产时，可以调用 newtype OS 这支专业团队。

这一步适合更高级的工作流：不是人直接打开 newtype OS，而是让另一个 Agent 在需要内容生产能力时调用它。

Setup checklist

完成安装之后，可以按这个清单检查：

• Node.js 和 npm 已经可用。
• npm install -g @newtype-os/cli 安装成功。
• 输入 nt 可以启动 newtype OS。
• 已通过 /connect 连接模型 provider。
• 已通过 /agent-models 给关键 Agent 配置模型。
• 已在内容仓库中运行 /init-deep，生成 KNOWLEDGE.md。
• 已运行 /init-soul，生成 SOUL.md。
• 如果需要微信能力，已完成 nt wechat setup 和 nt wechat start。
• 如果需要让其他 Agent 调用 newtype OS，已在对应项目里运行 nt init。

常见问题

为什么安装后还不能正常使用？

因为安装只是把 CLI 放进电脑里。你还需要通过 /connect 连接模型 provider，并通过 /agent-models 配置 Agent 模型。没有模型，Agent 团队就没有真正的执行能力。

必须用 Zed 吗？

不必须。系统 Terminal、iTerm、Warp 都可以运行 newtype OS。Zed 的优势是把终端、文件树和文档编辑放在同一个工作空间里，适合内容创作者边看边改。

必须手动选择 Agent 吗？

不需要。日常使用时直接和 Chief 对话。Chief 会根据任务判断是否需要 researcher、writer、editor、fact-checker、archivist 等角色介入。

每个 Agent 都要用最强模型吗？

不需要。不同 Agent 的任务不同，模型配置也应该不同。所有角色都用最强模型，可能浪费成本，也不一定带来更好的速度和结果。

newtype OS 和 Claude Code / OpenCode 是什么关系？

Claude Code 和 OpenCode 是 Agent 框架，提供执行环境。newtype OS 是在这个基础上，针对内容创作场景定制的系统：它不是只帮你写代码，而是帮你研究、写稿、编辑、归档和复盘。

下一步

完成 setup 之后，不要一上来就让 newtype OS 承担一个巨大项目。先用一个小任务校准系统：

• 让它根据一组资料生成主题摘要。
• 让它帮你整理某篇文章的核心观点。
• 让它围绕一个选题生成 Newsletter 初稿。
• 让它分析你已有内容中可以扩展成 Wiki 页的主题。

newtype OS 的价值不是安装命令，而是安装之后逐步长出来的工作系统。