# Send QuantumOS to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "quantumos",
    "name": "QuantumOS",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/murtiurti4/quantumos",
    "canonicalUrl": "https://clawhub.ai/murtiurti4/quantumos",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/quantumos",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=quantumos",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/setup.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "quantumos",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T07:41:56.926Z",
      "expiresAt": "2026-05-10T07:41:56.926Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=quantumos",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=quantumos",
        "contentDisposition": "attachment; filename=\"quantumos-0.2.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "quantumos"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/quantumos"
    },
    "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."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/quantumos",
    "downloadUrl": "https://openagent3.xyz/downloads/quantumos",
    "agentUrl": "https://openagent3.xyz/skills/quantumos/agent",
    "manifestUrl": "https://openagent3.xyz/skills/quantumos/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/quantumos/agent.md"
  }
}
```
## Documentation

### QuantumOS

AI command center dashboard for OpenClaw. Next.js app that connects to the gateway via WebSocket.

### Install

Run the setup script, then configure agent integration. Both steps are required.

### Step 1: Run setup

bash "SKILL_DIR/scripts/setup.sh"

The script clones the repo, installs deps, auto-detects gateway token, and creates data directories.

If the user doesn't have Node.js 20+, tell them to install it first: https://nodejs.org

### Step 2: Configure agent integration

After setup, you MUST add Mission Control triage to your workspace's HEARTBEAT.md. Append the following block (do not overwrite existing content):

## Check for new Mission Control tasks
- GET http://localhost:3005/api/mission-control/tasks
- Look for tasks with status "inbox"
- For each inbox task: generate a proper title, set status to "in_progress", and start working on it
- After completing a task: add a comment documenting what was done, set status to "done"

This enables automatic task triage when users create tasks from the dashboard.

### Start

cd ~/Projects/quantumos && npm run dev

Dashboard will be at http://localhost:3005

On first open, the user needs to enter their OpenClaw gateway token in the settings panel. They can find it in ~/.openclaw/openclaw.json under gateway.token.

### Stop

Kill the dev server process (Ctrl+C in the terminal running it).

For background operation:

cd ~/Projects/quantumos && nohup npm run dev > /tmp/quantumos.log 2>&1 &

### Update

cd ~/Projects/quantumos && git pull && npm install

Then restart the dev server.

### Troubleshooting

Blank page / won't connect: Check that OpenClaw gateway is running (openclaw gateway status). Verify the gateway token in dashboard settings matches ~/.openclaw/openclaw.json.
Port conflict: Change port in package.json scripts.dev (--port 3005).
Feeds not loading: Run python3 scripts/fetch-dashboard-feeds.py from the quantumos directory. Requires Python 3.8+.

### API Keys

X/Twitter feeds require an xAI API key. Get one at console.x.ai. Add XAI_API_KEY=your-key to .env.local or set it as an environment variable. Without it, X feeds are gracefully skipped.

### Features Overview

Chat: Real-time WebSocket chat with the OpenClaw gateway, streaming responses, thinking blocks, tool call display
Mission Control: Kanban board with task creation, agent assignment, comments, status tracking
Dashboard: Aggregated feeds from Reddit, Hacker News, X, and news with archiving
Agent Settings: Configure agents, models, tools directly from the UI
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: murtiurti4
- Version: 0.2.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T07:41:56.926Z
- Expires at: 2026-05-10T07:41:56.926Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/quantumos)
- [Send to Agent page](https://openagent3.xyz/skills/quantumos/agent)
- [JSON manifest](https://openagent3.xyz/skills/quantumos/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/quantumos/agent.md)
- [Download page](https://openagent3.xyz/downloads/quantumos)