> ## Documentation Index
> Fetch the complete documentation index at: https://docs.panguard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 安裝到 OpenClaw 及相容平台

> OpenClaw、QClaw、WorkBuddy、NemoClaw、ArkClaw 一鍵安裝指南。不需帳號。

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

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

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

```bash theme={null}
curl -fsSL https://get.panguard.ai | bash && panguard setup
```

已經裝好 Panguard 的話：

```bash theme={null}
panguard setup
```

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

***

## OpenClaw

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

### 自動安裝

```bash theme={null}
npx panguard setup --platform openclaw
```

### 手動安裝

```bash theme={null}
mkdir -p ~/.openclaw/skills/panguard
npx panguard setup --platform openclaw
```

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

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

### 驗證

```bash theme={null}
ls ~/.openclaw/skills/panguard/SKILL.md
```

檔案在就代表裝好了。

***

## QClaw（騰訊）

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

### 自動安裝

```bash theme={null}
npx panguard setup --platform qclaw
```

### 手動安裝

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

```json theme={null}
{
  "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 theme={null}
cat ~/.qclaw/mcp.json
```

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

***

## WorkBuddy

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

### 自動安裝

```bash theme={null}
npx panguard setup --platform workbuddy
```

### 手動安裝

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

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

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

### 驗證

```bash theme={null}
cat ~/.workbuddy/.mcp.json
```

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

***

## NemoClaw

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

### 自動安裝

```bash theme={null}
npx panguard setup --platform nemoclaw
```

### 手動安裝

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

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

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

### 驗證

```bash theme={null}
cat ~/.nemoclaw/mcp.json
```

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

***

## ArkClaw

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

### 自動安裝

```bash theme={null}
npx panguard setup --platform arkclaw
```

### 手動安裝

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

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

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

### 驗證

```bash theme={null}
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 theme={null}
    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`  |
| **需要帳號**      | 否                                      | 否                    | 否                        | 否                      | 否                     |
| **需要重啟**      | 是                                      | 是                    | 是                        | 是                      | 是                     |