Owlia Nest：给远程 PA 装一个随手可看的文档站 🦉

如果你把 PA，比如 OpenClaw，跑在远程服务器上，大概率遇到过这个糟心场景：

PA 明明把报告、日志、代码、图片都生成好了。

结果链接是这样的：

/home/ubuntu/openclaw/output/report.md
/opt/pa/runs/2025-xx-xx/result.json

你人在手机上。

打不开。

你人在公司电脑上。

还得 SSH 上去 cat 一下，或者开远程桌面翻文件夹。

这事不大，但每天来几次，真的烦。

Owlia Nest 要解决的就是这个痛点：把 PA 机器上的产出目录，直接变成一个可以用浏览器访问的文档站。

配合 Tailscale，你在手机、平板、电脑上打开一个内网地址，就能看 PA 生成的所有文件。

不用 SSH。 不用远程桌面。 不用把文件搬来搬去。

爽点很直接。🪺

Owlia Nest 适合谁？

你有下面任意一种情况，就值得装一下：

• PA 跑在远程服务器上
• OpenClaw、agent、自动化脚本会持续生成文件
• 产出里有 Markdown、txt、json、yaml、py、png 之类的文件
• 你经常在手机上想看运行结果
• 你不想每次都 SSH 到机器上翻目录
• 你已经在用 Tailscale 组内网

举个具体场景。

你下班路上想看 OpenClaw 刚跑出来的调研结果。以前你得打开电脑，连服务器，找目录，下载文件。

现在你只要打开手机浏览器：

http://<你的主机>/docs/

报告直接出来。

这才像个能用的自动化系统。

它到底做了什么？

Owlia Nest 可以理解成一个“给 PA 产出目录用的轻量文件浏览网站”。

它部署在 PA 所在的机器上，然后监控你指定的目录。

只要目录里出现文件，它就能在网页里展示。

常见文件都能直接预览：

• Markdown：渲染成文章页面
• txt：直接阅读
• py：代码高亮
• json：结构化查看
• yaml：配置内容可读化
• png / jpg：图片预览
• 其他文件：按文件形式浏览或下载

你不用给每个文件单独写页面。

PA 生成什么，它就展示什么。

这点特别适合 agent 类工具。因为 agent 的产出经常不是一个文件，而是一堆中间文件、日志、草稿、分析结果。

以前这些东西藏在服务器目录里，像个黑箱。

现在它们都能被看见。

核心功能一览

1. 自动监控目录

你可以指定一个或多个目录。

比如：

/home/ubuntu/openclaw/output
/home/ubuntu/pa/workspace
/opt/agents/runs

PA 一边跑，Owlia Nest 一边更新页面。

你不用手动刷新目录结构。

适合这种工作流：

OpenClaw 生成报告 → 写入 output 目录 → Owlia Nest 自动展示 → 手机打开查看

少一步操作，少一次烦躁。

2. 多种文件直接预览

文档类、配置类、代码类、图片类都能看。

比如 PA 生成了一个 Markdown 报告：

# 竞品分析

## 关键结论

- 产品 A 的价格策略更激进
- 产品 B 的社区运营更强
- 产品 C 的文档做得更细

网页里会按文章形式渲染。

不是一坨原始文本。

再比如 agent 写了一个 JSON：

{
  "task": "market_research",
  "status": "done",
  "files": ["summary.md", "raw_notes.txt"]
}

你也能直接查看。

不用下载到本地再找编辑器打开。

3. 主题可切换，亮暗自适应

Owlia Nest 内置 5 套主题。

包括常见的：

• GitHub
• Nord
• Dracula
• 其他适合阅读和代码查看的主题

亮色、暗色可以自适应。

晚上躺床上看 PA 输出，不会被白屏闪瞎。

这个细节很小，但很救命。

4. 配合 Tailscale，多设备随手看

Owlia Nest 最舒服的用法，是和 Tailscale 放在一起。

Tailscale 把你的服务器、手机、电脑放到同一个私有网络里。

然后你就可以在任意设备上访问：

http://<你的主机>/docs/

比如：

http://pa-server/docs/

或者：

http://100.x.x.x/docs/

具体地址看你的 Tailscale 设备名和 IP。

这比公网暴露安全多了。

也省得折腾 Nginx、域名、HTTPS、访问控制一大堆东西。

个人用、团队内网用，够清爽。

5. 支持 PWA，手机上像 App 一样用

Owlia Nest 支持 PWA。

在 iOS 或 Android 上，你可以把它添加到主屏幕。

操作方式大概是：

• 手机浏览器打开 Owlia Nest 页面
• 点分享按钮
• 选择“添加到主屏幕”
• 下次直接点图标打开

打开之后就像一个原生 App。

你甚至可以把它放在手机第一页。

PA 跑完任务，掏手机点一下，就能看结果。

这个感觉很不一样。

推荐部署方式

仓库地址：

https://github.com/zhixianio/owlia-nest

部署思路很简单：

1. 把 Owlia Nest 放到 PA 所在机器上
2. 配置它要监控的目录
3. 启动服务
4. 用 Tailscale 地址访问
5. 把页面加到手机主屏幕

如果你平时用 PA 帮你执行命令，也可以直接把 GitHub 链接扔给它，让它按项目说明完成 setup。

比如你可以这样对 PA 说：

请在当前服务器上部署 Owlia Nest：
https://github.com/zhixianio/owlia-nest

需求：
- 监控 /home/ubuntu/openclaw/output
- 服务路径使用 /docs/
- 只允许 Tailscale 内网访问
- 配置为后台运行
- 部署完成后告诉我访问地址

