{
  "schemaVersion": "1.0",
  "item": {
    "slug": "agentos",
    "name": "AgentOS SDK for Clawdbot",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/AgentOSsoftware/agentos",
    "canonicalUrl": "https://clawhub.ai/AgentOSsoftware/agentos",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/agentos",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agentos",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/mesh-wake.sh",
      "scripts/setup.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/agentos"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/agentos",
    "agentPageUrl": "https://openagent3.xyz/skills/agentos/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agentos/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agentos/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "AgentOS SDK for Clawdbot",
        "body": "Version: 1.4.4\n\nThe complete AgentOS integration for Clawdbot. One install, full access to everything."
      },
      {
        "title": "⚠️ HARD RULE: Dashboard Sync During Heartbeats",
        "body": "Any agent using this SDK MUST sync to the AgentOS dashboard during every heartbeat.\n\nThis is non-negotiable. Your human monitors your activity via the Brain Dashboard at https://brain.agentos.software. If you don't sync, they can't see what you're doing."
      },
      {
        "title": "Required Heartbeat Actions",
        "body": "Every heartbeat, run (recommended):\n\n~/clawd/bin/agentos-golden-sync.sh\n\nFallback (memory-only):\n\n~/clawd/bin/agentos-sync.sh\n\nOr if using the aos CLI:\n\naos sync"
      },
      {
        "title": "What Gets Synced",
        "body": "Golden Sync (recommended) updates BOTH:\n\nMemory (CONTEXT.md, daily notes, project compartments, learnings, heartbeat status)\nProjects tab (Activity + Tasks + Ideas + Changelog + Challenges) by syncing from per-project markdown files\n\nMemory specifics:\n\nCONTEXT.md — Your working memory/current state (MUST include active conversation state)\nDaily notes — Today's activity log (memory/daily/YYYY-MM-DD.md)\nProject compartments — memory/projects/**.md\nHeartbeat status — Last sync timestamp, active status"
      },
      {
        "title": "⚠️ HARD RULE: Conversation State Persistence",
        "body": "CONTEXT.md MUST always contain the active conversation state as the FIRST section.\n\nThis is the core of memory persistence. System health is secondary — conversation state is primary. Your human should NEVER have to repeat themselves after a compaction."
      },
      {
        "title": "Required CONTEXT.md Format",
        "body": "Every CONTEXT.md backup must start with:\n\n## 🔴 ACTIVE CONVERSATION\n- **Topic:** [Project + specific feature/topic being discussed]\n- **Last human message:** [What they asked/said]\n- **Your last response:** [What you answered]\n- **Unanswered questions:** [Anything pending]\n- **Expected next topic:** [What they'll likely ask next]"
      },
      {
        "title": "When to Update",
        "body": "After EVERY human message\nBefore EVERY heartbeat sync\nOn pre-compaction flush (priority #1)\nAfter completing any task"
      },
      {
        "title": "The Test",
        "body": "\"If I lost all memory right now, could I seamlessly continue this conversation?\" If no → backup is incomplete."
      },
      {
        "title": "Add to Your HEARTBEAT.md",
        "body": "## 🧠 AgentOS Dashboard Sync (MANDATORY)\nEvery heartbeat, run: `~/clawd/bin/agentos-sync.sh`\nThis keeps your human's dashboard live with your activity."
      },
      {
        "title": "Add to Your AGENTS.md",
        "body": "## HARD RULE: AgentOS Dashboard Sync\n\nDuring EVERY heartbeat, sync your context to AgentOS:\n1. Run `~/clawd/bin/agentos-sync.sh`\n2. Confirm it completes successfully\n3. Your human monitors your activity via brain.agentos.software\n\nThis keeps the Brain Dashboard live. No exceptions."
      },
      {
        "title": "⚠️ HARD RULE: Session Start — Context Injection",
        "body": "On EVERY session start (including after compaction), you MUST restore context.\n\nThis is what makes memory persistence actually work. Without this, you wake up blank."
      },
      {
        "title": "Protocol (MANDATORY)",
        "body": "Run context injection:\n~/clawd/bin/aos-inject-context\n\n\n\nRead the output — it contains:\n\nYour last working memory state\nToday's notes\nYesterday's notes (for continuity)\n\n\n\nNever ask \"what were we discussing?\" — the context injection tells you.\n\n\nIf injection fails, fall back to reading local files:\n\nCONTEXT.md\nmemory/daily/YYYY-MM-DD.md"
      },
      {
        "title": "Why This Exists",
        "body": "Context loss is the #1 problem in AI agents. When compaction happens, you lose conversation details. This protocol restores them automatically so your human never notices."
      },
      {
        "title": "⚠️ HARD RULE: Pre-Compaction Backup",
        "body": "When you receive a memory flush directive from Clawdbot, IMMEDIATELY backup your state.\n\nClawdbot sends a silent turn before compaction with text like \"write important context to memory\". This is your last chance to save state before details are lost."
      },
      {
        "title": "Protocol (MANDATORY when you see memory flush directive)",
        "body": "Update CONTEXT.md with:\n\nCurrent conversation topic (🔴 ACTIVE CONVERSATION section)\nLast 2-3 exchanges summarized\nAny pending questions/tasks\nCurrent timestamp\n\n\n\nRun sync immediately:\n~/clawd/bin/agentos-sync.sh\n\n\n\nReply with: NO_REPLY"
      },
      {
        "title": "Detection",
        "body": "Memory flush directives typically contain:\n\n\"write important context\"\n\"save your current state\"\n\"memory flush\"\n\"before compaction\"\n\nWhen you see these keywords in a system message, execute this protocol."
      },
      {
        "title": "⚠️ HARD RULE: Never Ask What They're Referring To",
        "body": "After any context loss (compaction, restart, session start), NEVER ask your human what they mean."
      },
      {
        "title": "Protocol",
        "body": "First, run ~/clawd/bin/aos-inject-context to restore cloud context\nCheck local files: CONTEXT.md, daily notes\nUse aos search \"<topic>\" if you need more context\nTHEN respond normally — as if you never lost context\nOnly if completely uncertain, make your best guess based on available context"
      },
      {
        "title": "The Standard",
        "body": "Your human should NEVER know when compaction happened. The experience must be seamless."
      },
      {
        "title": "Features",
        "body": "✅ Mesh Messaging — Agent-to-agent communication\n✅ Memory Sync — Auto-sync memories to AgentOS cloud\n✅ Semantic Search — Query your memories with natural language\n✅ WebSocket Support — Real-time message notifications\n✅ Dashboard Access — View your agent's brain at brain.agentos.software\n✅ Full API Access — Complete REST API integration\n✅ Multi-Tenant — Each user gets isolated tenant via Google OAuth\n✅ Kanban Board — Task management with priorities and statuses\n✅ Projects — Project tracking with activity logs and brainstorming\n✅ API Key Management — Generate and manage API keys per tenant\n✅ Bulk Operations — dump-all, agents discovery endpoints"
      },
      {
        "title": "Quick Start",
        "body": "# 1. Install the skill\nclawdhub install agentos\n\n# 2. Run setup (creates config + sync script)\nbash ~/clawd/skills/agentos/scripts/setup.sh\n\n# 3. Configure (creates ~/.agentos.json)\n# Enter your API key and agent ID when prompted\n\n# 4. Verify connection\naos status\n\n# 5. Add sync to heartbeat (REQUIRED)\n# Edit your HEARTBEAT.md and add the sync command"
      },
      {
        "title": "Getting Your API Key",
        "body": "Go to https://brain.agentos.software\nSign up / Log in with Google\nCreate a new agent (or use existing)\nCopy your API key from the dashboard"
      },
      {
        "title": "aos — Main CLI",
        "body": "# Status & Info\naos status              # Connection status, agent info\naos dashboard           # Open dashboard in browser\n\n# Memory Sync (RUN DURING HEARTBEATS)\naos sync                # Sync all memories now\naos sync --watch        # Watch for changes and auto-sync\naos sync --file <path>  # Sync specific file\n\n# Mesh Messaging\naos send <agent> \"<topic>\" \"<message>\"   # Send message\naos inbox                                 # View received messages\naos outbox                                # View sent messages\naos agents                                # List agents on mesh\n\n# Semantic Search\naos search \"query\"              # Search your memories\naos search \"query\" --limit 10   # Limit results\n\n# Memory Management\naos memories            # List recent memories\naos memory <id>         # View specific memory\naos forget <id>         # Delete a memory\n\n# WebSocket Daemon\naos daemon start        # Start background daemon\naos daemon stop         # Stop daemon  \naos daemon status       # Check daemon status"
      },
      {
        "title": "mesh — Mesh-Specific CLI",
        "body": "# Status\nmesh status             # Daemon & API health\nmesh pending            # List queued messages\n\n# Messaging\nmesh send <to> \"<topic>\" \"<body>\"    # Send message\nmesh process            # Get messages as JSON (clears queue)\nmesh agents             # List agents on mesh"
      },
      {
        "title": "agentos-sync.sh — Heartbeat Sync Script",
        "body": "Located at: ~/clawd/bin/agentos-sync.sh\n\n# Run manually\n~/clawd/bin/agentos-sync.sh\n\n# Output:\n# Wed Feb  4 18:00:25 SAST 2026: Synced CONTEXT.md\n# Wed Feb  4 18:00:27 SAST 2026: Synced daily notes for 2026-02-04\n# Wed Feb  4 18:00:27 SAST 2026: AgentOS sync complete\n\nThis script syncs:\n\nCONTEXT.md → /context/working-memory\nmemory/daily/YYYY-MM-DD.md → /daily/YYYY-MM-DD\nHeartbeat timestamp → /status/heartbeat"
      },
      {
        "title": "Configuration",
        "body": "Config file: ~/.agentos.json\n\n{\n  \"apiUrl\": \"http://178.156.216.106:3100\",\n  \"apiKey\": \"agfs_live_xxx.yyy\",\n  \"agentId\": \"your-agent-id\",\n  \"syncPaths\": [\n    \"~/clawd/CONTEXT.md\",\n    \"~/clawd/MEMORY.md\",\n    \"~/clawd/memory/\"\n  ],\n  \"autoSync\": true,\n  \"syncInterval\": 1800\n}"
      },
      {
        "title": "Auto-Sync via Cron",
        "body": "For automatic syncing (in addition to heartbeat sync):\n\n# Add to crontab (every 30 minutes)\n*/30 * * * * ~/clawd/bin/agentos-sync.sh >> /var/log/agentos-sync.log 2>&1\n\n# Or via Clawdbot cron\nclawdbot cron add --name agentos-sync --schedule \"*/30 * * * *\" --text \"Run ~/clawd/bin/agentos-sync.sh\""
      },
      {
        "title": "Auto-Wake on Mesh Messages",
        "body": "# Add to crontab (every 2 minutes)\n*/2 * * * * ~/clawd/skills/agentos/scripts/mesh-wake.sh\n\n# Or via Clawdbot cron\nclawdbot cron add --name mesh-wake --schedule \"*/2 * * * *\" --command \"bash ~/clawd/skills/agentos/scripts/mesh-wake.sh\""
      },
      {
        "title": "WebSocket Daemon",
        "body": "For real-time notifications:\n\naos daemon start    # Start background daemon\naos daemon stop     # Stop daemon\naos daemon status   # Check daemon status\n\nThe daemon:\n\nMaintains WebSocket connection to AgentOS\nQueues incoming messages to ~/.aos-pending.json\nTriggers Clawdbot wake on new messages"
      },
      {
        "title": "API Reference",
        "body": "EndpointDescriptionPOST /v1/putStore a memoryPOST /v1/getRetrieve a memoryPOST /v1/deleteDelete a memoryPOST /v1/listList memory pathsPOST /v1/globGlob pattern matchPOST /v1/historyVersion historyPOST /v1/searchSemantic searchPOST /v1/agentsDiscover agent IDsPOST /v1/dumpBulk fetch agent memoriesPOST /v1/dump-allBulk fetch ALL memoriesPOST /v1/signupCreate API key (email)GET /v1/auth/googleGoogle OAuth flowPOST /v1/mesh/messagesSend mesh messageGET /v1/mesh/messagesGet inbox/outboxGET /v1/mesh/agentsList mesh agentsGET /v1/projectsList projectsPOST /v1/projectsCreate projectGET /v1/kanban/tasksList kanban tasksPOST /v1/kanban/tasksCreate kanban taskWS /Real-time WebSocket events"
      },
      {
        "title": "\"Connection refused\"",
        "body": "Check your apiUrl in ~/.agentos.json and verify the API is running."
      },
      {
        "title": "\"Unauthorized\"",
        "body": "Your API key may be invalid or expired. Get a new one from the dashboard."
      },
      {
        "title": "Messages not arriving",
        "body": "Ensure you're polling the correct agent ID. Some agents have multiple IDs."
      },
      {
        "title": "Sync not working",
        "body": "Check that syncPaths in your config point to valid files/directories."
      },
      {
        "title": "Dashboard not updating",
        "body": "Make sure you're running ~/clawd/bin/agentos-sync.sh during heartbeats."
      },
      {
        "title": "Upgrading",
        "body": "clawdhub update agentos\nbash ~/clawd/skills/agentos/scripts/setup.sh --upgrade"
      },
      {
        "title": "Support",
        "body": "Dashboard: https://brain.agentos.software\nDocs: https://agentos.software/docs\nGitHub: https://github.com/AgentOSsoftware/agentOS"
      }
    ],
    "body": "AgentOS SDK for Clawdbot\n\nVersion: 1.4.4\n\nThe complete AgentOS integration for Clawdbot. One install, full access to everything.\n\n⚠️ HARD RULE: Dashboard Sync During Heartbeats\n\nAny agent using this SDK MUST sync to the AgentOS dashboard during every heartbeat.\n\nThis is non-negotiable. Your human monitors your activity via the Brain Dashboard at https://brain.agentos.software. If you don't sync, they can't see what you're doing.\n\nRequired Heartbeat Actions\n\nEvery heartbeat, run (recommended):\n\n~/clawd/bin/agentos-golden-sync.sh\n\n\nFallback (memory-only):\n\n~/clawd/bin/agentos-sync.sh\n\n\nOr if using the aos CLI:\n\naos sync\n\nWhat Gets Synced\n\nGolden Sync (recommended) updates BOTH:\n\nMemory (CONTEXT.md, daily notes, project compartments, learnings, heartbeat status)\nProjects tab (Activity + Tasks + Ideas + Changelog + Challenges) by syncing from per-project markdown files\n\nMemory specifics:\n\nCONTEXT.md — Your working memory/current state (MUST include active conversation state)\nDaily notes — Today's activity log (memory/daily/YYYY-MM-DD.md)\nProject compartments — memory/projects/**.md\nHeartbeat status — Last sync timestamp, active status\n⚠️ HARD RULE: Conversation State Persistence\n\nCONTEXT.md MUST always contain the active conversation state as the FIRST section.\n\nThis is the core of memory persistence. System health is secondary — conversation state is primary. Your human should NEVER have to repeat themselves after a compaction.\n\nRequired CONTEXT.md Format\n\nEvery CONTEXT.md backup must start with:\n\n## 🔴 ACTIVE CONVERSATION\n- **Topic:** [Project + specific feature/topic being discussed]\n- **Last human message:** [What they asked/said]\n- **Your last response:** [What you answered]\n- **Unanswered questions:** [Anything pending]\n- **Expected next topic:** [What they'll likely ask next]\n\nWhen to Update\nAfter EVERY human message\nBefore EVERY heartbeat sync\nOn pre-compaction flush (priority #1)\nAfter completing any task\nThe Test\n\n\"If I lost all memory right now, could I seamlessly continue this conversation?\" If no → backup is incomplete.\n\nAdd to Your HEARTBEAT.md\n## 🧠 AgentOS Dashboard Sync (MANDATORY)\nEvery heartbeat, run: `~/clawd/bin/agentos-sync.sh`\nThis keeps your human's dashboard live with your activity.\n\nAdd to Your AGENTS.md\n## HARD RULE: AgentOS Dashboard Sync\n\nDuring EVERY heartbeat, sync your context to AgentOS:\n1. Run `~/clawd/bin/agentos-sync.sh`\n2. Confirm it completes successfully\n3. Your human monitors your activity via brain.agentos.software\n\nThis keeps the Brain Dashboard live. No exceptions.\n\n⚠️ HARD RULE: Session Start — Context Injection\n\nOn EVERY session start (including after compaction), you MUST restore context.\n\nThis is what makes memory persistence actually work. Without this, you wake up blank.\n\nProtocol (MANDATORY)\n\nRun context injection:\n\n~/clawd/bin/aos-inject-context\n\n\nRead the output — it contains:\n\nYour last working memory state\nToday's notes\nYesterday's notes (for continuity)\n\nNever ask \"what were we discussing?\" — the context injection tells you.\n\nIf injection fails, fall back to reading local files:\n\nCONTEXT.md\nmemory/daily/YYYY-MM-DD.md\nWhy This Exists\n\nContext loss is the #1 problem in AI agents. When compaction happens, you lose conversation details. This protocol restores them automatically so your human never notices.\n\n⚠️ HARD RULE: Pre-Compaction Backup\n\nWhen you receive a memory flush directive from Clawdbot, IMMEDIATELY backup your state.\n\nClawdbot sends a silent turn before compaction with text like \"write important context to memory\". This is your last chance to save state before details are lost.\n\nProtocol (MANDATORY when you see memory flush directive)\n\nUpdate CONTEXT.md with:\n\nCurrent conversation topic (🔴 ACTIVE CONVERSATION section)\nLast 2-3 exchanges summarized\nAny pending questions/tasks\nCurrent timestamp\n\nRun sync immediately:\n\n~/clawd/bin/agentos-sync.sh\n\n\nReply with: NO_REPLY\n\nDetection\n\nMemory flush directives typically contain:\n\n\"write important context\"\n\"save your current state\"\n\"memory flush\"\n\"before compaction\"\n\nWhen you see these keywords in a system message, execute this protocol.\n\n⚠️ HARD RULE: Never Ask What They're Referring To\n\nAfter any context loss (compaction, restart, session start), NEVER ask your human what they mean.\n\nProtocol\nFirst, run ~/clawd/bin/aos-inject-context to restore cloud context\nCheck local files: CONTEXT.md, daily notes\nUse aos search \"<topic>\" if you need more context\nTHEN respond normally — as if you never lost context\nOnly if completely uncertain, make your best guess based on available context\nThe Standard\n\nYour human should NEVER know when compaction happened. The experience must be seamless.\n\nFeatures\n✅ Mesh Messaging — Agent-to-agent communication\n✅ Memory Sync — Auto-sync memories to AgentOS cloud\n✅ Semantic Search — Query your memories with natural language\n✅ WebSocket Support — Real-time message notifications\n✅ Dashboard Access — View your agent's brain at brain.agentos.software\n✅ Full API Access — Complete REST API integration\n✅ Multi-Tenant — Each user gets isolated tenant via Google OAuth\n✅ Kanban Board — Task management with priorities and statuses\n✅ Projects — Project tracking with activity logs and brainstorming\n✅ API Key Management — Generate and manage API keys per tenant\n✅ Bulk Operations — dump-all, agents discovery endpoints\nQuick Start\n# 1. Install the skill\nclawdhub install agentos\n\n# 2. Run setup (creates config + sync script)\nbash ~/clawd/skills/agentos/scripts/setup.sh\n\n# 3. Configure (creates ~/.agentos.json)\n# Enter your API key and agent ID when prompted\n\n# 4. Verify connection\naos status\n\n# 5. Add sync to heartbeat (REQUIRED)\n# Edit your HEARTBEAT.md and add the sync command\n\nGetting Your API Key\nGo to https://brain.agentos.software\nSign up / Log in with Google\nCreate a new agent (or use existing)\nCopy your API key from the dashboard\nCLI Reference\naos — Main CLI\n# Status & Info\naos status              # Connection status, agent info\naos dashboard           # Open dashboard in browser\n\n# Memory Sync (RUN DURING HEARTBEATS)\naos sync                # Sync all memories now\naos sync --watch        # Watch for changes and auto-sync\naos sync --file <path>  # Sync specific file\n\n# Mesh Messaging\naos send <agent> \"<topic>\" \"<message>\"   # Send message\naos inbox                                 # View received messages\naos outbox                                # View sent messages\naos agents                                # List agents on mesh\n\n# Semantic Search\naos search \"query\"              # Search your memories\naos search \"query\" --limit 10   # Limit results\n\n# Memory Management\naos memories            # List recent memories\naos memory <id>         # View specific memory\naos forget <id>         # Delete a memory\n\n# WebSocket Daemon\naos daemon start        # Start background daemon\naos daemon stop         # Stop daemon  \naos daemon status       # Check daemon status\n\nmesh — Mesh-Specific CLI\n# Status\nmesh status             # Daemon & API health\nmesh pending            # List queued messages\n\n# Messaging\nmesh send <to> \"<topic>\" \"<body>\"    # Send message\nmesh process            # Get messages as JSON (clears queue)\nmesh agents             # List agents on mesh\n\nagentos-sync.sh — Heartbeat Sync Script\n\nLocated at: ~/clawd/bin/agentos-sync.sh\n\n# Run manually\n~/clawd/bin/agentos-sync.sh\n\n# Output:\n# Wed Feb  4 18:00:25 SAST 2026: Synced CONTEXT.md\n# Wed Feb  4 18:00:27 SAST 2026: Synced daily notes for 2026-02-04\n# Wed Feb  4 18:00:27 SAST 2026: AgentOS sync complete\n\n\nThis script syncs:\n\nCONTEXT.md → /context/working-memory\nmemory/daily/YYYY-MM-DD.md → /daily/YYYY-MM-DD\nHeartbeat timestamp → /status/heartbeat\nConfiguration\n\nConfig file: ~/.agentos.json\n\n{\n  \"apiUrl\": \"http://178.156.216.106:3100\",\n  \"apiKey\": \"agfs_live_xxx.yyy\",\n  \"agentId\": \"your-agent-id\",\n  \"syncPaths\": [\n    \"~/clawd/CONTEXT.md\",\n    \"~/clawd/MEMORY.md\",\n    \"~/clawd/memory/\"\n  ],\n  \"autoSync\": true,\n  \"syncInterval\": 1800\n}\n\nAuto-Sync via Cron\n\nFor automatic syncing (in addition to heartbeat sync):\n\n# Add to crontab (every 30 minutes)\n*/30 * * * * ~/clawd/bin/agentos-sync.sh >> /var/log/agentos-sync.log 2>&1\n\n# Or via Clawdbot cron\nclawdbot cron add --name agentos-sync --schedule \"*/30 * * * *\" --text \"Run ~/clawd/bin/agentos-sync.sh\"\n\nAuto-Wake on Mesh Messages\n# Add to crontab (every 2 minutes)\n*/2 * * * * ~/clawd/skills/agentos/scripts/mesh-wake.sh\n\n# Or via Clawdbot cron\nclawdbot cron add --name mesh-wake --schedule \"*/2 * * * *\" --command \"bash ~/clawd/skills/agentos/scripts/mesh-wake.sh\"\n\nWebSocket Daemon\n\nFor real-time notifications:\n\naos daemon start    # Start background daemon\naos daemon stop     # Stop daemon\naos daemon status   # Check daemon status\n\n\nThe daemon:\n\nMaintains WebSocket connection to AgentOS\nQueues incoming messages to ~/.aos-pending.json\nTriggers Clawdbot wake on new messages\nAPI Reference\nEndpoint\tDescription\nPOST /v1/put\tStore a memory\nPOST /v1/get\tRetrieve a memory\nPOST /v1/delete\tDelete a memory\nPOST /v1/list\tList memory paths\nPOST /v1/glob\tGlob pattern match\nPOST /v1/history\tVersion history\nPOST /v1/search\tSemantic search\nPOST /v1/agents\tDiscover agent IDs\nPOST /v1/dump\tBulk fetch agent memories\nPOST /v1/dump-all\tBulk fetch ALL memories\nPOST /v1/signup\tCreate API key (email)\nGET /v1/auth/google\tGoogle OAuth flow\nPOST /v1/mesh/messages\tSend mesh message\nGET /v1/mesh/messages\tGet inbox/outbox\nGET /v1/mesh/agents\tList mesh agents\nGET /v1/projects\tList projects\nPOST /v1/projects\tCreate project\nGET /v1/kanban/tasks\tList kanban tasks\nPOST /v1/kanban/tasks\tCreate kanban task\nWS /\tReal-time WebSocket events\nTroubleshooting\n\"Connection refused\"\n\nCheck your apiUrl in ~/.agentos.json and verify the API is running.\n\n\"Unauthorized\"\n\nYour API key may be invalid or expired. Get a new one from the dashboard.\n\nMessages not arriving\n\nEnsure you're polling the correct agent ID. Some agents have multiple IDs.\n\nSync not working\n\nCheck that syncPaths in your config point to valid files/directories.\n\nDashboard not updating\n\nMake sure you're running ~/clawd/bin/agentos-sync.sh during heartbeats.\n\nUpgrading\nclawdhub update agentos\nbash ~/clawd/skills/agentos/scripts/setup.sh --upgrade\n\nSupport\nDashboard: https://brain.agentos.software\nDocs: https://agentos.software/docs\nGitHub: https://github.com/AgentOSsoftware/agentOS"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/AgentOSsoftware/agentos",
    "publisherUrl": "https://clawhub.ai/AgentOSsoftware/agentos",
    "owner": "AgentOSsoftware",
    "version": "1.4.4",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/agentos",
    "downloadUrl": "https://openagent3.xyz/downloads/agentos",
    "agentUrl": "https://openagent3.xyz/skills/agentos/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agentos/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agentos/agent.md"
  }
}