{"id":"e3893897-6ff6-4a8f-9448-77810c5002ab","entityType":"agent","slug":"clawhub-hith3sh-facebook-pages","name":"Facebook","canonicalUrl":"https://www.xpersona.co/agent/clawhub-hith3sh-facebook-pages","canonicalPath":"/agent/clawhub-hith3sh-facebook-pages","generatedAt":"2026-10-09T22:29:39.942Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T02:50:01.234Z","emptyReason":null},"description":"Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat. Skill: Facebook Owner: hith3sh Summary: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat. Tags: latest:1.0.7 Version history: v1.0.7 | 2026-10-03T19:40:43.316Z | user Security section now states that the public-data tools read other people'","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 7.7K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s173vws87a7ss71xf9rq53k5gd8568kv:facebook-pages","sourceUrl":"https://clawhub.ai/hith3sh/facebook-pages","homepage":"https://clawhub.ai/hith3sh/skills/facebook-pages","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/hith3sh/facebook-pages","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/hith3sh/skills/facebook-pages","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":78,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metri"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:50:01.234Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:50:01.234Z","emptyReason":null},"stars":null,"forks":null,"downloads":7716,"packageName":null,"latestVersion":"1.0.7","tractionLabel":"7.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:50:01.234Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T02:50:01.234Z","lastCrawledAt":"2026-10-09T02:50:01.234Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T02:50:01.234Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.7","createdAt":"2026-10-03T19:40:43.316Z","changelog":"Security section now states that the public-data tools read other people's public content without a connected account (read-only, paid from credit).","fileCount":3,"zipByteSize":6038},{"version":"1.0.6","createdAt":"2026-10-03T19:34:27.205Z","changelog":"New: read any public Facebook profile or post with no account to connect. Fixed images (they were broken).","fileCount":3,"zipByteSize":5932},{"version":"1.0.5","createdAt":"2026-06-09T07:07:31.771Z","changelog":"Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.","fileCount":3,"zipByteSize":5677},{"version":"1.0.4","createdAt":"2026-06-09T04:46:05.611Z","changelog":"- Removed the file skill-card.md from the skill package. - No changes to core features or documentation in SKILL.md.","fileCount":3,"zipByteSize":5625},{"version":"1.0.3","createdAt":"2026-06-08T16:46:48.362Z","changelog":"- No code or documentation changes detected in this version. - Version bump only; functionality and interfaces remain unchanged.","fileCount":3,"zipByteSize":5624},{"version":"1.0.1","createdAt":"2026-06-08T16:28:07.745Z","changelog":"- Added Facebook brand logo to documentation for improved visual clarity. - SKILL.md refined for readability; no changes to tool features or setup steps. - Removed redundant file: skill-card.md.","fileCount":3,"zipByteSize":5670},{"version":"0.1.1","createdAt":"2026-06-07T13:28:46.704Z","changelog":"Full rewrite to new standard: added tool reference tables, 3-step GIF table, architecture diagram, code examples, error handling, and troubleshooting.","fileCount":3,"zipByteSize":5507},{"version":"0.1.0","createdAt":"2026-05-03T15:31:57.062Z","changelog":"- Initial release of the facebook-pages skill. - Enables posting, managing comments/messages, and viewing insights on Facebook Pages via ClawLink integration. - Provides step-by-step setup and usage instructions for connecting ClawLink and Facebook. - Lists supported Facebook Page management tasks and outlines important usage rules. - Includes troubleshooting and resource links for additional help.","fileCount":3,"zipByteSize":3523}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s173vws87a7ss71xf9rq53k5gd8568kv:facebook-pages","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-facebook-pages/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-facebook-pages/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-facebook-pages/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-facebook-pages/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-facebook-pages/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-facebook-pages/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T22:29:39.940Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-facebook-pages/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-facebook-pages/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-facebook-pages/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-facebook-pages/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T02:50:01.234Z","emptyReason":null},"readme":"Skill: Facebook\n\nOwner: hith3sh\n\nSummary: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat.\n\nTags: latest:1.0.7\n\nVersion history:\n\nv1.0.7 | 2026-10-03T19:40:43.316Z | user\n\nSecurity section now states that the public-data tools read other people's public content without a connected account (read-only, paid from credit).\n\nv1.0.6 | 2026-10-03T19:34:27.205Z | user\n\nNew: read any public Facebook profile or post with no account to connect. Fixed images (they were broken).\n\nv1.0.5 | 2026-06-09T07:07:31.771Z | user\n\nAdd UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.\n\nv1.0.4 | 2026-06-09T04:46:05.611Z | auto\n\n- Removed the file skill-card.md from the skill package.\n- No changes to core features or documentation in SKILL.md.\n\nv1.0.3 | 2026-06-08T16:46:48.362Z | auto\n\n- No code or documentation changes detected in this version.\n- Version bump only; functionality and interfaces remain unchanged.\n\nv1.0.1 | 2026-06-08T16:28:07.745Z | auto\n\n- Added Facebook brand logo to documentation for improved visual clarity.\n- SKILL.md refined for readability; no changes to tool features or setup steps.\n- Removed redundant file: skill-card.md.\n\nv0.1.1 | 2026-06-07T13:28:46.704Z | user\n\nFull rewrite to new standard: added tool reference tables, 3-step GIF table, architecture diagram, code examples, error handling, and troubleshooting.\n\nv0.1.0 | 2026-05-03T15:31:57.062Z | auto\n\n- Initial release of the facebook-pages skill.\n- Enables posting, managing comments/messages, and viewing insights on Facebook Pages via ClawLink integration.\n- Provides step-by-step setup and usage instructions for connecting ClawLink and Facebook.\n- Lists supported Facebook Page management tasks and outlines important usage rules.\n- Includes troubleshooting and resource links for additional help.\n\nArchive index:\n\nArchive v1.0.7: 3 files, 6038 bytes\n\nFiles: skill-card.md (1948b), SKILL.md (14970b), _meta.json (133b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: facebook-pages\ndescription: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat.\n---\n\n# Facebook\n\n\n\nAccess Facebook Pages via the Graph API with managed OAuth authentication. Post content, read engagement, manage comments and messages, and view insights from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=facebook-pages) for hosted connection flows and credentials so you do not need to configure Facebook API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Facebook |\n|:---:|:---:|:---:|\n|  |  | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Facebook |\n\n## No Account Needed: Public Facebook Data\n\nRead any public Facebook page, post, group or event, search Marketplace, and browse the Meta Ad Library, without connecting a Facebook account. These tools work as soon as the plugin is paired: there is nothing to connect, and each call is paid from ClawLink credit (most cost a fraction of a cent; new accounts get $0.50 free).\n\n| Tool | What it returns | Price |\n|------|-----------------|-------|\n| `facebookdata_page_profile` | Public Facebook page or profile by URL: name, category, likes, followers, about | $0.00282 |\n| `facebookdata_page_posts` | Recent public posts of a Facebook page by URL | $0.00282 |\n| `facebookdata_post_comments` | Comments on a public Facebook post by URL | $0.00282 |\n| `facebookdata_ad_library_search` | Search the Meta Ad Library for active ads by keyword | $0.00282 |\n| `facebookdata_marketplace_search` | Search Facebook Marketplace listings near a point | $0.00282 |\n| `facebookdata_events_search` | Search public Facebook events by keyword | $0.00282 |\n\nUse the connected-account tools above for the user's own Facebook; use these for anyone else's public content. More: [Ad Spy](https://clawhub.ai/hith3sh/skills/ad-spy), [Transcribe Any Video](https://clawhub.ai/hith3sh/skills/transcribe-any-video).\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Facebook Graph │\n│ (User Chat) │ │ (OAuth) │ │ API │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Facebook │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Facebook │\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Facebook again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Facebook tools\nclawlink_list_tools --integration facebook\n\n# Search for a specific tool\nclawlink_search_tools --query \"post\" --integration facebook\n```\n\n## Authentication\n\nAll Facebook tool calls are authenticated automatically by ClawLink using the user's connected Facebook account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Facebook Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=facebook and connect Facebook.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `facebook` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration facebook\n```\n\n**Response:** Returns the live tool catalog for Facebook.\n\n### Reconnect\n\nIf Facebook tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=facebook\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration facebook`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Facebook is connected.\n2. Call `clawlink_list_tools --integration facebook` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `facebook`.\n5. If no Facebook tools appear, direct the user to https://claw-link.dev/dashboard?add=facebook.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List posts → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Describe tool → Preview changes → User approves │\n│ → Execute update │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Tool Reference\n\n### Pages& Profiles\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_list_managed_pages` | List Pages the user manages | Read |\n| `facebook_get_page_details` | Get Page metadata and settings | Read |\n| `facebook_get_page_roles` | Get Page roles and permissions | Read |\n| `facebook_update_page_settings` | Update Page settings | Write |\n\n### Posts\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_posts` | Get posts from a Page | Read |\n| `facebook_get_post` | Get a specific post | Read |\n| `facebook_create_post` | Create a text or link post | Write |\n| `facebook_create_photo_post` | Create a photo post | Write |\n| `facebook_update_post` | Update an existing post | Write |\n| `facebook_delete_post` | Delete a post | Write |\n| `facebook_get_scheduled_posts` | Get scheduled posts | Read |\n| `facebook_publish_scheduled_post` | Publish a scheduled post | Write |\n\n### Comments\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_comments` | Get comments on a post | Read |\n| `facebook_get_comment` | Get a specific comment | Read |\n| `facebook_create_comment` | Create a comment on a post | Write |\n| `facebook_update_comment` | Update a comment | Write |\n| `facebook_delete_comment` | Delete a comment | Write |\n\n### Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_conversations` | Get Page conversations | Read |\n| `facebook_get_conversation_messages` | Get messages in a conversation | Read |\n| `facebook_send_message` | Send a message from the Page | Write |\n| `facebook_send_media_message` | Send media (image/video) message | Write |\n| `facebook_mark_message_seen` | Mark a message as seen | Write |\n\n### Insights& Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_insights` | Get Page analytics and metrics | Read |\n| `facebook_get_post_insights` | Get post-specific insights | Read |\n| `facebook_get_post_reactions` | Get reactions on a post | Read |\n\n### Photo Albums\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_create_photo_album` | Create a photo album | Write |\n| `facebook_get_page_photos` | Get Page photos | Read |\n| `facebook_upload_photos_batch` | Upload multiple photos | Write |\n\n## Code Examples\n\n### List managed Pages\n\n```bash\nclawlink_call_tool --tool \"facebook_list_managed_pages\" \\\n --params '{}'\n```\n\n### Get Page posts\n\n```bash\nclawlink_call_tool --tool \"facebook_get_page_posts\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"limit\": 20\n }'\n```\n\n### Create a post\n\n```bash\nclawlink_call_tool --tool \"facebook_create_post\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"message\": \"Hello from ClawLink! This is an automated post.\"\n }'\n```\n\n### Get post insights\n\n```bash\nclawlink_call_tool --tool \"facebook_get_post_insights\" \\\n --params '{\n \"post_id\": \"YOUR_POST_ID\"\n }'\n```\n\n## Security & Permissions\n\n- Connected-account tools are scoped to the connected Facebook account's managed Pages and their permissions.\n- The public-data tools under \"No Account Needed\" read other people's public Facebook content (profiles, posts, comments) without any connected account. They are read-only, never post or change anything, and each call is paid from the user's ClawLink credit.\n- **All write operations require explicit user confirmation.** Before executing any create, update, or delete call, confirm the target resource and intended effect with the user.\n- Destructive actions (deleting posts, comments) are marked as high-impact and must be confirmed.\n- Publishing posts affects the Page's public-facing content; confirm all write operations.\n- Messaging operations deliver to real users; confirm before sending.\n\n## Notes\n\n- Facebook Graph API uses cursor-based pagination for large result sets.\n- CDN-based media URLs (from `source` field) are time-limited; download promptly if long-term access is needed.\n- Rate limits apply to API calls (error codes 4,17, 613); use backoff for high-volume operations.\n- The API version is v23.0 (released May 2025); older versions are deprecated.\n- Some permissions require Facebook app review before use in production.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration facebook`. |\n| Missing connection | Facebook is not connected. Direct the user to https://claw-link.dev/dashboard?add=facebook. |\n| `(#404) Page not found` | The Page ID does not exist or is not accessible. |\n| `(#200) Permission denied` | The app does not have the required permission. |\n| `(#190) Token expired` | The access token has expired. Reconnect Facebook. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `facebook`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)\n- ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=facebook-pages\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=facebook-pages)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.7:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"facebook-pages\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1791056443316\n}\n\nFile v1.0.7:skill-card.md\n\n## Description:\n\nManage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hith3sh](https://clawhub.ai/user/hith3sh)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nPage managers and their agents use this skill to publish content, moderate comments, respond to messages, and review engagement insights. They can also read public Facebook data without connecting an account.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Connecting a Facebook account grants access to managed Pages according to approved permissions.\n\nMitigation: Review the requested permissions during the ClawLink and Facebook connection flow.\n\nRisk: Public-data lookups consume paid ClawLink credit even without a connected Facebook account.\n\nMitigation: Check whether a public-data lookup is needed before making a paid call.\n\nRisk: Publishing, messaging, updating, or deleting can affect public content or real users.\n\nMitigation: Preview the target and intended effect, then obtain explicit user confirmation before executing a write.\n\n## Reference(s):\n\n- [Facebook skill on ClawHub](https://clawhub.ai/hith3sh/skills/facebook-pages)\n- [Facebook Graph API documentation](https://developers.facebook.com/docs/graph-api/)\n- [ClawLink documentation](https://docs.claw-link.dev/openclaw)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Markdown with inline shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [None]\n\n## Skill Version(s):\n\n1.0.7 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.6: 3 files, 5932 bytes\n\nFiles: skill-card.md (1878b), SKILL.md (14693b), _meta.json (133b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: facebook-pages\ndescription: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat.\n---\n\n# Facebook\n\n\n\nAccess Facebook Pages via the Graph API with managed OAuth authentication. Post content, read engagement, manage comments and messages, and view insights from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=facebook-pages) for hosted connection flows and credentials so you do not need to configure Facebook API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Facebook |\n|:---:|:---:|:---:|\n|  |  | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Facebook |\n\n## No Account Needed: Public Facebook Data\n\nRead any public Facebook page, post, group or event, search Marketplace, and browse the Meta Ad Library, without connecting a Facebook account. These tools work as soon as the plugin is paired: there is nothing to connect, and each call is paid from ClawLink credit (most cost a fraction of a cent; new accounts get $0.50 free).\n\n| Tool | What it returns | Price |\n|------|-----------------|-------|\n| `facebookdata_page_profile` | Public Facebook page or profile by URL: name, category, likes, followers, about | $0.00282 |\n| `facebookdata_page_posts` | Recent public posts of a Facebook page by URL | $0.00282 |\n| `facebookdata_post_comments` | Comments on a public Facebook post by URL | $0.00282 |\n| `facebookdata_ad_library_search` | Search the Meta Ad Library for active ads by keyword | $0.00282 |\n| `facebookdata_marketplace_search` | Search Facebook Marketplace listings near a point | $0.00282 |\n| `facebookdata_events_search` | Search public Facebook events by keyword | $0.00282 |\n\nUse the connected-account tools above for the user's own Facebook; use these for anyone else's public content. More: [Ad Spy](https://clawhub.ai/hith3sh/skills/ad-spy), [Transcribe Any Video](https://clawhub.ai/hith3sh/skills/transcribe-any-video).\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Facebook Graph │\n│ (User Chat) │ │ (OAuth) │ │ API │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Facebook │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Facebook │\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Facebook again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Facebook tools\nclawlink_list_tools --integration facebook\n\n# Search for a specific tool\nclawlink_search_tools --query \"post\" --integration facebook\n```\n\n## Authentication\n\nAll Facebook tool calls are authenticated automatically by ClawLink using the user's connected Facebook account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Facebook Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=facebook and connect Facebook.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `facebook` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration facebook\n```\n\n**Response:** Returns the live tool catalog for Facebook.\n\n### Reconnect\n\nIf Facebook tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=facebook\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration facebook`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Facebook is connected.\n2. Call `clawlink_list_tools --integration facebook` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `facebook`.\n5. If no Facebook tools appear, direct the user to https://claw-link.dev/dashboard?add=facebook.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List posts → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Describe tool → Preview changes → User approves │\n│ → Execute update │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Tool Reference\n\n### Pages& Profiles\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_list_managed_pages` | List Pages the user manages | Read |\n| `facebook_get_page_details` | Get Page metadata and settings | Read |\n| `facebook_get_page_roles` | Get Page roles and permissions | Read |\n| `facebook_update_page_settings` | Update Page settings | Write |\n\n### Posts\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_posts` | Get posts from a Page | Read |\n| `facebook_get_post` | Get a specific post | Read |\n| `facebook_create_post` | Create a text or link post | Write |\n| `facebook_create_photo_post` | Create a photo post | Write |\n| `facebook_update_post` | Update an existing post | Write |\n| `facebook_delete_post` | Delete a post | Write |\n| `facebook_get_scheduled_posts` | Get scheduled posts | Read |\n| `facebook_publish_scheduled_post` | Publish a scheduled post | Write |\n\n### Comments\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_comments` | Get comments on a post | Read |\n| `facebook_get_comment` | Get a specific comment | Read |\n| `facebook_create_comment` | Create a comment on a post | Write |\n| `facebook_update_comment` | Update a comment | Write |\n| `facebook_delete_comment` | Delete a comment | Write |\n\n### Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_conversations` | Get Page conversations | Read |\n| `facebook_get_conversation_messages` | Get messages in a conversation | Read |\n| `facebook_send_message` | Send a message from the Page | Write |\n| `facebook_send_media_message` | Send media (image/video) message | Write |\n| `facebook_mark_message_seen` | Mark a message as seen | Write |\n\n### Insights& Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_insights` | Get Page analytics and metrics | Read |\n| `facebook_get_post_insights` | Get post-specific insights | Read |\n| `facebook_get_post_reactions` | Get reactions on a post | Read |\n\n### Photo Albums\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_create_photo_album` | Create a photo album | Write |\n| `facebook_get_page_photos` | Get Page photos | Read |\n| `facebook_upload_photos_batch` | Upload multiple photos | Write |\n\n## Code Examples\n\n### List managed Pages\n\n```bash\nclawlink_call_tool --tool \"facebook_list_managed_pages\" \\\n --params '{}'\n```\n\n### Get Page posts\n\n```bash\nclawlink_call_tool --tool \"facebook_get_page_posts\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"limit\": 20\n }'\n```\n\n### Create a post\n\n```bash\nclawlink_call_tool --tool \"facebook_create_post\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"message\": \"Hello from ClawLink! This is an automated post.\"\n }'\n```\n\n### Get post insights\n\n```bash\nclawlink_call_tool --tool \"facebook_get_post_insights\" \\\n --params '{\n \"post_id\": \"YOUR_POST_ID\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Facebook account's managed Pages and their permissions.\n- **All write operations require explicit user confirmation.** Before executing any create, update, or delete call, confirm the target resource and intended effect with the user.\n- Destructive actions (deleting posts, comments) are marked as high-impact and must be confirmed.\n- Publishing posts affects the Page's public-facing content; confirm all write operations.\n- Messaging operations deliver to real users; confirm before sending.\n\n## Notes\n\n- Facebook Graph API uses cursor-based pagination for large result sets.\n- CDN-based media URLs (from `source` field) are time-limited; download promptly if long-term access is needed.\n- Rate limits apply to API calls (error codes 4,17, 613); use backoff for high-volume operations.\n- The API version is v23.0 (released May 2025); older versions are deprecated.\n- Some permissions require Facebook app review before use in production.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration facebook`. |\n| Missing connection | Facebook is not connected. Direct the user to https://claw-link.dev/dashboard?add=facebook. |\n| `(#404) Page not found` | The Page ID does not exist or is not accessible. |\n| `(#200) Permission denied` | The app does not have the required permission. |\n| `(#190) Token expired` | The access token has expired. Reconnect Facebook. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `facebook`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)\n- ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=facebook-pages\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=facebook-pages)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.6:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"facebook-pages\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1791056067205\n}\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nManage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API from chat.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hith3sh](https://clawhub.ai/user/hith3sh)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nPage managers and teams use this skill to review engagement and insights, publish posts, moderate comments, and respond to messages. It also helps users read public Facebook data without connecting an account.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Connected Facebook access can affect managed Pages and expose Page data through ClawLink.\n\nMitigation: Connect only the intended Facebook account and review the Pages and permissions granted during OAuth setup.\n\nRisk: Publishing, deleting, commenting, or messaging can change public content or reach real users.\n\nMitigation: Review the action preview, target, and intended effect; obtain explicit user confirmation before each write.\n\n## Reference(s):\n\n- [Facebook skill release](https://clawhub.ai/hith3sh/skills/facebook-pages)\n- [Facebook Graph API documentation](https://developers.facebook.com/docs/graph-api/)\n- [ClawLink OpenClaw documentation](https://docs.claw-link.dev/openclaw)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Guidance]\n\n**Output Format:** [Markdown responses with Page data, insights, and proposed actions]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include previews of changes before confirmed writes.]\n\n## Skill Version(s):\n\n1.0.6 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.5: 3 files, 5677 bytes\n\nFiles: skill-card.md (2484b), SKILL.md (13468b), _meta.json (133b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: facebook-pages\ndescription: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat.\n---\n\n# Facebook\n\n\n\nAccess Facebook Pages via the Graph API with managed OAuth authentication. Post content, read engagement, manage comments and messages, and view insights from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=facebook-pages) for hosted connection flows and credentials so you do not need to configure Facebook API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Facebook |\n|:---:|:---:|:---:|\n|  |  | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Facebook |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Facebook Graph │\n│ (User Chat) │ │ (OAuth) │ │ API │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Facebook │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Facebook │\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Facebook again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Facebook tools\nclawlink_list_tools --integration facebook\n\n# Search for a specific tool\nclawlink_search_tools --query \"post\" --integration facebook\n```\n\n## Authentication\n\nAll Facebook tool calls are authenticated automatically by ClawLink using the user's connected Facebook account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Facebook Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=facebook and connect Facebook.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `facebook` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration facebook\n```\n\n**Response:** Returns the live tool catalog for Facebook.\n\n### Reconnect\n\nIf Facebook tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=facebook\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration facebook`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Facebook is connected.\n2. Call `clawlink_list_tools --integration facebook` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `facebook`.\n5. If no Facebook tools appear, direct the user to https://claw-link.dev/dashboard?add=facebook.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List posts → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Describe tool → Preview changes → User approves │\n│ → Execute update │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Tool Reference\n\n### Pages& Profiles\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_list_managed_pages` | List Pages the user manages | Read |\n| `facebook_get_page_details` | Get Page metadata and settings | Read |\n| `facebook_get_page_roles` | Get Page roles and permissions | Read |\n| `facebook_update_page_settings` | Update Page settings | Write |\n\n### Posts\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_posts` | Get posts from a Page | Read |\n| `facebook_get_post` | Get a specific post | Read |\n| `facebook_create_post` | Create a text or link post | Write |\n| `facebook_create_photo_post` | Create a photo post | Write |\n| `facebook_update_post` | Update an existing post | Write |\n| `facebook_delete_post` | Delete a post | Write |\n| `facebook_get_scheduled_posts` | Get scheduled posts | Read |\n| `facebook_publish_scheduled_post` | Publish a scheduled post | Write |\n\n### Comments\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_comments` | Get comments on a post | Read |\n| `facebook_get_comment` | Get a specific comment | Read |\n| `facebook_create_comment` | Create a comment on a post | Write |\n| `facebook_update_comment` | Update a comment | Write |\n| `facebook_delete_comment` | Delete a comment | Write |\n\n### Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_conversations` | Get Page conversations | Read |\n| `facebook_get_conversation_messages` | Get messages in a conversation | Read |\n| `facebook_send_message` | Send a message from the Page | Write |\n| `facebook_send_media_message` | Send media (image/video) message | Write |\n| `facebook_mark_message_seen` | Mark a message as seen | Write |\n\n### Insights& Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_insights` | Get Page analytics and metrics | Read |\n| `facebook_get_post_insights` | Get post-specific insights | Read |\n| `facebook_get_post_reactions` | Get reactions on a post | Read |\n\n### Photo Albums\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_create_photo_album` | Create a photo album | Write |\n| `facebook_get_page_photos` | Get Page photos | Read |\n| `facebook_upload_photos_batch` | Upload multiple photos | Write |\n\n## Code Examples\n\n### List managed Pages\n\n```bash\nclawlink_call_tool --tool \"facebook_list_managed_pages\" \\\n --params '{}'\n```\n\n### Get Page posts\n\n```bash\nclawlink_call_tool --tool \"facebook_get_page_posts\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"limit\": 20\n }'\n```\n\n### Create a post\n\n```bash\nclawlink_call_tool --tool \"facebook_create_post\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"message\": \"Hello from ClawLink! This is an automated post.\"\n }'\n```\n\n### Get post insights\n\n```bash\nclawlink_call_tool --tool \"facebook_get_post_insights\" \\\n --params '{\n \"post_id\": \"YOUR_POST_ID\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Facebook account's managed Pages and their permissions.\n- **All write operations require explicit user confirmation.** Before executing any create, update, or delete call, confirm the target resource and intended effect with the user.\n- Destructive actions (deleting posts, comments) are marked as high-impact and must be confirmed.\n- Publishing posts affects the Page's public-facing content; confirm all write operations.\n- Messaging operations deliver to real users; confirm before sending.\n\n## Notes\n\n- Facebook Graph API uses cursor-based pagination for large result sets.\n- CDN-based media URLs (from `source` field) are time-limited; download promptly if long-term access is needed.\n- Rate limits apply to API calls (error codes 4,17, 613); use backoff for high-volume operations.\n- The API version is v23.0 (released May 2025); older versions are deprecated.\n- Some permissions require Facebook app review before use in production.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration facebook`. |\n| Missing connection | Facebook is not connected. Direct the user to https://claw-link.dev/dashboard?add=facebook. |\n| `(#404) Page not found` | The Page ID does not exist or is not accessible. |\n| `(#200) Permission denied` | The app does not have the required permission. |\n| `(#190) Token expired` | The access token has expired. Reconnect Facebook. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `facebook`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)\n- ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=facebook-pages\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=facebook-pages)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.5:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"facebook-pages\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1780988851771\n}\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\nManage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API from chat.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hith3sh](https://clawhub.ai/user/hith3sh)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to connect Facebook Pages through ClawLink, inspect page content and analytics, and prepare or execute confirmed Page updates, posts, comments, and messages.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill asks users to install and allowlist an unpinned third-party plugin that can handle OAuth-backed Facebook Page actions.\n\nMitigation: Review the ClawLink plugin and publisher before installing, and allowlist it only after the reviewer accepts that dependency.\n\nRisk: Connected Facebook Pages can be changed through posts, comments, messages, updates, or deletes.\n\nMitigation: Confirm every write preview carefully before execution, especially public posts, messages to users, and destructive actions.\n\nRisk: OAuth-backed access may expose managed Facebook Page capabilities through the connected ClawLink account.\n\nMitigation: Connect only Facebook Pages the user is comfortable managing through ClawLink and revoke or reconnect access when permissions change.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/skills/facebook-pages)\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw)\n- [ClawLink Verification](https://claw-link.dev/verify)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Shell commands, Configuration, API calls, Guidance]\n\n**Output Format:** [Markdown with inline shell commands and JSON tool parameters]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Uses live ClawLink tool discovery and previews confirmed write operations before execution.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.4: 3 files, 5625 bytes\n\nFiles: skill-card.md (2591b), SKILL.md (13267b), _meta.json (133b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: facebook-pages\ndescription: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat.\n---\n\n# Facebook\n\n\n\nAccess Facebook Pages via the Graph API with managed OAuth authentication. Post content, read engagement, manage comments and messages, and view insights from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Facebook API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Facebook |\n|:---:|:---:|:---:|\n|  |  | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Facebook |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Facebook Graph │\n│ (User Chat) │ │ (OAuth) │ │ API │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Facebook │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Facebook │\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Facebook again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Facebook tools\nclawlink_list_tools --integration facebook\n\n# Search for a specific tool\nclawlink_search_tools --query \"post\" --integration facebook\n```\n\n## Authentication\n\nAll Facebook tool calls are authenticated automatically by ClawLink using the user's connected Facebook account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Facebook Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=facebook and connect Facebook.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `facebook` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration facebook\n```\n\n**Response:** Returns the live tool catalog for Facebook.\n\n### Reconnect\n\nIf Facebook tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=facebook\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration facebook`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Facebook is connected.\n2. Call `clawlink_list_tools --integration facebook` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `facebook`.\n5. If no Facebook tools appear, direct the user to https://claw-link.dev/dashboard?add=facebook.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List posts → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Describe tool → Preview changes → User approves │\n│ → Execute update │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Tool Reference\n\n### Pages& Profiles\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_list_managed_pages` | List Pages the user manages | Read |\n| `facebook_get_page_details` | Get Page metadata and settings | Read |\n| `facebook_get_page_roles` | Get Page roles and permissions | Read |\n| `facebook_update_page_settings` | Update Page settings | Write |\n\n### Posts\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_posts` | Get posts from a Page | Read |\n| `facebook_get_post` | Get a specific post | Read |\n| `facebook_create_post` | Create a text or link post | Write |\n| `facebook_create_photo_post` | Create a photo post | Write |\n| `facebook_update_post` | Update an existing post | Write |\n| `facebook_delete_post` | Delete a post | Write |\n| `facebook_get_scheduled_posts` | Get scheduled posts | Read |\n| `facebook_publish_scheduled_post` | Publish a scheduled post | Write |\n\n### Comments\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_comments` | Get comments on a post | Read |\n| `facebook_get_comment` | Get a specific comment | Read |\n| `facebook_create_comment` | Create a comment on a post | Write |\n| `facebook_update_comment` | Update a comment | Write |\n| `facebook_delete_comment` | Delete a comment | Write |\n\n### Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_conversations` | Get Page conversations | Read |\n| `facebook_get_conversation_messages` | Get messages in a conversation | Read |\n| `facebook_send_message` | Send a message from the Page | Write |\n| `facebook_send_media_message` | Send media (image/video) message | Write |\n| `facebook_mark_message_seen` | Mark a message as seen | Write |\n\n### Insights& Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_insights` | Get Page analytics and metrics | Read |\n| `facebook_get_post_insights` | Get post-specific insights | Read |\n| `facebook_get_post_reactions` | Get reactions on a post | Read |\n\n### Photo Albums\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_create_photo_album` | Create a photo album | Write |\n| `facebook_get_page_photos` | Get Page photos | Read |\n| `facebook_upload_photos_batch` | Upload multiple photos | Write |\n\n## Code Examples\n\n### List managed Pages\n\n```bash\nclawlink_call_tool --tool \"facebook_list_managed_pages\" \\\n --params '{}'\n```\n\n### Get Page posts\n\n```bash\nclawlink_call_tool --tool \"facebook_get_page_posts\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"limit\": 20\n }'\n```\n\n### Create a post\n\n```bash\nclawlink_call_tool --tool \"facebook_create_post\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"message\": \"Hello from ClawLink! This is an automated post.\"\n }'\n```\n\n### Get post insights\n\n```bash\nclawlink_call_tool --tool \"facebook_get_post_insights\" \\\n --params '{\n \"post_id\": \"YOUR_POST_ID\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Facebook account's managed Pages and their permissions.\n- **All write operations require explicit user confirmation.** Before executing any create, update, or delete call, confirm the target resource and intended effect with the user.\n- Destructive actions (deleting posts, comments) are marked as high-impact and must be confirmed.\n- Publishing posts affects the Page's public-facing content; confirm all write operations.\n- Messaging operations deliver to real users; confirm before sending.\n\n## Notes\n\n- Facebook Graph API uses cursor-based pagination for large result sets.\n- CDN-based media URLs (from `source` field) are time-limited; download promptly if long-term access is needed.\n- Rate limits apply to API calls (error codes 4,17, 613); use backoff for high-volume operations.\n- The API version is v23.0 (released May 2025); older versions are deprecated.\n- Some permissions require Facebook app review before use in production.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration facebook`. |\n| Missing connection | Facebook is not connected. Direct the user to https://claw-link.dev/dashboard?add=facebook. |\n| `(#404) Page not found` | The Page ID does not exist or is not accessible. |\n| `(#200) Permission denied` | The app does not have the required permission. |\n| `(#190) Token expired` | The access token has expired. Reconnect Facebook. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `facebook`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)\n- ClawLink: https://claw-link.dev\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"facebook-pages\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1780980365611\n}\n\nFile v1.0.4:skill-card.md\n\n## Description:
\nManage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API from chat.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[hith3sh](https://clawhub.ai/user/hith3sh)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and developers use this skill to manage Facebook Page content, moderation, messaging, and analytics from OpenClaw chat through a connected Facebook account.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The connected Facebook account can expose Page content, comments, messages, analytics, and permissions through the skill.
\nMitigation: Connect only Facebook Pages the user intends to manage from OpenClaw and verify the active connection before using Page tools.
\nRisk: Create, update, delete, publishing, settings, and messaging actions can alter public Page content or send messages to real users.
\nMitigation: Preview high-impact actions and require explicit user confirmation before executing writes, deletes, publishing, settings changes, or messages.
\nRisk: OAuth access is sensitive and can expire or lose required permissions.
\nMitigation: Use the managed ClawLink OAuth connection instead of asking for API keys or tokens, and reconnect Facebook when token or permission errors occur.
\n\n\n## Reference(s):
\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/facebook-pages)
\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)
\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)
\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)
\n- [ClawLink OpenClaw Docs](https://docs.claw-link.dev/openclaw)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, API calls, Guidance]
\n**Output Format:** [Markdown with inline shell commands and JSON parameters]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses OAuth-backed ClawLink tool calls; write and destructive actions require explicit user confirmation.]
\n\n## Skill Version(s):
\n1.0.4 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.3: 3 files, 5624 bytes\n\nFiles: skill-card.md (2536b), SKILL.md (13267b), _meta.json (133b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: facebook-pages\ndescription: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat.\n---\n\n# Facebook\n\n\n\nAccess Facebook Pages via the Graph API with managed OAuth authentication. Post content, read engagement, manage comments and messages, and view insights from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Facebook API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Facebook |\n|:---:|:---:|:---:|\n|  |  | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Facebook |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Facebook Graph │\n│ (User Chat) │ │ (OAuth) │ │ API │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Facebook │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Facebook │\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Facebook again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Facebook tools\nclawlink_list_tools --integration facebook\n\n# Search for a specific tool\nclawlink_search_tools --query \"post\" --integration facebook\n```\n\n## Authentication\n\nAll Facebook tool calls are authenticated automatically by ClawLink using the user's connected Facebook account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Facebook Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=facebook and connect Facebook.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `facebook` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration facebook\n```\n\n**Response:** Returns the live tool catalog for Facebook.\n\n### Reconnect\n\nIf Facebook tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=facebook\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration facebook`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Facebook is connected.\n2. Call `clawlink_list_tools --integration facebook` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `facebook`.\n5. If no Facebook tools appear, direct the user to https://claw-link.dev/dashboard?add=facebook.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List posts → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Describe tool → Preview changes → User approves │\n│ → Execute update │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Tool Reference\n\n### Pages& Profiles\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_list_managed_pages` | List Pages the user manages | Read |\n| `facebook_get_page_details` | Get Page metadata and settings | Read |\n| `facebook_get_page_roles` | Get Page roles and permissions | Read |\n| `facebook_update_page_settings` | Update Page settings | Write |\n\n### Posts\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_posts` | Get posts from a Page | Read |\n| `facebook_get_post` | Get a specific post | Read |\n| `facebook_create_post` | Create a text or link post | Write |\n| `facebook_create_photo_post` | Create a photo post | Write |\n| `facebook_update_post` | Update an existing post | Write |\n| `facebook_delete_post` | Delete a post | Write |\n| `facebook_get_scheduled_posts` | Get scheduled posts | Read |\n| `facebook_publish_scheduled_post` | Publish a scheduled post | Write |\n\n### Comments\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_comments` | Get comments on a post | Read |\n| `facebook_get_comment` | Get a specific comment | Read |\n| `facebook_create_comment` | Create a comment on a post | Write |\n| `facebook_update_comment` | Update a comment | Write |\n| `facebook_delete_comment` | Delete a comment | Write |\n\n### Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_conversations` | Get Page conversations | Read |\n| `facebook_get_conversation_messages` | Get messages in a conversation | Read |\n| `facebook_send_message` | Send a message from the Page | Write |\n| `facebook_send_media_message` | Send media (image/video) message | Write |\n| `facebook_mark_message_seen` | Mark a message as seen | Write |\n\n### Insights& Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_insights` | Get Page analytics and metrics | Read |\n| `facebook_get_post_insights` | Get post-specific insights | Read |\n| `facebook_get_post_reactions` | Get reactions on a post | Read |\n\n### Photo Albums\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_create_photo_album` | Create a photo album | Write |\n| `facebook_get_page_photos` | Get Page photos | Read |\n| `facebook_upload_photos_batch` | Upload multiple photos | Write |\n\n## Code Examples\n\n### List managed Pages\n\n```bash\nclawlink_call_tool --tool \"facebook_list_managed_pages\" \\\n --params '{}'\n```\n\n### Get Page posts\n\n```bash\nclawlink_call_tool --tool \"facebook_get_page_posts\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"limit\": 20\n }'\n```\n\n### Create a post\n\n```bash\nclawlink_call_tool --tool \"facebook_create_post\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"message\": \"Hello from ClawLink! This is an automated post.\"\n }'\n```\n\n### Get post insights\n\n```bash\nclawlink_call_tool --tool \"facebook_get_post_insights\" \\\n --params '{\n \"post_id\": \"YOUR_POST_ID\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Facebook account's managed Pages and their permissions.\n- **All write operations require explicit user confirmation.** Before executing any create, update, or delete call, confirm the target resource and intended effect with the user.\n- Destructive actions (deleting posts, comments) are marked as high-impact and must be confirmed.\n- Publishing posts affects the Page's public-facing content; confirm all write operations.\n- Messaging operations deliver to real users; confirm before sending.\n\n## Notes\n\n- Facebook Graph API uses cursor-based pagination for large result sets.\n- CDN-based media URLs (from `source` field) are time-limited; download promptly if long-term access is needed.\n- Rate limits apply to API calls (error codes 4,17, 613); use backoff for high-volume operations.\n- The API version is v23.0 (released May 2025); older versions are deprecated.\n- Some permissions require Facebook app review before use in production.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration facebook`. |\n| Missing connection | Facebook is not connected. Direct the user to https://claw-link.dev/dashboard?add=facebook. |\n| `(#404) Page not found` | The Page ID does not exist or is not accessible. |\n| `(#200) Permission denied` | The app does not have the required permission. |\n| `(#190) Token expired` | The access token has expired. Reconnect Facebook. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `facebook`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)\n- ClawLink: https://claw-link.dev\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.3:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"facebook-pages\",\n \"version\": \"1.0.3\",\n \"publishedAt\": 1780937208362\n}\n\nFile v1.0.3:skill-card.md\n\n## Description:
\nManage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[hith3sh](https://clawhub.ai/user/hith3sh)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and developers use this skill to manage Facebook Pages from chat through ClawLink, including reading Page data, publishing content, moderating comments, messaging, and reviewing insights.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires OAuth access to connected Facebook Pages.
\nMitigation: Review the Facebook OAuth consent screen, connect only intended Pages, and revoke the ClawLink connection when access is no longer needed.
\nRisk: Write actions can publish or modify public Page content.
\nMitigation: Keep create, update, publish, and delete operations behind explicit user confirmation and preview the target resource and intended effect before execution.
\nRisk: Messaging actions can send content to real users.
\nMitigation: Confirm message recipients and content before sending or marking conversations as seen.
\nRisk: High-volume Facebook Graph API calls can hit rate limits.
\nMitigation: Use pagination and backoff for large reads or repeated calls.
\n\n\n## Reference(s):
\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/facebook-pages)
\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)
\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)
\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)
\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw)
\n\n\n## Skill Output:
\n**Output Type(s):** [Guidance, Shell commands, Configuration, API Calls]
\n**Output Format:** [Markdown with inline shell commands and tool-call examples]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses ClawLink OAuth and requires explicit confirmation before public or destructive write actions.]
\n\n## Skill Version(s):
\n1.0.3 (source: release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.1: 3 files, 5670 bytes\n\nFiles: skill-card.md (2685b), SKILL.md (13267b), _meta.json (133b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: facebook-pages\ndescription: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat.\n---\n\n# Facebook\n\n\n\nAccess Facebook Pages via the Graph API with managed OAuth authentication. Post content, read engagement, manage comments and messages, and view insights from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Facebook API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Facebook |\n|:---:|:---:|:---:|\n|  |  | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Facebook |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Facebook Graph │\n│ (User Chat) │ │ (OAuth) │ │ API │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Facebook │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Facebook │\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Facebook again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Facebook tools\nclawlink_list_tools --integration facebook\n\n# Search for a specific tool\nclawlink_search_tools --query \"post\" --integration facebook\n```\n\n## Authentication\n\nAll Facebook tool calls are authenticated automatically by ClawLink using the user's connected Facebook account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Facebook Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=facebook and connect Facebook.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `facebook` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration facebook\n```\n\n**Response:** Returns the live tool catalog for Facebook.\n\n### Reconnect\n\nIf Facebook tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=facebook\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration facebook`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Facebook is connected.\n2. Call `clawlink_list_tools --integration facebook` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `facebook`.\n5. If no Facebook tools appear, direct the user to https://claw-link.dev/dashboard?add=facebook.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List posts → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Describe tool → Preview changes → User approves │\n│ → Execute update │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Tool Reference\n\n### Pages& Profiles\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_list_managed_pages` | List Pages the user manages | Read |\n| `facebook_get_page_details` | Get Page metadata and settings | Read |\n| `facebook_get_page_roles` | Get Page roles and permissions | Read |\n| `facebook_update_page_settings` | Update Page settings | Write |\n\n### Posts\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_posts` | Get posts from a Page | Read |\n| `facebook_get_post` | Get a specific post | Read |\n| `facebook_create_post` | Create a text or link post | Write |\n| `facebook_create_photo_post` | Create a photo post | Write |\n| `facebook_update_post` | Update an existing post | Write |\n| `facebook_delete_post` | Delete a post | Write |\n| `facebook_get_scheduled_posts` | Get scheduled posts | Read |\n| `facebook_publish_scheduled_post` | Publish a scheduled post | Write |\n\n### Comments\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_comments` | Get comments on a post | Read |\n| `facebook_get_comment` | Get a specific comment | Read |\n| `facebook_create_comment` | Create a comment on a post | Write |\n| `facebook_update_comment` | Update a comment | Write |\n| `facebook_delete_comment` | Delete a comment | Write |\n\n### Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_conversations` | Get Page conversations | Read |\n| `facebook_get_conversation_messages` | Get messages in a conversation | Read |\n| `facebook_send_message` | Send a message from the Page | Write |\n| `facebook_send_media_message` | Send media (image/video) message | Write |\n| `facebook_mark_message_seen` | Mark a message as seen | Write |\n\n### Insights& Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_insights` | Get Page analytics and metrics | Read |\n| `facebook_get_post_insights` | Get post-specific insights | Read |\n| `facebook_get_post_reactions` | Get reactions on a post | Read |\n\n### Photo Albums\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_create_photo_album` | Create a photo album | Write |\n| `facebook_get_page_photos` | Get Page photos | Read |\n| `facebook_upload_photos_batch` | Upload multiple photos | Write |\n\n## Code Examples\n\n### List managed Pages\n\n```bash\nclawlink_call_tool --tool \"facebook_list_managed_pages\" \\\n --params '{}'\n```\n\n### Get Page posts\n\n```bash\nclawlink_call_tool --tool \"facebook_get_page_posts\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"limit\": 20\n }'\n```\n\n### Create a post\n\n```bash\nclawlink_call_tool --tool \"facebook_create_post\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"message\": \"Hello from ClawLink! This is an automated post.\"\n }'\n```\n\n### Get post insights\n\n```bash\nclawlink_call_tool --tool \"facebook_get_post_insights\" \\\n --params '{\n \"post_id\": \"YOUR_POST_ID\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Facebook account's managed Pages and their permissions.\n- **All write operations require explicit user confirmation.** Before executing any create, update, or delete call, confirm the target resource and intended effect with the user.\n- Destructive actions (deleting posts, comments) are marked as high-impact and must be confirmed.\n- Publishing posts affects the Page's public-facing content; confirm all write operations.\n- Messaging operations deliver to real users; confirm before sending.\n\n## Notes\n\n- Facebook Graph API uses cursor-based pagination for large result sets.\n- CDN-based media URLs (from `source` field) are time-limited; download promptly if long-term access is needed.\n- Rate limits apply to API calls (error codes 4,17, 613); use backoff for high-volume operations.\n- The API version is v23.0 (released May 2025); older versions are deprecated.\n- Some permissions require Facebook app review before use in production.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration facebook`. |\n| Missing connection | Facebook is not connected. Direct the user to https://claw-link.dev/dashboard?add=facebook. |\n| `(#404) Page not found` | The Page ID does not exist or is not accessible. |\n| `(#200) Permission denied` | The app does not have the required permission. |\n| `(#190) Token expired` | The access token has expired. Reconnect Facebook. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `facebook`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)\n- ClawLink: https://claw-link.dev\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"facebook-pages\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1780936087745\n}\n\nFile v1.0.1:skill-card.md\n\n## Description:
\nManage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[hith3sh](https://clawhub.ai/user/hith3sh)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users, Page operators, and developers use this skill to manage Facebook Page content, engagement, comments, messages, insights, and OAuth-backed Page workflows from an agent chat.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires OAuth-backed access to Facebook Page data and actions.
\nMitigation: Use the connected account's scoped permissions and reconnect through ClawLink if authentication or authorization fails.
\nRisk: Publishing, updating, deleting, or messaging can affect public Page content or real users.
\nMitigation: Preview and explicitly confirm write, destructive, publishing, and messaging actions before execution.
\nRisk: Facebook API permissions, rate limits, and token expiry can prevent requested operations.
\nMitigation: Verify available tools and connection state before calls, report real API errors, and use backoff or reconnection when required.
\n\n\n## Reference(s):
\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)
\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)
\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)
\n- [ClawLink](https://claw-link.dev)
\n- [ClawLink OpenClaw Docs](https://docs.claw-link.dev/openclaw)
\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/facebook-pages)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, API calls, guidance]
\n**Output Format:** [Markdown with inline shell commands and JSON-like tool parameters]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Outputs may include Facebook Graph API tool calls routed through ClawLink and user-facing summaries of Page data or requested actions.]
\n\n## Skill Version(s):
\n1.0.1 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v0.1.1: 3 files, 5507 bytes\n\nFiles: skill-card.md (2302b), SKILL.md (13154b), _meta.json (133b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: facebook-pages\ndescription: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat.\n---\n\n# Facebook\n\nAccess Facebook Pages via the Graph API with managed OAuth authentication. Post content, read engagement, manage comments and messages, and view insights from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Facebook API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Facebook |\n|:---:|:---:|:---:|\n|  |  | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Facebook |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Facebook Graph │\n│ (User Chat) │ │ (OAuth) │ │ API │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Facebook │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Facebook │\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Facebook again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Facebook tools\nclawlink_list_tools --integration facebook\n\n# Search for a specific tool\nclawlink_search_tools --query \"post\" --integration facebook\n```\n\n## Authentication\n\nAll Facebook tool calls are authenticated automatically by ClawLink using the user's connected Facebook account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Facebook Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=facebook and connect Facebook.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `facebook` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration facebook\n```\n\n**Response:** Returns the live tool catalog for Facebook.\n\n### Reconnect\n\nIf Facebook tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=facebook\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration facebook`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Facebook is connected.\n2. Call `clawlink_list_tools --integration facebook` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `facebook`.\n5. If no Facebook tools appear, direct the user to https://claw-link.dev/dashboard?add=facebook.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List posts → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Describe tool → Preview changes → User approves │\n│ → Execute update │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Tool Reference\n\n### Pages& Profiles\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_list_managed_pages` | List Pages the user manages | Read |\n| `facebook_get_page_details` | Get Page metadata and settings | Read |\n| `facebook_get_page_roles` | Get Page roles and permissions | Read |\n| `facebook_update_page_settings` | Update Page settings | Write |\n\n### Posts\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_posts` | Get posts from a Page | Read |\n| `facebook_get_post` | Get a specific post | Read |\n| `facebook_create_post` | Create a text or link post | Write |\n| `facebook_create_photo_post` | Create a photo post | Write |\n| `facebook_update_post` | Update an existing post | Write |\n| `facebook_delete_post` | Delete a post | Write |\n| `facebook_get_scheduled_posts` | Get scheduled posts | Read |\n| `facebook_publish_scheduled_post` | Publish a scheduled post | Write |\n\n### Comments\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_comments` | Get comments on a post | Read |\n| `facebook_get_comment` | Get a specific comment | Read |\n| `facebook_create_comment` | Create a comment on a post | Write |\n| `facebook_update_comment` | Update a comment | Write |\n| `facebook_delete_comment` | Delete a comment | Write |\n\n### Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_conversations` | Get Page conversations | Read |\n| `facebook_get_conversation_messages` | Get messages in a conversation | Read |\n| `facebook_send_message` | Send a message from the Page | Write |\n| `facebook_send_media_message` | Send media (image/video) message | Write |\n| `facebook_mark_message_seen` | Mark a message as seen | Write |\n\n### Insights& Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_get_page_insights` | Get Page analytics and metrics | Read |\n| `facebook_get_post_insights` | Get post-specific insights | Read |\n| `facebook_get_post_reactions` | Get reactions on a post | Read |\n\n### Photo Albums\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `facebook_create_photo_album` | Create a photo album | Write |\n| `facebook_get_page_photos` | Get Page photos | Read |\n| `facebook_upload_photos_batch` | Upload multiple photos | Write |\n\n## Code Examples\n\n### List managed Pages\n\n```bash\nclawlink_call_tool --tool \"facebook_list_managed_pages\" \\\n --params '{}'\n```\n\n### Get Page posts\n\n```bash\nclawlink_call_tool --tool \"facebook_get_page_posts\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"limit\": 20\n }'\n```\n\n### Create a post\n\n```bash\nclawlink_call_tool --tool \"facebook_create_post\" \\\n --params '{\n \"page_id\": \"YOUR_PAGE_ID\",\n \"message\": \"Hello from ClawLink! This is an automated post.\"\n }'\n```\n\n### Get post insights\n\n```bash\nclawlink_call_tool --tool \"facebook_get_post_insights\" \\\n --params '{\n \"post_id\": \"YOUR_POST_ID\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Facebook account's managed Pages and their permissions.\n- **All write operations require explicit user confirmation.** Before executing any create, update, or delete call, confirm the target resource and intended effect with the user.\n- Destructive actions (deleting posts, comments) are marked as high-impact and must be confirmed.\n- Publishing posts affects the Page's public-facing content; confirm all write operations.\n- Messaging operations deliver to real users; confirm before sending.\n\n## Notes\n\n- Facebook Graph API uses cursor-based pagination for large result sets.\n- CDN-based media URLs (from `source` field) are time-limited; download promptly if long-term access is needed.\n- Rate limits apply to API calls (error codes 4,17, 613); use backoff for high-volume operations.\n- The API version is v23.0 (released May 2025); older versions are deprecated.\n- Some permissions require Facebook app review before use in production.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration facebook`. |\n| Missing connection | Facebook is not connected. Direct the user to https://claw-link.dev/dashboard?add=facebook. |\n| `(#404) Page not found` | The Page ID does not exist or is not accessible. |\n| `(#200) Permission denied` | The app does not have the required permission. |\n| `(#190) Token expired` | The access token has expired. Reconnect Facebook. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `facebook`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)\n- ClawLink: https://claw-link.dev\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n\n\nFile v0.1.1:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"facebook-pages\",\n \"version\": \"0.1.1\",\n \"publishedAt\": 1780838926704\n}\n\nFile v0.1.1:skill-card.md\n\n## Description:
\nManage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[hith3sh](https://clawhub.ai/user/hith3sh)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and operators use this skill to manage Facebook Pages from chat, including publishing posts, reading engagement metrics, moderating comments, responding to messages, and checking insights.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill connects a Facebook account that can read Page data and make public-facing changes.
\nMitigation: Only connect Pages the user intends to manage from OpenClaw and review previews before approving posts, messages, deletions, or settings changes.
\nRisk: Publishing, messaging, or deleting content can affect public Page content or real conversations.
\nMitigation: Require explicit confirmation for write, public-facing, and destructive actions before calling execution tools.
\n\n\n## Reference(s):
\n- [Facebook Graph API Documentation](https://developers.facebook.com/docs/graph-api/)
\n- [Facebook Graph API Reference](https://developers.facebook.com/docs/graph-api/reference/)
\n- [Facebook Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog)
\n- [ClawLink OpenClaw Documentation](https://docs.claw-link.dev/openclaw)
\n- [ClawLink](https://claw-link.dev)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown with inline shell commands and tool call examples]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Guides agents to discover live ClawLink Facebook tools, preview write actions, and request confirmation before public or destructive changes.]
\n\n## Skill Version(s):
\n0.1.1 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v0.1.0: 3 files, 3523 bytes\n\nFiles: skill-card.md (2414b), SKILL.md (5087b), _meta.json (133b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: facebook-pages\ndescription: Post content, read engagement, manage comments and messages, and view insights on Facebook Pages — powered by ClawLink.\n---\n\n# Facebook via ClawLink\n\nWork with Facebook Pages from chat — post content, read engagement, manage comments and messages, and view insights.\n\nPowered by [ClawLink](https://claw-link.dev), an integration hub for OpenClaw that handles hosted connection flows and credentials so you don't need to configure Facebook API access yourself.\n\n## Quick start\n\n1. Install the verified ClawLink plugin: `openclaw plugins install clawhub:clawlink-plugin`\n2. Start a fresh OpenClaw chat if the plugin was just installed and ClawLink tools are not visible yet\n3. If ClawLink is not configured, call `clawlink_begin_pairing`\n4. Tell the user to open the returned pairing URL, sign in to ClawLink if needed, and approve the device\n5. After the user confirms approval, call `clawlink_get_pairing_status`\n6. Tell the user to connect Facebook at [claw-link.dev/dashboard?add=facebook](https://claw-link.dev/dashboard?add=facebook)\n7. When the user confirms Facebook is connected, call `clawlink_list_integrations` and then `clawlink_list_tools` with the `facebook` integration slug\n\n## Setup details\n\n### Installing the plugin\n\nIf the ClawLink plugin is not installed yet, tell the user to run:\n\n```\nopenclaw plugins install clawhub:clawlink-plugin\n```\n\nIf the current chat started before the plugin was installed and ClawLink tools are still unavailable, tell the user to start a fresh chat so OpenClaw reloads the plugin tool catalog.\n\n### Pairing ClawLink\n\nIf ClawLink reports that the plugin is not configured, the plugin has not been paired with the user's ClawLink account yet.\n\n1. Call `clawlink_begin_pairing`.\n2. Tell the user to open the returned pairing URL in their browser.\n3. The user signs in to ClawLink if needed and approves the OpenClaw device.\n4. After the user confirms approval, call `clawlink_get_pairing_status` to finish local setup.\n\nThe resulting device credential is stored locally in OpenClaw's plugin config and is only sent to `claw-link.dev`. The user should not paste raw credentials into chat.\n\n### Connecting Facebook\n\nTell the user to open https://claw-link.dev/dashboard?add=facebook and connect Facebook there. The page opens the add-connection panel filtered to Facebook. ClawLink's hosted page runs the Facebook OAuth flow — the user clicks through the Facebook login and grant screen. When they confirm it is done, call `clawlink_list_integrations` to verify, then call `clawlink_list_tools` with integration `facebook`.\n\n## Using Facebook tools\n\nClawLink provides tools dynamically based on what the user has connected. You do not need to know tool names or schemas in advance.\n\n### Discovery\n\n1. Call `clawlink_list_integrations` to confirm Facebook is connected.\n2. Call `clawlink_list_tools` with integration `facebook`.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `facebook`.\n5. If no Facebook tools appear, direct the user to https://claw-link.dev/dashboard?add=facebook.\n\n### Execution\n\n1. Call `clawlink_describe_tool` before using an unfamiliar tool, before any write, or when the request is ambiguous.\n2. Use the returned schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups`.\n3. Prefer read, list, search, and get operations before writes.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first, then confirm with the user.\n5. Execute with `clawlink_call_tool`.\n6. If it fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## What you can do\n\nTypical Facebook Page tasks (actual availability depends on the user's connected account, permissions, scopes, and current ClawLink tool catalog):\n\n- List managed Facebook Pages\n- Get page details and insights\n- List and get page posts\n- Get post insights and reactions\n- List comments on posts\n- Create posts and photo posts\n- Comment on posts\n- Send messages from a page\n- Update or delete posts\n\n## Rules\n\n- Always use ClawLink tools for Facebook. Do not ask the user for separate Facebook credentials.\n- Do not claim a capability is missing without checking the live ClawLink catalog in the current turn.\n- Do not invent slash commands or ask the user to paste raw credentials.\n- Ask for confirmation before destructive, external-facing, or bulk write actions.\n- If Facebook is not connected, direct the user to https://claw-link.dev/dashboard?add=facebook.\n- Never echo or repeat the user's ClawLink credential.\n\n## Resources\n\n- ClawLink: https://claw-link.dev\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n- ClawLink Source: https://github.com/hith3sh/clawlink\n- Facebook Graph API: https://developers.facebook.com/docs/graph-api/\n\nFile v0.1.0:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"facebook-pages\",\n \"version\": \"0.1.0\",\n \"publishedAt\": 1777822317062\n}\n\nFile v0.1.0:skill-card.md\n\n## Description:
\nPost content, read engagement, manage comments and messages, and view insights on Facebook Pages -- powered by ClawLink.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[hith3sh](https://clawhub.ai/user/hith3sh)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and developers use this skill to manage Facebook Pages from an agent chat through ClawLink, including posting content, reading engagement, managing comments and messages, and viewing insights.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires OAuth-based access to Facebook Pages through ClawLink.
\nMitigation: Install only if you trust ClawLink with Facebook Page access, review the Facebook permission screen, and connect only the Pages you intend to manage.
\nRisk: Posts, messages, updates, deletions, or bulk actions can affect external Facebook Page content.
\nMitigation: Use ClawLink previews and explicit user confirmation before write, destructive, external-facing, or bulk actions.
\nRisk: Sensitive ClawLink credentials could be exposed if handled directly in chat.
\nMitigation: Use the hosted pairing flow and do not ask users to paste raw credentials into chat.
\n\n\n## Reference(s):
\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/facebook-pages)
\n- [ClawLink](https://claw-link.dev)
\n- [ClawLink OpenClaw Docs](https://docs.claw-link.dev/openclaw)
\n- [ClawLink Verification](https://claw-link.dev/verify)
\n- [Facebook Graph API](https://developers.facebook.com/docs/graph-api/)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with inline shell commands, URLs, and tool-use instructions]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Guides the agent to discover live ClawLink Facebook tools before use and to preview or confirm risky actions.]
\n\n## Skill Version(s):
\n0.1.0 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
","readmeExcerpt":"Skill: Facebook Owner: hith3sh Summary: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat. Tags: latest:1.0.7 Version history: v1.0.7 | 2026-10-03T19:40:43.316Z | user Security section now states that the public-data tools read other people'","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Facebook Graph │\n│ (User Chat) │ │ (OAuth) │ │ API │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Facebook │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Facebook │\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘"},{"language":"bash","snippet":"openclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart"},{"language":"bash","snippet":"# List integrations\nclawlink_list_integrations\n\n# List Facebook tools\nclawlink_list_tools --integration facebook\n\n# Search for a specific tool\nclawlink_search_tools --query \"post\" --integration facebook"},{"language":"bash","snippet":"clawlink_list_integrations"},{"language":"bash","snippet":"clawlink_list_tools --integration facebook"},{"language":"text","snippet":"┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List posts → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Describe tool → Preview changes → User approves │\n│ → Execute update │\n└─────────────────────────────────────────────────────────────┘"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: facebook-pages\ndescription: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat.\n---\n\n# Facebook\n\n\n\nAccess Facebook Pages via the Graph API with managed OAuth authentication. Post content, read engagement, manage comments and messages, and view insights from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=facebook-pages) for hosted connection flows and credentials so you do not need to configure Facebook API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Facebook |\n|:---:|:---:|:---:|\n|  |  | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Facebook |\n\n## No Account Needed: Public Facebook Data\n\nRead any public Facebook page, post, group or event, search Marketplace, and browse the Meta Ad Library, without connecting a Facebook account. These tools work as soon as the plugin is paired: there is nothing to connect, and each call is paid from ClawLink credit (most cost a fraction of a cent; new accounts get $0.50 free).\n\n| Tool | What it returns | Price |\n|------|-----------------|-------|\n| `facebookdata_page_profile` | Public Facebook page or profile by URL: name, category, likes, followers, about | $0.00282 |\n| `facebookdata_page_posts` | Recent public posts of a Facebook page by URL | $0.00282 |\n| `facebookdata_post_comments` | Comments on a public Facebook post by URL | $0.00282 |\n| `facebookdata_ad_library_search` | Search the Meta Ad Library for active ads by keyword | $0.00282 |\n| `facebookdata_marketplace_search` | Search Facebook Marketplace listings near a point | $0.00282 |\n| `facebookdata_events_search` | Search public Facebook events by keyword | $0.00282 |\n\nUse the connected-account tools above for the user's own Facebook; use these for anyone else's public content. More: [Ad Spy](https://clawhub.ai/hith3sh/skills/ad-spy), [Transcribe Any Video](https://clawhub.ai/hith3sh/skills/transcribe-any-video).\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Facebook Graph │\n│ (User Chat) │ │ (OAuth) │ │ API │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n "},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"facebook-pages\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1791056443316\n}"},{"path":"skill-card.md","content":"## Description:\n\nManage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hith3sh](https://clawhub.ai/user/hith3sh)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nPage managers and their agents use this skill to publish content, moderate comments, respond to messages, and review engagement insights. They can also read public Facebook data without connecting an account.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Connecting a Facebook account grants access to managed Pages according to approved permissions.\n\nMitigation: Review the requested permissions during the ClawLink and Facebook connection flow.\n\nRisk: Public-data lookups consume paid ClawLink credit even without a connected Facebook account.\n\nMitigation: Check whether a public-data lookup is needed before making a paid call.\n\nRisk: Publishing, messaging, updating, or deleting can affect public content or real users.\n\nMitigation: Preview the target and intended effect, then obtain explicit user confirmation before executing a write.\n\n## Reference(s):\n\n- [Facebook skill on ClawHub](https://clawhub.ai/hith3sh/skills/facebook-pages)\n- [Facebook Graph API documentation](https://developers.facebook.com/docs/graph-api/)\n- [ClawLink documentation](https://docs.claw-link.dev/openclaw)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Markdown with inline shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [None]\n\n## Skill Version(s):\n\n1.0.7 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat. Skill: Facebook Owner: hith3sh Summary: Manage Facebook Pages, posts, comments, messages, and insights via the Facebook Graph API. Use this skill when users want to post content, read engagement metrics, moderate comments, or automate Facebook Page workflows from chat. Tags: latest:1.0.7 Version history: v1.0.7 | 2026-10-03T19:40:43.316Z | user Security section now states that the public-data tools read other people'","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1131,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:50:01.234Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:50:01.234Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T22:29:39.942Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}