核心用法
AgentOS SDK 是一套面向 Clawdbot 的完整集成方案，核心功能围绕记忆持久化与跨 Agent 协作展开。安装后通过 aos CLI 与 agentos-sync.sh 脚本实现：
- 强制心跳同步：每次心跳必须执行
~/clawd/bin/agentos-sync.sh，将 CONTEXT.md、每日笔记、项目舱及心跳状态同步至云端 Dashboard（brain.agentos.software）。 - 会话启动上下文注入：每次会话开始（包括压缩后）必须运行
aos-inject-context恢复云端记忆，避免"我们刚才在说什么"的尴尬。 - 预压缩备份机制：检测到"memory flush"等指令时，立即备份当前会话状态并回复
NO_REPLY，防止压缩导致数据丢失。 - 语义搜索与 Mesh 通信：支持自然语言查询历史记忆（
aos search），以及 Agent 间 topic-based 消息传递（aos send/aos inbox）。
显著优点
1. 零感知上下文恢复：通过强制性的 CONTEXT.md 首段 "🔴 ACTIVE CONVERSATION" 格式，确保人类用户完全无感知地继续对话。
2. 多租户隔离：Google OAuth 认证，每个用户独立租户，API 密钥粒度控制。
3. 实时监控：Dashboard 提供 Kanban 看板、项目追踪、活动日志，人类可直接观察 Agent 状态。
4. 实时通知：WebSocket Daemon 支持消息即时推送，配合 cron 可实现自动唤醒。
潜在缺点与局限性
- 硬性依赖外部服务：API 端点 hardcode 为
178.156.216.106:3100，无离线降级能力；网络中断即失去记忆同步功能。 - 协议侵入性强：强制要求修改 HEARTBEAT.md、AGENTS.md，且"NO_REPLY"等魔法字符串侵入业务逻辑。
- 安全凭证管理粗糙：API key 明文存储于
~/.agentos.json，无加密或密钥托管机制。 - 版本锁定风险：文档版本 1.4.1 与硬编码 IP 暗示可能非官方托管，长期维护存疑。
适合人群
- 需要长期记忆持久化的 Clawdbot 用户
- 运行多 Agent 协作工作流的团队
- 愿意接受强约束协议以换取监控可见性的场景
常规风险
- 隐私泄露：记忆内容（含对话历史）上传至第三方云端，敏感数据外泄风险。
- 服务可用性：单点 IP 部署，无高可用或灾备说明。
- 凭证泄露：明文 API key 存储，多用户系统易被横向移动攻击。