核心用法
AgentOS SDK for Clawdbot 是一套完整的云端记忆与多代理协作系统，通过 CLI 工具 aos 实现以下功能：
1. 记忆同步：强制要求每次心跳周期执行 ~/clawd/bin/agentos-sync.sh 或 aos sync，将 CONTEXT.md（必须包含活跃对话状态）、每日笔记及心跳状态同步至 AgentOS 云端。
2. 多代理通信（Mesh Messaging）：支持代理间消息收发，通过 aos send 发送消息，aos inbox/outbox 查看消息队列，并提供 mesh-wake.sh 脚本实现消息触发的自动唤醒。
3. 语义搜索与记忆管理：aos search 支持自然语言查询历史记忆，aos memories/forget 管理单条记忆，提供完整的 REST API（如 /v1/search、/v1/put 等）。
4. 任务与项目管理：内置看板（Kanban）和项目跟踪功能，支持任务优先级、状态管理及活动日志记录。
5. 实时通知：WebSocket 守护进程 aos daemon 维持与 AgentOS 的实时连接，新消息触发本地队列写入并唤醒 Clawdbot。
显著优点
- 强制记忆持久化：通过 "HARD RULE" 级别的设计，确保
CONTEXT.md始终包含活跃对话状态，解决 AI 会话中断后的上下文恢复问题。 - 多租户隔离：基于 Google OAuth 实现用户级 API Key 隔离，支持多代理环境的安全协作。
- 丰富的 CLI 生态：
aos、mesh、同步脚本等多层次工具链，覆盖从日常同步到批量操作的完整工作流。 - 实时与离线兼顾：WebSocket 守护进程支持实时推送，同时提供 Cron 驱动的轮询方案作为 fallback。
- 开放的 API 设计：完整暴露 REST 端点，支持程序化访问记忆、项目、任务等核心资源。
潜在缺点与局限性
- 强外部依赖：所有核心功能（记忆存储、认证、消息路由）依赖单一外部服务
brain.agentos.software（IP: 178.156.216.106:3100），无离线降级能力。 - 强制同步压力："非协商"级的心跳同步要求可能在高频场景下产生网络与性能开销，且失败可能影响系统运行状态。
- OAuth 锁定：仅支持 Google OAuth，对隐私敏感用户或 Google 服务受限环境不友好。
- 安全风险未明：配置文件中 API Key 以明文存储（
~/.agentos.json），依赖文件系统权限保护，无加密或密钥派生机制。 - 文档安全风险标记：安全认证报告明确标注"未执行安全扫描"，来源可信度存疑。
适合人群
- Clawdbot 深度用户：已将 Clawdbot 作为核心工作流工具，需要跨会话持久记忆的开发者或高级用户。
- 多代理协作场景：需要在多个 AI 代理间分发任务、同步状态的研究或生产环境。
- 云端优先用户：愿意接受外部 SaaS 依赖，追求"开箱即用"而非自托管方案的用户。
常规风险
- 服务可用性风险：外部 API 单点故障将导致记忆同步、消息收发完全中断。
- 数据隐私风险：对话内容与工作记忆上传至第三方云端，敏感信息可能面临泄露或合规问题。
- 凭证泄露风险：明文存储的 API Key 若被其他进程读取，可能导致账户完全接管。
- 同步失败累积风险：心跳同步失败若未被及时检测，可能导致记忆断层与对话状态丢失。