安装 OWL Compose

让 Agent 帮你安装 OWL Compose

复制这段话，发给能执行命令的 Agent。安装和检查交给它，你通过链接连接账号。

macOS · Linux · Windows

请阅读 https://owlcompose.com/install.md，按照指南为当前 Agent 安装并配置 OWL Compose。检查运行环境，安装 CLI 和配套 Skill，连接我的 OWL Compose 账号，并验证安装和登录状态。需要我完成注册、登录或授权时，请给我链接和核对码；完成后继续检查，直到可以使用。不要在对话中显示访问凭据。

把指令发给 Agent
打开链接连接账号
由 Agent 完成安装验证

手动安装、更新与排障

安装

npx 会下载最新官方包，把该版本持久安装为 ow 命令，并进入账号与技能配置。以后升级仍运行这条命令。

终端

npx --yes @owlcompose/cli@latest setup --target auto --device --remote https://owlcompose.com

更新

重新运行安装命令。CLI 与内嵌 Agent Skill 会一起更新到同一个最新版本。

npx --yes @owlcompose/cli@latest setup --target auto --device --remote https://owlcompose.com

验证安装

运行 doctor 检查 CLI 和技能文件，然后重启 Agent 或开启新会话以加载已安装的技能；doctor 不检查当前会话是否已加载。

终端

ow --version
ow agent doctor --target auto
ow status --remote https://owlcompose.com

05 · Quickstart

下一步：发表第一份文档

创建下面的最小 OWX 作者源，跑完本地校验链，只发表生成的 Render Document JSON。

预期结果：本地生成 document.json 与 digest；publish 返回作者管理页；Hosted 作品保持私密，直到作者显式创建限时 view link。

my-work/document.owx

<ow-document canvas="briefing" language="en" owx-version="1" title="Decision brief">
  <section id="overview">
    <h2>Decision</h2>
    <ow-text body="State the decision, evidence, and next action." id="summary" title="Decision brief" title-level="1" />
  </section>
</ow-document>

终端

ow a2ui check ./my-work/document.owx
ow a2ui fmt ./my-work/document.owx
ow a2ui compile ./my-work/document.owx --output ./my-work/document.json
ow a2ui digest ./my-work/document.json
ow login
ow publish ./my-work/document.json

打开快速入门查看 CLI 参考

CLI 维护

排障与卸载

重新登录（可选）

安装命令已处理登录，并会复用仍有效的已保存凭证。仅在需要重新登录时运行以下命令。凭证保存在项目目录之外。

ow setup --device --relogin --target auto --remote https://owlcompose.com

排查安装问题

先检查 Node.js、npm 和 doctor。如果安装后找不到 ow，检查 npm 全局命令目录是否在 PATH 中；不要用 sudo 修复 npm 权限。

node --version
npm --version
ow agent doctor --target auto

卸载

先移除 CLI 管理的 Skill，再卸载全局 npm 包。该操作不会删除作品或账号凭据。

ow agent uninstall --target all
npm uninstall --global @owlcompose/cli