lan-reader-chat/docs/openclaw-handoff.md

交给 OpenClaw 的部署说明

最推荐的交付方式

最推荐的是：

1. 你把当前项目放到一个 Git 仓库
2. 把仓库地址发给 OpenClaw
3. 再把下面这些文档路径一起发给它

这样最好维护，也方便后续更新。

不推荐的方式

不建议只把零散文件一股脑发给 OpenClaw。

原因：

1. 它后面更新时不方便对比变更
2. 回滚困难
3. 容易漏文件
4. ops 长期维护不稳定

如果暂时没有 Git 仓库

也可以先把整个项目目录打包成 zip 发给它，但这只是临时方案。

更稳的顺序仍然是：

1. 先建 Git 仓库
2. 再让 OpenClaw 做部署和 ops 接管

你应该发给 OpenClaw 的内容

至少发这几样：

1. 项目仓库地址
2. 部署目标说明：
   • 部署到一台局域网内的 MacBook
   • 给公司内网用户访问
   • 网站端口默认 3000
3. 这几份文档：
   • macbook-deployment.md
   • openclaw-ops-runbook.md
   • openclaw-agent-feed.md
   • openclaw-agent-feed.example.json
4. 告诉它：
   • 聊天消息使用 SQLite
   • 上传文件保存在本地目录
   • agent 页面优先读取 storage/agents/openclaw-agents.json

可以直接发给 OpenClaw 的任务说明

你可以直接把下面这段发给它：

请接管这个局域网网站的部署与日常运维。目标是在一台 MacBook 上部署该网站，供公司局域网用户访问。请先阅读项目中的部署与运维文档，再完成以下事项：

1. 在 MacBook 上准备运行环境
2. 按 docs/macbook-deployment.md 完成部署
3. 配置 launchd 开机自启
4. 配置 OpenClaw agent 状态文件同步
5. 验证首页、聊天、书架、阅读页、Agent 观察室都可访问
6. 验证聊天可发送文字、图片、文件，并且消息可持久化
7. 验证 /agents 已正确读取真实数据源，而不是 demo 数据
8. 后续作为 ops 运维专员持续维护该网站

当前项目已经具备的基础

目前这个项目已经有：

1. 局域网聊天
2. 小说书架和阅读页
3. Agent 观察页
4. SQLite 聊天持久化
5. 本地文件上传
6. OpenClaw agent JSON 数据接入骨架
7. MacBook 部署文档
8. ops 运维手册

你接下来最该做的事

最建议你现在做这两步：

1. 把这个项目提交到一个 Git 仓库
2. 把仓库地址和这份 handoff 文档一起发给 OpenClaw

如果你让我继续

我下一步可以继续帮你做：

1. 再做一轮“部署前总验收”
2. 帮你整理一份更短的“发给 OpenClaw 的最终消息”
3. 如果你本地已经初始化了 Git，我也可以继续帮你检查仓库状态和提交准备情况