这类任务很适合交给 PA。

它装工具，你喝咖啡。☕

目录怎么配置更顺手？

别一上来就监控整个服务器。

真的没必要。

建议你给 PA 的产出单独规划目录。

比如：

/home/ubuntu/pa_outputs/
├── openclaw/
│   ├── runs/
│   ├── dreams/
│   └── reports/
├── research_agent/
│   ├── daily/
│   └── archive/
└── scripts/
    └── logs/

这样 Owlia Nest 展示出来也清楚。

你打开页面就知道自己要看哪里。

推荐目录命名方式：

项目名 / 日期 / 任务名

比如：

/home/ubuntu/pa_outputs/openclaw/2025-01-20_competitor_research/

这样过几周回来翻，也不会变成“文件坟场”。

排除规则要认真配

Owlia Nest 支持排除子目录和文件类型。

这个功能别忽略。

推荐排除这些东西：

node_modules
.git
venv
__pycache__
.cache
.tmp
*.log
*.sqlite
*.db

为什么？

因为 PA 机器上经常会有大量依赖、缓存、日志。

这些东西放进网页浏览器里，只会让页面变乱。

你真正想看的是：

• 任务报告
• 中间分析结果
• 关键配置
• 生成图片
• agent 的决策痕迹

不是几万个依赖文件。

一个很实用的 OpenClaw 用法

如果你用 OpenClaw，可以专门监控它的输出目录。

尤其是一些中间文件。

有时候比最终报告还好看。

比如 dream 机制写入的相关文件，里面可能有 agent 的思考轨迹、计划草稿、状态变化。

这类内容以前藏得很深。

你得 SSH 进去翻。

现在直接在网页里看。

你会更容易发现：

• agent 卡在哪一步
• 哪些任务反复重试
• 哪些中间判断很有价值
• 最终报告为什么会写成那样

调试 PA 的时候，这比只看最终输出有用得多。

手机查看的最佳姿势

推荐这样用：

手机端

• 安装 Tailscale
• 登录同一个账号或同一个 tailnet
• 打开 Owlia Nest 地址
• 添加到主屏幕

电脑端

• 安装 Tailscale
• 浏览器收藏 Owlia Nest 地址
• 常用目录可以直接收藏到书签栏

PA 端

• 所有产出统一写入固定目录
• 报告尽量用 Markdown
• 结构化数据用 JSON 或 YAML
• 图片输出放在同一任务目录下

这样一套下来，你的 PA 就不再是“远程黑盒”。

它更像一个随时能打开的工作台。

避坑清单

别把服务直接暴露到公网

Owlia Nest 展示的是你服务器里的文件。

别图省事直接开公网端口。

更推荐走 Tailscale。

只给自己的设备访问。

别监控根目录

不要监控：

/
/home
/var

目录太大，噪音太多，还容易把不该看的东西展示出来。

只监控 PA 产出目录。

别把密钥目录放进去

这些目录和文件要避开：

~/.ssh
.env
*.pem
*.key
credentials.json

如果 PA 产出里可能带密钥，也要配置排除规则。

安全问题别赌运气。

别让日志淹没页面

日志文件有价值，但太多会污染浏览体验。

建议只保留关键日志。

或者单独建一个 logs 目录，需要时再看。

别让 PA 乱写目录

让 PA 所有产出都写到一个固定根目录下。

比如：

/home/ubuntu/pa_outputs

别今天写 /tmp，明天写 /home/user/test，后天又写 /opt/run。

后面你自己都会找崩溃。

推荐工作流模板

你可以直接照这个来：

1. 在服务器上创建 PA 产出目录
   /home/ubuntu/pa_outputs

2. 让 OpenClaw 或其他 PA 把结果写到这里
   /home/ubuntu/pa_outputs/openclaw

3. 部署 Owlia Nest
   监控 /home/ubuntu/pa_outputs

4. 配置排除规则
   排除 .git、node_modules、venv、缓存、密钥文件

5. 用 Tailscale 访问
   http://<你的主机>/docs/

6. 手机添加到主屏幕
   当成 PA 结果查看器用

做完这套，你以后看 PA 产出就是：

打开手机 → 点图标 → 看报告。

没有多余动作。

适合放进 PA Prompt 的部署指令

如果你想让 PA 自己部署，可以把下面这段丢给它：

请帮我在这台服务器上部署 Owlia Nest：
https://github.com/zhixianio/owlia-nest

目标：
- 作为 PA 产出文件浏览网站使用
- 监控目录：/home/ubuntu/pa_outputs
- 页面路径：/docs/
- 仅通过 Tailscale 内网访问
- 配置排除：.git、node_modules、venv、__pycache__、.cache、*.key、*.pem、.env
- 支持后台运行，服务器重启后自动恢复

部署完成后请输出：
- 服务状态
- 访问地址
- 配置文件位置
- 如何新增监控目录
- 如何停止和重启服务

这段很实用。

PA 知道你要什么，就不会装完之后只回你一句“完成了”。

你要让它把后续维护信息也交代清楚。

小结一下

Owlia Nest 不是那种“宏大叙事”的工具。

它解决的是一个很具体、很日常、很烦人的问题：

远程 PA 生成的文件，怎么随时随地打开看。

如果你已经在用 OpenClaw，或者在服务器上跑各种 agent，装一个 Owlia Nest 会很舒服。

尤其是配合 Tailscale 和 PWA。

它会让你的 PA 产出从“藏在服务器文件夹里”，变成“手机上随手能看的文档站”。

这一步不炫技。

但真的省心。