# Send Personaldatahub 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": "personaldatahub",
    "name": "Personaldatahub",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/haojian/personaldatahub",
    "canonicalUrl": "https://clawhub.ai/haojian/personaldatahub",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/personaldatahub",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=personaldatahub",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "dist/hub-client.d.ts",
      "dist/hub-client.js",
      "dist/index.d.ts",
      "dist/index.js",
      "dist/prompts.d.ts"
    ],
    "downloadMode": "redirect",
    "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/personaldatahub"
    },
    "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/personaldatahub",
    "downloadUrl": "https://openagent3.xyz/downloads/personaldatahub",
    "agentUrl": "https://openagent3.xyz/skills/personaldatahub/agent",
    "manifestUrl": "https://openagent3.xyz/skills/personaldatahub/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/personaldatahub/agent.md"
  }
}
```
## Documentation

### PersonalDataHub

Access personal data from Gmail, GitHub, and other sources through the PersonalDataHub access control gateway. The data owner controls what the agent can see, which fields are visible, what gets redacted, and which actions are allowed.

### MCP Setup (Recommended)

PersonalDataHub provides an MCP server for native tool discovery. Add to your Claude Code config (.claude/settings.json):

{
  "mcpServers": {
    "personaldatahub": {
      "command": "npx",
      "args": ["pdh", "mcp"]
    }
  }
}

This registers source-specific tools dynamically — only sources with connected OAuth tokens get tools.

### read_emails

(Gmail — requires connected Gmail OAuth)

Pull emails from Gmail. Data is filtered and redacted according to the owner's access control policy.

Parameters:

purpose (required) — Why this data is needed (logged for audit)
query (optional) — Gmail search query (e.g., "is:unread from:alice newer_than:7d")
limit (optional) — Maximum number of results

Example:

Pull my recent unread emails about the Q4 report.

### draft_email

(Gmail — requires connected Gmail OAuth)

Draft an email via Gmail. The draft is staged for the data owner to review — it does NOT send until approved.

Parameters:

to (required) — Recipient email address
subject (required) — Email subject
body (required) — Email body
purpose (required) — Why this action is being proposed (logged for audit)
in_reply_to (optional) — Message ID for threading

### send_email

(Gmail — requires connected Gmail OAuth)

Send an email via Gmail. The action is staged for the data owner to review — it does NOT execute until approved.

Parameters:

to (required) — Recipient email address
subject (required) — Email subject
body (required) — Email body
purpose (required) — Why this action is being proposed (logged for audit)
in_reply_to (optional) — Message ID for threading

### reply_to_email

(Gmail — requires connected Gmail OAuth)

Reply to an email via Gmail. The reply is staged for the data owner to review — it does NOT send until approved.

Parameters:

to (required) — Recipient email address
subject (required) — Email subject
body (required) — Email body
in_reply_to (required) — Message ID of the email being replied to
purpose (required) — Why this action is being proposed (logged for audit)

### search_github_issues

(GitHub — requires connected GitHub OAuth)

Search GitHub issues. Data is filtered according to the owner's access control policy.

Parameters:

purpose (required) — Why this data is needed (logged for audit)
query (optional) — Search query for issues
limit (optional) — Maximum number of results

### search_github_prs

(GitHub — requires connected GitHub OAuth)

Search GitHub pull requests. Data is filtered according to the owner's access control policy.

Parameters:

purpose (required) — Why this data is needed (logged for audit)
query (optional) — Search query for pull requests
limit (optional) — Maximum number of results

### Direct API Fallback

If the MCP tools above are not available, you can call the PersonalDataHub API directly via HTTP.

Config: Read ~/.pdh/config.json to get hubUrl.

Pull data:

curl -X POST <hubUrl>/app/v1/pull \\
  -H "Content-Type: application/json" \\
  -d '{"source": "gmail", "purpose": "reason for pulling data"}'

Propose an action:

curl -X POST <hubUrl>/app/v1/propose \\
  -H "Content-Type: application/json" \\
  -d '{"source": "gmail", "action_type": "draft_email", "action_data": {"to": "...", "subject": "...", "body": "..."}, "purpose": "reason for action"}'

### Troubleshooting

If calls fail, check if the PersonalDataHub server is running:

curl <hubUrl>/health

If the server is not running, find and start it:

# Check where PersonalDataHub is installed
cat ~/.pdh/config.json   # look at hubDir
# Start the server
cd <hubDir> && node dist/index.js

### Setup

The install hook bootstraps PersonalDataHub automatically:

Installs dependencies, builds the project, initializes the database
Saves hub URL and directory to ~/.pdh/config.json
Starts the server in the background

After installation, open http://localhost:3000 to connect Gmail/GitHub via OAuth.

Agents read config automatically from ~/.pdh/config.json — no manual configuration needed.

### Query Syntax (Gmail)

is:unread — unread emails
from:alice — emails from Alice
newer_than:7d — emails from the last 7 days
subject:report — emails with "report" in subject
Combine: is:unread from:alice newer_than:7d

### Important Notes

Data is filtered: The owner controls which fields you see. Some fields may be missing or redacted.
Actions require approval: All outbound actions (emails, drafts) go to a staging queue. The owner must approve before execution.
Everything is audited: Every pull and propose is logged with your purpose string.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: haojian
- Version: 0.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/personaldatahub)
- [Send to Agent page](https://openagent3.xyz/skills/personaldatahub/agent)
- [JSON manifest](https://openagent3.xyz/skills/personaldatahub/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/personaldatahub/agent.md)
- [Download page](https://openagent3.xyz/downloads/personaldatahub)