# 交给 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](C:\Users\LA\Documents\New%20project\docs\macbook-deployment.md)
   - [openclaw-ops-runbook.md](C:\Users\LA\Documents\New%20project\docs\openclaw-ops-runbook.md)
   - [openclaw-agent-feed.md](C:\Users\LA\Documents\New%20project\docs\openclaw-agent-feed.md)
   - [openclaw-agent-feed.example.json](C:\Users\LA\Documents\New%20project\docs\openclaw-agent-feed.example.json)
4. 告诉它：
   - 聊天消息使用 SQLite
   - 上传文件保存在本地目录
   - agent 页面优先读取 `storage/agents/openclaw-agents.json`

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

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

```text
请接管这个局域网网站的部署与日常运维。目标是在一台 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，我也可以继续帮你检查仓库状态和提交准备情况