这里保存 WeClaws 的稳定参考文档。README 负责快速介绍项目，manuals 负责记录可验证的接口、部署、运行时和运维事实。
| 你想了解 | 建议阅读 |
|---|---|
| 如何部署和排障 Docker Compose | docker-deployment-runbook.md |
| 环境变量、密钥边界和本地/Compose 配置差异 | env-and-secrets-matrix.md |
| Web API、SSE 和错误码 | api-contract.md |
| FastAgent CLI 如何被 WeClaws 启动和消费 | fastagent-cli-contract.md |
remote sandbox 路径语义，/workspace、/state 和 stateRoot 的区别 |
sandbox-path-semantics.md |
| 官方托管技能的同步策略和当前清单 | managed-skills.md |
| SQLite 表结构、字段、索引和关系 | database-schema-reference.md |
| 数据库迁移约束和未来 PostgreSQL 迁移边界 | database-migration-notes.md |
| 当前关键版本基线 | version-matrix.md |
- 文档中的事实应以代码、配置、Dockerfile、迁移和测试为准。
- 改动 FastAgent CLI、sandbox-runtime、Compose、环境变量或托管技能时，必须同步检查本目录相关手册。
- README 可以偏产品介绍；长期 contract、边界和排障信息应沉到 manuals。