---
title: '安裝到 OpenClaw 及相容平台'
description: 'OpenClaw、QClaw、WorkBuddy、NemoClaw、ArkClaw 一鍵安裝指南。不需帳號。'
icon: 'bolt'
---

60 秒內把 Panguard 裝到你的 Claw AI agent 或相容 MCP 平台。不需帳號、不需登入、不需設定。

## 快速開始（所有平台）

最快的方式 -- 一行搞定安裝和設定：

```bash
curl -fsSL https://get.panguard.ai | bash && panguard setup
```

已經裝好 Panguard 的話：

```bash
panguard setup
```

自動偵測 OpenClaw、QClaw、WorkBuddy、NemoClaw、ArkClaw 和其他 AI 平台，注入正確的 config。

---

## OpenClaw

OpenClaw 用**原生 Skill 系統**（不是 MCP）。Panguard 以 skill 形式安裝到 `~/.openclaw/skills/panguard/`。

### 自動安裝

```bash
npx panguard setup --platform openclaw
```

### 手動安裝

```bash
mkdir -p ~/.openclaw/skills/panguard
npx panguard setup --platform openclaw
```

裝完重啟 OpenClaw，就能直接用 Panguard 指令：

```
> 審計這個專案的 skills
> 掃描我的機器有沒有漏洞
> 啟動即時防護
> 顯示安全狀態
```

### 驗證

```bash
ls ~/.openclaw/skills/panguard/SKILL.md
```

檔案在就代表裝好了。

---

## QClaw（騰訊）

QClaw 用標準 **MCP 協議**。Panguard 把 MCP server config 加到 `~/.qclaw/mcp.json`。

### 自動安裝

```bash
npx panguard setup --platform qclaw
```

### 手動安裝

偏好手動的話，把以下加到 `~/.qclaw/mcp.json`：

```json
{
  "mcpServers": {
    "panguard": {
      "command": "npx",
      "args": ["-y", "@panguard-ai/panguard-mcp"]
    }
  }
}
```

裝完重啟 QClaw。Panguard 的 12 個 MCP 工具就能用了：

| 工具                     | 功能             |
| ------------------------ | ---------------- |
| `panguard_audit_skill`   | 安裝前審計 skill |
| `panguard_scan`          | 跑安全掃描       |
| `panguard_status`        | 顯示 Guard 狀態  |
| `panguard_guard_start`   | 啟動 24/7 防護   |
| `panguard_threat_search` | 搜尋威脅情報     |

### 驗證

```bash
cat ~/.qclaw/mcp.json
```

應該會在 `mcpServers` 下看到 `panguard` 項目。

---

## WorkBuddy

WorkBuddy 用標準 **MCP 協議**。Panguard 把 MCP server config 加到 `~/.workbuddy/.mcp.json`。

### 自動安裝

```bash
npx panguard setup --platform workbuddy
```

### 手動安裝

偏好手動的話，把以下加到 `~/.workbuddy/.mcp.json`：

```json
{
  "mcpServers": {
    "panguard": {
      "command": "npx",
      "args": ["-y", "@panguard-ai/panguard-mcp"]
    }
  }
}
```

裝完重啟 WorkBuddy。Panguard 的 12 個 MCP 工具就能用了。

### 驗證

```bash
cat ~/.workbuddy/.mcp.json
```

應該會在 `mcpServers` 下看到 `panguard` 項目。

---

## NemoClaw

NemoClaw 用標準 **MCP 協議**。Panguard 把 MCP server config 加到 `~/.nemoclaw/mcp.json`。

### 自動安裝

```bash
npx panguard setup --platform nemoclaw
```

### 手動安裝

偏好手動的話，把以下加到 `~/.nemoclaw/mcp.json`：

```json
{
  "mcpServers": {
    "panguard": {
      "command": "npx",
      "args": ["-y", "@panguard-ai/panguard-mcp"]
    }
  }
}
```

裝完重啟 NemoClaw。Panguard 的 12 個 MCP 工具就能用了。

### 驗證

```bash
cat ~/.nemoclaw/mcp.json
```

應該會在 `mcpServers` 下看到 `panguard` 項目。

---

## ArkClaw

ArkClaw 用標準 **MCP 協議**。Panguard 把 MCP server config 加到 `~/.arkclaw/mcp.json`。

### 自動安裝

```bash
npx panguard setup --platform arkclaw
```

### 手動安裝

偏好手動的話，把以下加到 `~/.arkclaw/mcp.json`：

```json
{
  "mcpServers": {
    "panguard": {
      "command": "npx",
      "args": ["-y", "@panguard-ai/panguard-mcp"]
    }
  }
}
```

裝完重啟 ArkClaw。Panguard 的 12 個 MCP 工具就能用了。

### 驗證

```bash
cat ~/.arkclaw/mcp.json
```

應該會在 `mcpServers` 下看到 `panguard` 項目。

---

## 疑難排解

<AccordionGroup>
  <Accordion title="偵測不到平台">
    `panguard setup` 說找不到 OpenClaw 或 QClaw 的話：

    1. 確認 app 已安裝而且至少開過一次
    2. 檢查 config 目錄存不存在：`ls ~/.openclaw` 或 `ls ~/.qclaw`
    3. 用 `--platform` flag 強制指定：`npx panguard setup --platform openclaw`

  </Accordion>

<Accordion title="QClaw 看不到 MCP 工具">
  1. 完全重啟 QClaw（關掉再開） 2. 確認 config：`cat ~/.qclaw/mcp.json` 3. 確認 `npx` 在 PATH
  裡：`which npx`
</Accordion>

<Accordion title="OpenClaw skill 沒反應">
  1. 重啟 OpenClaw 2. 確認檔案存在：`ls ~/.openclaw/skills/panguard/SKILL.md` 3. 確認 `panguard` CLI
  可用：`npx panguard --version`
</Accordion>

  <Accordion title="移除 Panguard">
    ```bash
    npx panguard setup --remove --platform openclaw
    npx panguard setup --remove --platform qclaw
    ```
  </Accordion>
</AccordionGroup>

---

## 總覽

|                 | OpenClaw                               | QClaw                | WorkBuddy                | NemoClaw               | ArkClaw               |
| --------------- | -------------------------------------- | -------------------- | ------------------------ | ---------------------- | --------------------- |
| **協議**        | 原生 Skill                             | MCP                  | MCP                      | MCP                    | MCP                   |
| **Config 路徑** | `~/.openclaw/skills/panguard/SKILL.md` | `~/.qclaw/mcp.json`  | `~/.workbuddy/.mcp.json` | `~/.nemoclaw/mcp.json` | `~/.arkclaw/mcp.json` |
| **安裝指令**    | `npx panguard setup`                   | `npx panguard setup` | `npx panguard setup`     | `npx panguard setup`   | `npx panguard setup`  |
| **需要帳號**    | 否                                     | 否                   | 否                       | 否                     | 否                    |
| **需要重啟**    | 是                                     | 是                   | 是                       | 是                     | 是                    |
