{"id":"b92cbe82-533b-410f-8d9b-a6bf5ef48828","entityType":"agent","slug":"clawhub-hith3sh-box-files","name":"Box","canonicalUrl":"https://www.xpersona.co/agent/clawhub-hith3sh-box-files","canonicalPath":"/agent/clawhub-hith3sh-box-files","generatedAt":"2026-10-10T01:13:01.522Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T12:35:05.604Z","emptyReason":null},"description":"Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse... Skill: Box Owner: hith3sh Summary: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse... Tags: latest:1.0.6 Version history: v1.0.6 | 2026-06-09T07:04:45.188Z | user Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source. v","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.6K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s173vws87a7ss71xf9rq53k5gd8568kv:box-files","sourceUrl":"https://clawhub.ai/hith3sh/box-files","homepage":"https://clawhub.ai/hith3sh/skills/box-files","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/hith3sh/box-files","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/hith3sh/skills/box-files","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":68,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:35:05.604Z","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-09T12:35:05.604Z","emptyReason":null},"stars":null,"forks":null,"downloads":2643,"packageName":null,"latestVersion":"1.0.6","tractionLabel":"2.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:35:05.604Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T12:35:05.604Z","lastCrawledAt":"2026-10-09T12:35:05.604Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T12:35:05.604Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.6","createdAt":"2026-06-09T07:04:45.188Z","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":5792},{"version":"1.0.5","createdAt":"2026-06-09T06:08:10.923Z","changelog":"box-files 1.0.5 - Updated SKILL.md graphics URL for the Box logo. - Removed skill-card.md from the repository.","fileCount":3,"zipByteSize":5720},{"version":"1.0.4","createdAt":"2026-06-09T04:44:48.306Z","changelog":"- Removed the skill-card.md file. - No functionality or documentation changes to the main skill.","fileCount":3,"zipByteSize":5596},{"version":"1.0.2","createdAt":"2026-06-08T16:44:56.120Z","changelog":"Version 1.0.2 of box-files - No file or documentation changes detected in this release. - Functionality, setup, and usage remain the same as the previous version.","fileCount":3,"zipByteSize":5715},{"version":"1.0.1","createdAt":"2026-06-08T16:26:15.372Z","changelog":"- Added Box logo image at the top of documentation for clearer branding. - Minor text formatting updates and rewording for improved clarity. - Removed the unused file: skill-card.md.","fileCount":3,"zipByteSize":5697},{"version":"0.1.1","createdAt":"2026-06-07T13:27:18.233Z","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":5656},{"version":"0.1.0","createdAt":"2026-05-06T14:21:57.728Z","changelog":"box-files 0.1.0 - Initial release enabling Box integration via ClawLink. - Browse, search, and manage Box files and folders directly from chat. - Guide users through plugin installation, ClawLink pairing, and connecting their Box account. - Dynamically accesses available Box tools based on user permissions and ClawLink connections. - Provides clear workflow and confirmation steps for safe file and collaboration management.","fileCount":3,"zipByteSize":3561}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s173vws87a7ss71xf9rq53k5gd8568kv:box-files","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-box-files/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-box-files/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-box-files/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-box-files/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-box-files/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-box-files/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-10T01:13:01.519Z"}},"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-box-files/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-box-files/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-box-files/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-box-files/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-09T12:35:05.604Z","emptyReason":null},"readme":"Skill: Box\n\nOwner: hith3sh\n\nSummary: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse...\n\nTags: latest:1.0.6\n\nVersion history:\n\nv1.0.6 | 2026-06-09T07:04:45.188Z | 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.5 | 2026-06-09T06:08:10.923Z | auto\n\nbox-files 1.0.5\n\n- Updated SKILL.md graphics URL for the Box logo.\n- Removed skill-card.md from the repository.\n\nv1.0.4 | 2026-06-09T04:44:48.306Z | auto\n\n- Removed the skill-card.md file.\n- No functionality or documentation changes to the main skill.\n\nv1.0.2 | 2026-06-08T16:44:56.120Z | auto\n\nVersion 1.0.2 of box-files\n\n- No file or documentation changes detected in this release.\n- Functionality, setup, and usage remain the same as the previous version.\n\nv1.0.1 | 2026-06-08T16:26:15.372Z | auto\n\n- Added Box logo image at the top of documentation for clearer branding.\n- Minor text formatting updates and rewording for improved clarity.\n- Removed the unused file: skill-card.md.\n\nv0.1.1 | 2026-06-07T13:27:18.233Z | 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-06T14:21:57.728Z | auto\n\nbox-files 0.1.0\n\n- Initial release enabling Box integration via ClawLink.\n- Browse, search, and manage Box files and folders directly from chat.\n- Guide users through plugin installation, ClawLink pairing, and connecting their Box account.\n- Dynamically accesses available Box tools based on user permissions and ClawLink connections.\n- Provides clear workflow and confirmation steps for safe file and collaboration management.\n\nArchive index:\n\nArchive v1.0.6: 3 files, 5792 bytes\n\nFiles: skill-card.md (2500b), SKILL.md (13480b), _meta.json (128b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: box-files\ndescription: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse enterprise content, manage file sharing, automate document workflows, or coordinate Box Sign signature requests.\n---\n\n# Box\n\n\n\nAccess Box via the Box API with managed OAuth authentication. Browse files, inspect metadata, manage sharing and collaboration, and coordinate file workflows from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=box-files) for hosted connection flows and credentials so you do not need to configure Box API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Box |\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 Box |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Box API │\n│ (User Chat) │ │ (OAuth) │ │ (Files) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Box │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Box │\n │ File │ │ Auth │ │ Web App │\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 Box again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Box tools\nclawlink_list_tools --integration box\n\n# Search for a specific tool\nclawlink_search_tools --query \"file\" --integration box\n```\n\n## Authentication\n\nAll Box tool calls are authenticated automatically by ClawLink using the user's connected Box account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Box 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=box and connect Box.\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 `box` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration box\n```\n\n**Response:** Returns the live tool catalog for Box.\n\n### Reconnect\n\nIf Box tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=box\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration box`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Box is connected.\n2. Call `clawlink_list_tools --integration box` 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 `box`.\n5. If no Box tools appear, direct the user to https://claw-link.dev/dashboard?add=box.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List files → Get metadata → 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### Files& Folders\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_folder` | List items in a folder | Read |\n| `box_get_file` | Get file metadata and details | Read |\n| `box_create_folder` | Create a new folder | Write |\n| `box_upload_file` | Upload a file to Box | Write |\n| `box_copy_file` | Copy a file to another folder | Write |\n| `box_move_file` | Move a file to another folder | Write |\n| `box_delete_file` | Permanently delete a file | Write |\n| `box_download_file` | Download a file from Box | Read |\n\n### Sharing & Collaborations\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_collaboration` | Add a collaborator to a file or folder | Write |\n| `box_delete_collaboration` | Remove a collaborator | Write |\n| `box_add_shared_link_to_file` | Add a shared link to a file | Write |\n| `box_add_shared_link_to_folder` | Add a shared link to a folder | Write |\n| `box_get_file_collaborators` | List collaborators on a file | Read |\n\n### Metadata& Templates\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_metadata_template` | Create a metadata template | Write |\n| `box_create_metadata_instance_on_file` | Apply metadata to a file | Write |\n| `box_create_metadata_instance_on_folder` | Apply metadata to a folder | Write |\n| `box_get_metadata_template` | Get metadata template details | Read |\n\n### Box Sign (Signature Requests)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_box_sign_request` | Create a signature request | Write |\n| `box_cancel_box_sign_request` | Cancel a pending signature request | Write |\n| `box_get_sign_request` | Get signature request status | Read |\n\n### Users& Groups\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_users` | List enterprise users | Read |\n| `box_create_user` | Create a new managed user | Write |\n| `box_create_group` | Create a new group | Write |\n| `box_add_user_to_group` | Add a user to a group | Write |\n\n### Retention & Legal Hold\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_retention_policy` | Create a retention policy | Write |\n| `box_assign_retention_policy` | Assign a retention policy | Write |\n| `box_create_legal_hold_policy` | Create a legal hold policy | Write |\n| `box_assign_legal_hold_policy` | Assign a legal hold policy | Write |\n\n### AI (Box AI Studio)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_ask_question` | Ask questions about Box files using AI | Read |\n| `box_create_ai_agent` | Create a custom AI agent | Write |\n\n## Code Examples\n\n### List folder items\n\n```bash\nclawlink_call_tool --tool \"box_list_folder\" \\\n --params '{\n \"folder_id\": \"0\",\n \"limit\": 20\n }'\n```\n\n### Get file metadata\n\n```bash\nclawlink_call_tool --tool \"box_get_file\" \\\n --params '{\n \"file_id\": \"123456789\"\n }'\n```\n\n### Create a folder\n\n```bash\nclawlink_call_tool --tool \"box_create_folder\" \\\n --params '{\n \"name\": \"New Project Folder\",\n \"parent_folder_id\": \"0\"\n }'\n```\n\n### Create a collaboration\n\n```bash\nclawlink_call_tool --tool \"box_create_collaboration\" \\\n --params '{\n \"item\": {\n \"type\": \"file\",\n \"id\": \"123456789\"\n },\n \"accessible_by\": {\n \"type\": \"user\",\n \"email\": \"collaborator@example.com\"\n },\n \"role\": \"viewer\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Box account's permissions and enterprise policies.\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 files, folders, users) are marked as high-impact and must be confirmed.\n- Collaboration changes affect external user access; confirm before adding or removing collaborators.\n- Legal hold and retention policy operations require appropriate admin permissions.\n\n## Notes\n\n- Folder ID \"0\" refers to the root (All Files) folder.\n- File IDs and folder IDs are distinct namespaces in Box.\n- Shared links can be configured with different access levels (open, company, collaborators).\n- Some enterprise features (classifications, legal hold, retention) require specific Box plans.\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 box`. |\n| Missing connection | Box is not connected. Direct the user to https://claw-link.dev/dashboard?add=box. |\n| `ItemNotFound` | File or folder does not exist. Check the ID. |\n| `Conflict` | A file or folder with that name already exists in the target location. |\n| `AccessDenied` | No permission to access this resource. Verify account permissions. |\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 `box`.\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- [Box Developer Documentation](https://developer.box.com/)\n- [Box API Reference](https://developer.box.com/reference/)\n- ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=box-files\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=box-files)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.6:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"box-files\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1780988685188\n}\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nManage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box 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\nEmployees, developers, and content administrators use this skill to browse Box content, manage file sharing and collaboration, automate document workflows, inspect metadata, and coordinate Box Sign requests from an agent chat.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill asks users to activate an unpinned third-party plugin that can perform high-impact Box account actions.\n\nMitigation: Review the ClawLink plugin and publisher trust before installing, and prefer a pinned or verified plugin release when available.\n\nRisk: Write actions can create, move, copy, delete, share, or change Box resources, including collaborations, users, groups, retention policies, legal holds, and signature requests.\n\nMitigation: Use tool description and preview steps before writes, require explicit user confirmation, and verify the target resource and intended effect before execution.\n\nRisk: Tool calls operate with the connected Box account's permissions and enterprise policies.\n\nMitigation: Connect only a minimum-permission Box account appropriate for the task and use extra review for administrative or compliance-sensitive operations.\n\n## Reference(s):\n\n- [Box Developer Documentation](https://developer.box.com/)\n- [Box API Reference](https://developer.box.com/reference/)\n- [ClawLink OpenClaw Documentation](https://docs.claw-link.dev/openclaw)\n- [ClawLink Verification](https://claw-link.dev/verify)\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/skills/box-files)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, API calls, guidance]\n\n**Output Format:** [Markdown guidance with shell command examples and JSON tool parameters]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Uses the live ClawLink Box tool catalog as the source of truth for available actions.]\n\n## Skill Version(s):\n\n1.0.6 (source: server release evidence)\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, 5720 bytes\n\nFiles: skill-card.md (2528b), SKILL.md (13294b), _meta.json (128b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: box-files\ndescription: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse enterprise content, manage file sharing, automate document workflows, or coordinate Box Sign signature requests.\n---\n\n# Box\n\n\n\nAccess Box via the Box API with managed OAuth authentication. Browse files, inspect metadata, manage sharing and collaboration, and coordinate file workflows from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Box API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Box |\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 Box |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Box API │\n│ (User Chat) │ │ (OAuth) │ │ (Files) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Box │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Box │\n │ File │ │ Auth │ │ Web App │\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 Box again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Box tools\nclawlink_list_tools --integration box\n\n# Search for a specific tool\nclawlink_search_tools --query \"file\" --integration box\n```\n\n## Authentication\n\nAll Box tool calls are authenticated automatically by ClawLink using the user's connected Box account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Box 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=box and connect Box.\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 `box` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration box\n```\n\n**Response:** Returns the live tool catalog for Box.\n\n### Reconnect\n\nIf Box tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=box\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration box`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Box is connected.\n2. Call `clawlink_list_tools --integration box` 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 `box`.\n5. If no Box tools appear, direct the user to https://claw-link.dev/dashboard?add=box.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List files → Get metadata → 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### Files& Folders\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_folder` | List items in a folder | Read |\n| `box_get_file` | Get file metadata and details | Read |\n| `box_create_folder` | Create a new folder | Write |\n| `box_upload_file` | Upload a file to Box | Write |\n| `box_copy_file` | Copy a file to another folder | Write |\n| `box_move_file` | Move a file to another folder | Write |\n| `box_delete_file` | Permanently delete a file | Write |\n| `box_download_file` | Download a file from Box | Read |\n\n### Sharing & Collaborations\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_collaboration` | Add a collaborator to a file or folder | Write |\n| `box_delete_collaboration` | Remove a collaborator | Write |\n| `box_add_shared_link_to_file` | Add a shared link to a file | Write |\n| `box_add_shared_link_to_folder` | Add a shared link to a folder | Write |\n| `box_get_file_collaborators` | List collaborators on a file | Read |\n\n### Metadata& Templates\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_metadata_template` | Create a metadata template | Write |\n| `box_create_metadata_instance_on_file` | Apply metadata to a file | Write |\n| `box_create_metadata_instance_on_folder` | Apply metadata to a folder | Write |\n| `box_get_metadata_template` | Get metadata template details | Read |\n\n### Box Sign (Signature Requests)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_box_sign_request` | Create a signature request | Write |\n| `box_cancel_box_sign_request` | Cancel a pending signature request | Write |\n| `box_get_sign_request` | Get signature request status | Read |\n\n### Users& Groups\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_users` | List enterprise users | Read |\n| `box_create_user` | Create a new managed user | Write |\n| `box_create_group` | Create a new group | Write |\n| `box_add_user_to_group` | Add a user to a group | Write |\n\n### Retention & Legal Hold\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_retention_policy` | Create a retention policy | Write |\n| `box_assign_retention_policy` | Assign a retention policy | Write |\n| `box_create_legal_hold_policy` | Create a legal hold policy | Write |\n| `box_assign_legal_hold_policy` | Assign a legal hold policy | Write |\n\n### AI (Box AI Studio)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_ask_question` | Ask questions about Box files using AI | Read |\n| `box_create_ai_agent` | Create a custom AI agent | Write |\n\n## Code Examples\n\n### List folder items\n\n```bash\nclawlink_call_tool --tool \"box_list_folder\" \\\n --params '{\n \"folder_id\": \"0\",\n \"limit\": 20\n }'\n```\n\n### Get file metadata\n\n```bash\nclawlink_call_tool --tool \"box_get_file\" \\\n --params '{\n \"file_id\": \"123456789\"\n }'\n```\n\n### Create a folder\n\n```bash\nclawlink_call_tool --tool \"box_create_folder\" \\\n --params '{\n \"name\": \"New Project Folder\",\n \"parent_folder_id\": \"0\"\n }'\n```\n\n### Create a collaboration\n\n```bash\nclawlink_call_tool --tool \"box_create_collaboration\" \\\n --params '{\n \"item\": {\n \"type\": \"file\",\n \"id\": \"123456789\"\n },\n \"accessible_by\": {\n \"type\": \"user\",\n \"email\": \"collaborator@example.com\"\n },\n \"role\": \"viewer\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Box account's permissions and enterprise policies.\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 files, folders, users) are marked as high-impact and must be confirmed.\n- Collaboration changes affect external user access; confirm before adding or removing collaborators.\n- Legal hold and retention policy operations require appropriate admin permissions.\n\n## Notes\n\n- Folder ID \"0\" refers to the root (All Files) folder.\n- File IDs and folder IDs are distinct namespaces in Box.\n- Shared links can be configured with different access levels (open, company, collaborators).\n- Some enterprise features (classifications, legal hold, retention) require specific Box plans.\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 box`. |\n| Missing connection | Box is not connected. Direct the user to https://claw-link.dev/dashboard?add=box. |\n| `ItemNotFound` | File or folder does not exist. Check the ID. |\n| `Conflict` | A file or folder with that name already exists in the target location. |\n| `AccessDenied` | No permission to access this resource. Verify account permissions. |\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 `box`.\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- [Box Developer Documentation](https://developer.box.com/)\n- [Box API Reference](https://developer.box.com/reference/)\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.5:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"box-files\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1780985290923\n}\n\nFile v1.0.5:skill-card.md\n\n## Description:
\nManage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box 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:
\nEmployees, developers, and workspace administrators use this skill to browse Box content, inspect metadata, manage sharing and collaboration, and coordinate Box Sign workflows from an agent chat.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires OAuth-based access to a connected Box account and can act within that account's permissions.
\nMitigation: Use the connected account's Box permissions and enterprise policies as the access boundary, and verify the Box connection before use.
\nRisk: Write operations can create, move, delete, share, or otherwise change Box resources.
\nMitigation: Preview and confirm the target resource and intended effect before executing create, update, delete, collaboration, retention, legal hold, or signature-request actions.
\nRisk: The release has no server-resolved GitHub provenance for this version.
\nMitigation: Treat provenance as unavailable and rely on ClawHub release evidence, security summary, and publisher profile when reviewing the artifact.
\n\n\n## Reference(s):
\n- [ClawHub Box skill page](https://clawhub.ai/hith3sh/box-files)
\n- [Box Developer Documentation](https://developer.box.com/)
\n- [Box API Reference](https://developer.box.com/reference/)
\n- [ClawLink OpenClaw documentation](https://docs.claw-link.dev/openclaw)
\n- [ClawLink verification](https://claw-link.dev/verify)
\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 tool-call guidance]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses the live ClawLink Box tool catalog as the source of truth and asks for confirmation before write operations.]
\n\n## Skill Version(s):
\n1.0.5 (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 v1.0.4: 3 files, 5596 bytes\n\nFiles: skill-card.md (2288b), SKILL.md (13290b), _meta.json (128b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: box-files\ndescription: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse enterprise content, manage file sharing, automate document workflows, or coordinate Box Sign signature requests.\n---\n\n# Box\n\n\n\nAccess Box via the Box API with managed OAuth authentication. Browse files, inspect metadata, manage sharing and collaboration, and coordinate file workflows from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Box API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Box |\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 Box |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Box API │\n│ (User Chat) │ │ (OAuth) │ │ (Files) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Box │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Box │\n │ File │ │ Auth │ │ Web App │\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 Box again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Box tools\nclawlink_list_tools --integration box\n\n# Search for a specific tool\nclawlink_search_tools --query \"file\" --integration box\n```\n\n## Authentication\n\nAll Box tool calls are authenticated automatically by ClawLink using the user's connected Box account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Box 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=box and connect Box.\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 `box` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration box\n```\n\n**Response:** Returns the live tool catalog for Box.\n\n### Reconnect\n\nIf Box tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=box\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration box`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Box is connected.\n2. Call `clawlink_list_tools --integration box` 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 `box`.\n5. If no Box tools appear, direct the user to https://claw-link.dev/dashboard?add=box.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List files → Get metadata → 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### Files& Folders\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_folder` | List items in a folder | Read |\n| `box_get_file` | Get file metadata and details | Read |\n| `box_create_folder` | Create a new folder | Write |\n| `box_upload_file` | Upload a file to Box | Write |\n| `box_copy_file` | Copy a file to another folder | Write |\n| `box_move_file` | Move a file to another folder | Write |\n| `box_delete_file` | Permanently delete a file | Write |\n| `box_download_file` | Download a file from Box | Read |\n\n### Sharing & Collaborations\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_collaboration` | Add a collaborator to a file or folder | Write |\n| `box_delete_collaboration` | Remove a collaborator | Write |\n| `box_add_shared_link_to_file` | Add a shared link to a file | Write |\n| `box_add_shared_link_to_folder` | Add a shared link to a folder | Write |\n| `box_get_file_collaborators` | List collaborators on a file | Read |\n\n### Metadata& Templates\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_metadata_template` | Create a metadata template | Write |\n| `box_create_metadata_instance_on_file` | Apply metadata to a file | Write |\n| `box_create_metadata_instance_on_folder` | Apply metadata to a folder | Write |\n| `box_get_metadata_template` | Get metadata template details | Read |\n\n### Box Sign (Signature Requests)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_box_sign_request` | Create a signature request | Write |\n| `box_cancel_box_sign_request` | Cancel a pending signature request | Write |\n| `box_get_sign_request` | Get signature request status | Read |\n\n### Users& Groups\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_users` | List enterprise users | Read |\n| `box_create_user` | Create a new managed user | Write |\n| `box_create_group` | Create a new group | Write |\n| `box_add_user_to_group` | Add a user to a group | Write |\n\n### Retention & Legal Hold\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_retention_policy` | Create a retention policy | Write |\n| `box_assign_retention_policy` | Assign a retention policy | Write |\n| `box_create_legal_hold_policy` | Create a legal hold policy | Write |\n| `box_assign_legal_hold_policy` | Assign a legal hold policy | Write |\n\n### AI (Box AI Studio)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_ask_question` | Ask questions about Box files using AI | Read |\n| `box_create_ai_agent` | Create a custom AI agent | Write |\n\n## Code Examples\n\n### List folder items\n\n```bash\nclawlink_call_tool --tool \"box_list_folder\" \\\n --params '{\n \"folder_id\": \"0\",\n \"limit\": 20\n }'\n```\n\n### Get file metadata\n\n```bash\nclawlink_call_tool --tool \"box_get_file\" \\\n --params '{\n \"file_id\": \"123456789\"\n }'\n```\n\n### Create a folder\n\n```bash\nclawlink_call_tool --tool \"box_create_folder\" \\\n --params '{\n \"name\": \"New Project Folder\",\n \"parent_folder_id\": \"0\"\n }'\n```\n\n### Create a collaboration\n\n```bash\nclawlink_call_tool --tool \"box_create_collaboration\" \\\n --params '{\n \"item\": {\n \"type\": \"file\",\n \"id\": \"123456789\"\n },\n \"accessible_by\": {\n \"type\": \"user\",\n \"email\": \"collaborator@example.com\"\n },\n \"role\": \"viewer\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Box account's permissions and enterprise policies.\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 files, folders, users) are marked as high-impact and must be confirmed.\n- Collaboration changes affect external user access; confirm before adding or removing collaborators.\n- Legal hold and retention policy operations require appropriate admin permissions.\n\n## Notes\n\n- Folder ID \"0\" refers to the root (All Files) folder.\n- File IDs and folder IDs are distinct namespaces in Box.\n- Shared links can be configured with different access levels (open, company, collaborators).\n- Some enterprise features (classifications, legal hold, retention) require specific Box plans.\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 box`. |\n| Missing connection | Box is not connected. Direct the user to https://claw-link.dev/dashboard?add=box. |\n| `ItemNotFound` | File or folder does not exist. Check the ID. |\n| `Conflict` | A file or folder with that name already exists in the target location. |\n| `AccessDenied` | No permission to access this resource. Verify account permissions. |\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 `box`.\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- [Box Developer Documentation](https://developer.box.com/)\n- [Box API Reference](https://developer.box.com/reference/)\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\": \"box-files\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1780980288306\n}\n\nFile v1.0.4:skill-card.md\n\n## Description:
\nManage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box 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:
\nEmployees, administrators, and developers use this skill to browse Box content, manage sharing and collaborations, coordinate document workflows, and request signatures through a connected Box account.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill can act on Box content using the connected account's permissions, including sharing, collaboration, retention, legal hold, and destructive file operations.
\nMitigation: Use the least-privileged Box account appropriate for the task, review visible instructions before use, and require explicit confirmation before write or destructive actions.
\nRisk: The skill requires OAuth-backed access and sensitive credentials managed through ClawLink.
\nMitigation: Only connect accounts needed for the task and revoke or rotate access through the connection provider when access is no longer required.
\n\n\n## Reference(s):
\n- [Box Developer Documentation](https://developer.box.com/)
\n- [Box API Reference](https://developer.box.com/reference/)
\n- [ClawLink OpenClaw Documentation](https://docs.claw-link.dev/openclaw)
\n- [ClawLink Verification](https://claw-link.dev/verify)
\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:** [Requires a connected Box account through ClawLink; write actions are previewed and require explicit user confirmation.]
\n\n## Skill Version(s):
\n1.0.4 (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 v1.0.2: 3 files, 5715 bytes\n\nFiles: skill-card.md (2536b), SKILL.md (13290b), _meta.json (128b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: box-files\ndescription: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse enterprise content, manage file sharing, automate document workflows, or coordinate Box Sign signature requests.\n---\n\n# Box\n\n\n\nAccess Box via the Box API with managed OAuth authentication. Browse files, inspect metadata, manage sharing and collaboration, and coordinate file workflows from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Box API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Box |\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 Box |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Box API │\n│ (User Chat) │ │ (OAuth) │ │ (Files) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Box │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Box │\n │ File │ │ Auth │ │ Web App │\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 Box again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Box tools\nclawlink_list_tools --integration box\n\n# Search for a specific tool\nclawlink_search_tools --query \"file\" --integration box\n```\n\n## Authentication\n\nAll Box tool calls are authenticated automatically by ClawLink using the user's connected Box account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Box 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=box and connect Box.\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 `box` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration box\n```\n\n**Response:** Returns the live tool catalog for Box.\n\n### Reconnect\n\nIf Box tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=box\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration box`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Box is connected.\n2. Call `clawlink_list_tools --integration box` 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 `box`.\n5. If no Box tools appear, direct the user to https://claw-link.dev/dashboard?add=box.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List files → Get metadata → 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### Files& Folders\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_folder` | List items in a folder | Read |\n| `box_get_file` | Get file metadata and details | Read |\n| `box_create_folder` | Create a new folder | Write |\n| `box_upload_file` | Upload a file to Box | Write |\n| `box_copy_file` | Copy a file to another folder | Write |\n| `box_move_file` | Move a file to another folder | Write |\n| `box_delete_file` | Permanently delete a file | Write |\n| `box_download_file` | Download a file from Box | Read |\n\n### Sharing & Collaborations\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_collaboration` | Add a collaborator to a file or folder | Write |\n| `box_delete_collaboration` | Remove a collaborator | Write |\n| `box_add_shared_link_to_file` | Add a shared link to a file | Write |\n| `box_add_shared_link_to_folder` | Add a shared link to a folder | Write |\n| `box_get_file_collaborators` | List collaborators on a file | Read |\n\n### Metadata& Templates\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_metadata_template` | Create a metadata template | Write |\n| `box_create_metadata_instance_on_file` | Apply metadata to a file | Write |\n| `box_create_metadata_instance_on_folder` | Apply metadata to a folder | Write |\n| `box_get_metadata_template` | Get metadata template details | Read |\n\n### Box Sign (Signature Requests)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_box_sign_request` | Create a signature request | Write |\n| `box_cancel_box_sign_request` | Cancel a pending signature request | Write |\n| `box_get_sign_request` | Get signature request status | Read |\n\n### Users& Groups\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_users` | List enterprise users | Read |\n| `box_create_user` | Create a new managed user | Write |\n| `box_create_group` | Create a new group | Write |\n| `box_add_user_to_group` | Add a user to a group | Write |\n\n### Retention & Legal Hold\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_retention_policy` | Create a retention policy | Write |\n| `box_assign_retention_policy` | Assign a retention policy | Write |\n| `box_create_legal_hold_policy` | Create a legal hold policy | Write |\n| `box_assign_legal_hold_policy` | Assign a legal hold policy | Write |\n\n### AI (Box AI Studio)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_ask_question` | Ask questions about Box files using AI | Read |\n| `box_create_ai_agent` | Create a custom AI agent | Write |\n\n## Code Examples\n\n### List folder items\n\n```bash\nclawlink_call_tool --tool \"box_list_folder\" \\\n --params '{\n \"folder_id\": \"0\",\n \"limit\": 20\n }'\n```\n\n### Get file metadata\n\n```bash\nclawlink_call_tool --tool \"box_get_file\" \\\n --params '{\n \"file_id\": \"123456789\"\n }'\n```\n\n### Create a folder\n\n```bash\nclawlink_call_tool --tool \"box_create_folder\" \\\n --params '{\n \"name\": \"New Project Folder\",\n \"parent_folder_id\": \"0\"\n }'\n```\n\n### Create a collaboration\n\n```bash\nclawlink_call_tool --tool \"box_create_collaboration\" \\\n --params '{\n \"item\": {\n \"type\": \"file\",\n \"id\": \"123456789\"\n },\n \"accessible_by\": {\n \"type\": \"user\",\n \"email\": \"collaborator@example.com\"\n },\n \"role\": \"viewer\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Box account's permissions and enterprise policies.\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 files, folders, users) are marked as high-impact and must be confirmed.\n- Collaboration changes affect external user access; confirm before adding or removing collaborators.\n- Legal hold and retention policy operations require appropriate admin permissions.\n\n## Notes\n\n- Folder ID \"0\" refers to the root (All Files) folder.\n- File IDs and folder IDs are distinct namespaces in Box.\n- Shared links can be configured with different access levels (open, company, collaborators).\n- Some enterprise features (classifications, legal hold, retention) require specific Box plans.\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 box`. |\n| Missing connection | Box is not connected. Direct the user to https://claw-link.dev/dashboard?add=box. |\n| `ItemNotFound` | File or folder does not exist. Check the ID. |\n| `Conflict` | A file or folder with that name already exists in the target location. |\n| `AccessDenied` | No permission to access this resource. Verify account permissions. |\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 `box`.\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- [Box Developer Documentation](https://developer.box.com/)\n- [Box API Reference](https://developer.box.com/reference/)\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.2:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"box-files\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1780937096120\n}\n\nFile v1.0.2:skill-card.md\n\n## Description:
\nManage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box 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:
\nEmployees, external collaborators, and developers use this skill to browse Box content, inspect metadata, manage sharing and collaboration, automate document workflows, and coordinate Box Sign requests from an agent chat.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Box OAuth access can expose or modify enterprise content according to the connected account's permissions.
\nMitigation: Install only when the user trusts ClawLink to broker the Box OAuth connection and understands the connected account's Box permissions.
\nRisk: Write actions can delete files, change shared links or collaborators, manage users or groups, apply retention or legal hold policies, or create signature requests.
\nMitigation: Use read, list, search, and describe steps first; review the preview and confirm the target resource and intended effect before any write action.
\nRisk: Documented examples may not match the live Box tool catalog available to the user.
\nMitigation: Treat the live ClawLink catalog as the source of truth by listing, searching, or describing Box tools before calling them.
\n\n\n## Reference(s):
\n- [ClawHub Box Skill](https://clawhub.ai/hith3sh/box-files)
\n- [Box Developer Documentation](https://developer.box.com/)
\n- [Box API Reference](https://developer.box.com/reference/)
\n- [ClawLink OpenClaw Documentation](https://docs.claw-link.dev/openclaw)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration instructions, Guidance]
\n**Output Format:** [Markdown with inline bash code blocks and JSON parameter examples]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses the connected Box account's permissions; write actions are previewed and require user confirmation.]
\n\n## Skill Version(s):
\n1.0.2 (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.1: 3 files, 5697 bytes\n\nFiles: skill-card.md (2509b), SKILL.md (13290b), _meta.json (128b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: box-files\ndescription: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse enterprise content, manage file sharing, automate document workflows, or coordinate Box Sign signature requests.\n---\n\n# Box\n\n\n\nAccess Box via the Box API with managed OAuth authentication. Browse files, inspect metadata, manage sharing and collaboration, and coordinate file workflows from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Box API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Box |\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 Box |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Box API │\n│ (User Chat) │ │ (OAuth) │ │ (Files) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Box │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Box │\n │ File │ │ Auth │ │ Web App │\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 Box again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Box tools\nclawlink_list_tools --integration box\n\n# Search for a specific tool\nclawlink_search_tools --query \"file\" --integration box\n```\n\n## Authentication\n\nAll Box tool calls are authenticated automatically by ClawLink using the user's connected Box account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Box 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=box and connect Box.\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 `box` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration box\n```\n\n**Response:** Returns the live tool catalog for Box.\n\n### Reconnect\n\nIf Box tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=box\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration box`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Box is connected.\n2. Call `clawlink_list_tools --integration box` 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 `box`.\n5. If no Box tools appear, direct the user to https://claw-link.dev/dashboard?add=box.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List files → Get metadata → 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### Files& Folders\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_folder` | List items in a folder | Read |\n| `box_get_file` | Get file metadata and details | Read |\n| `box_create_folder` | Create a new folder | Write |\n| `box_upload_file` | Upload a file to Box | Write |\n| `box_copy_file` | Copy a file to another folder | Write |\n| `box_move_file` | Move a file to another folder | Write |\n| `box_delete_file` | Permanently delete a file | Write |\n| `box_download_file` | Download a file from Box | Read |\n\n### Sharing & Collaborations\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_collaboration` | Add a collaborator to a file or folder | Write |\n| `box_delete_collaboration` | Remove a collaborator | Write |\n| `box_add_shared_link_to_file` | Add a shared link to a file | Write |\n| `box_add_shared_link_to_folder` | Add a shared link to a folder | Write |\n| `box_get_file_collaborators` | List collaborators on a file | Read |\n\n### Metadata& Templates\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_metadata_template` | Create a metadata template | Write |\n| `box_create_metadata_instance_on_file` | Apply metadata to a file | Write |\n| `box_create_metadata_instance_on_folder` | Apply metadata to a folder | Write |\n| `box_get_metadata_template` | Get metadata template details | Read |\n\n### Box Sign (Signature Requests)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_box_sign_request` | Create a signature request | Write |\n| `box_cancel_box_sign_request` | Cancel a pending signature request | Write |\n| `box_get_sign_request` | Get signature request status | Read |\n\n### Users& Groups\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_users` | List enterprise users | Read |\n| `box_create_user` | Create a new managed user | Write |\n| `box_create_group` | Create a new group | Write |\n| `box_add_user_to_group` | Add a user to a group | Write |\n\n### Retention & Legal Hold\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_retention_policy` | Create a retention policy | Write |\n| `box_assign_retention_policy` | Assign a retention policy | Write |\n| `box_create_legal_hold_policy` | Create a legal hold policy | Write |\n| `box_assign_legal_hold_policy` | Assign a legal hold policy | Write |\n\n### AI (Box AI Studio)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_ask_question` | Ask questions about Box files using AI | Read |\n| `box_create_ai_agent` | Create a custom AI agent | Write |\n\n## Code Examples\n\n### List folder items\n\n```bash\nclawlink_call_tool --tool \"box_list_folder\" \\\n --params '{\n \"folder_id\": \"0\",\n \"limit\": 20\n }'\n```\n\n### Get file metadata\n\n```bash\nclawlink_call_tool --tool \"box_get_file\" \\\n --params '{\n \"file_id\": \"123456789\"\n }'\n```\n\n### Create a folder\n\n```bash\nclawlink_call_tool --tool \"box_create_folder\" \\\n --params '{\n \"name\": \"New Project Folder\",\n \"parent_folder_id\": \"0\"\n }'\n```\n\n### Create a collaboration\n\n```bash\nclawlink_call_tool --tool \"box_create_collaboration\" \\\n --params '{\n \"item\": {\n \"type\": \"file\",\n \"id\": \"123456789\"\n },\n \"accessible_by\": {\n \"type\": \"user\",\n \"email\": \"collaborator@example.com\"\n },\n \"role\": \"viewer\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Box account's permissions and enterprise policies.\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 files, folders, users) are marked as high-impact and must be confirmed.\n- Collaboration changes affect external user access; confirm before adding or removing collaborators.\n- Legal hold and retention policy operations require appropriate admin permissions.\n\n## Notes\n\n- Folder ID \"0\" refers to the root (All Files) folder.\n- File IDs and folder IDs are distinct namespaces in Box.\n- Shared links can be configured with different access levels (open, company, collaborators).\n- Some enterprise features (classifications, legal hold, retention) require specific Box plans.\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 box`. |\n| Missing connection | Box is not connected. Direct the user to https://claw-link.dev/dashboard?add=box. |\n| `ItemNotFound` | File or folder does not exist. Check the ID. |\n| `Conflict` | A file or folder with that name already exists in the target location. |\n| `AccessDenied` | No permission to access this resource. Verify account permissions. |\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 `box`.\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- [Box Developer Documentation](https://developer.box.com/)\n- [Box API Reference](https://developer.box.com/reference/)\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\": \"box-files\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1780935975372\n}\n\nFile v1.0.1:skill-card.md\n\n## Description:
\nManage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box 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:
\nEmployees, operators, and developers use this skill to browse enterprise Box content, inspect metadata, manage sharing and collaboration, automate document workflows, and coordinate Box Sign requests from an agent chat.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The connected account determines what content and administrative actions the agent can access.
\nMitigation: Confirm the exact account or workspace being connected before use and verify the active Box connection before making requests.
\nRisk: Create, update, delete, sharing, collaboration, retention, legal hold, and signature-request actions can change enterprise content or access.
\nMitigation: Use tool description and preview steps for unfamiliar or write actions, then require explicit user confirmation before execution.
\nRisk: Shared links and collaboration changes may expose files or folders to unintended recipients.
\nMitigation: Confirm the target item, recipient, role, and shared-link access level before creating or changing access.
\n\n\n## Reference(s):
\n- [ClawHub Box Skill Page](https://clawhub.ai/hith3sh/box-files)
\n- [Box Developer Documentation](https://developer.box.com/)
\n- [Box API Reference](https://developer.box.com/reference/)
\n- [ClawLink Documentation](https://docs.claw-link.dev/openclaw)
\n- [ClawLink Verification](https://claw-link.dev/verify)
\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 guidance]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Outputs are scoped to the live ClawLink Box tool catalog and the user's connected Box account permissions.]
\n\n## Skill Version(s):
\n1.0.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.1: 3 files, 5656 bytes\n\nFiles: skill-card.md (2398b), SKILL.md (13187b), _meta.json (128b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: box-files\ndescription: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse enterprise content, manage file sharing, automate document workflows, or coordinate Box Sign signature requests.\n---\n\n# Box\n\nAccess Box via the Box API with managed OAuth authentication. Browse files, inspect metadata, manage sharing and collaboration, and coordinate file workflows from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Box API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Box |\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 Box |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Box API │\n│ (User Chat) │ │ (OAuth) │ │ (Files) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Box │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Box │\n │ File │ │ Auth │ │ Web App │\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 Box again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Box tools\nclawlink_list_tools --integration box\n\n# Search for a specific tool\nclawlink_search_tools --query \"file\" --integration box\n```\n\n## Authentication\n\nAll Box tool calls are authenticated automatically by ClawLink using the user's connected Box account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Box 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=box and connect Box.\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 `box` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration box\n```\n\n**Response:** Returns the live tool catalog for Box.\n\n### Reconnect\n\nIf Box tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=box\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration box`\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Box is connected.\n2. Call `clawlink_list_tools --integration box` 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 `box`.\n5. If no Box tools appear, direct the user to https://claw-link.dev/dashboard?add=box.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List files → Get metadata → 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### Files& Folders\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_folder` | List items in a folder | Read |\n| `box_get_file` | Get file metadata and details | Read |\n| `box_create_folder` | Create a new folder | Write |\n| `box_upload_file` | Upload a file to Box | Write |\n| `box_copy_file` | Copy a file to another folder | Write |\n| `box_move_file` | Move a file to another folder | Write |\n| `box_delete_file` | Permanently delete a file | Write |\n| `box_download_file` | Download a file from Box | Read |\n\n### Sharing & Collaborations\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_collaboration` | Add a collaborator to a file or folder | Write |\n| `box_delete_collaboration` | Remove a collaborator | Write |\n| `box_add_shared_link_to_file` | Add a shared link to a file | Write |\n| `box_add_shared_link_to_folder` | Add a shared link to a folder | Write |\n| `box_get_file_collaborators` | List collaborators on a file | Read |\n\n### Metadata& Templates\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_metadata_template` | Create a metadata template | Write |\n| `box_create_metadata_instance_on_file` | Apply metadata to a file | Write |\n| `box_create_metadata_instance_on_folder` | Apply metadata to a folder | Write |\n| `box_get_metadata_template` | Get metadata template details | Read |\n\n### Box Sign (Signature Requests)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_box_sign_request` | Create a signature request | Write |\n| `box_cancel_box_sign_request` | Cancel a pending signature request | Write |\n| `box_get_sign_request` | Get signature request status | Read |\n\n### Users& Groups\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_list_users` | List enterprise users | Read |\n| `box_create_user` | Create a new managed user | Write |\n| `box_create_group` | Create a new group | Write |\n| `box_add_user_to_group` | Add a user to a group | Write |\n\n### Retention & Legal Hold\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_create_retention_policy` | Create a retention policy | Write |\n| `box_assign_retention_policy` | Assign a retention policy | Write |\n| `box_create_legal_hold_policy` | Create a legal hold policy | Write |\n| `box_assign_legal_hold_policy` | Assign a legal hold policy | Write |\n\n### AI (Box AI Studio)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `box_ask_question` | Ask questions about Box files using AI | Read |\n| `box_create_ai_agent` | Create a custom AI agent | Write |\n\n## Code Examples\n\n### List folder items\n\n```bash\nclawlink_call_tool --tool \"box_list_folder\" \\\n --params '{\n \"folder_id\": \"0\",\n \"limit\": 20\n }'\n```\n\n### Get file metadata\n\n```bash\nclawlink_call_tool --tool \"box_get_file\" \\\n --params '{\n \"file_id\": \"123456789\"\n }'\n```\n\n### Create a folder\n\n```bash\nclawlink_call_tool --tool \"box_create_folder\" \\\n --params '{\n \"name\": \"New Project Folder\",\n \"parent_folder_id\": \"0\"\n }'\n```\n\n### Create a collaboration\n\n```bash\nclawlink_call_tool --tool \"box_create_collaboration\" \\\n --params '{\n \"item\": {\n \"type\": \"file\",\n \"id\": \"123456789\"\n },\n \"accessible_by\": {\n \"type\": \"user\",\n \"email\": \"collaborator@example.com\"\n },\n \"role\": \"viewer\"\n }'\n```\n\n## Security & Permissions\n\n- Access is scoped to the connected Box account's permissions and enterprise policies.\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 files, folders, users) are marked as high-impact and must be confirmed.\n- Collaboration changes affect external user access; confirm before adding or removing collaborators.\n- Legal hold and retention policy operations require appropriate admin permissions.\n\n## Notes\n\n- Folder ID \"0\" refers to the root (All Files) folder.\n- File IDs and folder IDs are distinct namespaces in Box.\n- Shared links can be configured with different access levels (open, company, collaborators).\n- Some enterprise features (classifications, legal hold, retention) require specific Box plans.\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 box`. |\n| Missing connection | Box is not connected. Direct the user to https://claw-link.dev/dashboard?add=box. |\n| `ItemNotFound` | File or folder does not exist. Check the ID. |\n| `Conflict` | A file or folder with that name already exists in the target location. |\n| `AccessDenied` | No permission to access this resource. Verify account permissions. |\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 `box`.\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- [Box Developer Documentation](https://developer.box.com/)\n- [Box API Reference](https://developer.box.com/reference/)\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\": \"box-files\",\n \"version\": \"0.1.1\",\n \"publishedAt\": 1780838838233\n}\n\nFile v0.1.1:skill-card.md\n\n## Description:
\nManage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box 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:
\nDevelopers and employees use this skill to access Box from OpenClaw through ClawLink. It supports browsing enterprise content, managing file sharing and collaborations, automating metadata and document workflows, and coordinating Box Sign requests.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill brokers access to a connected Box account through ClawLink OAuth, so inappropriate permissions or account choice could expose sensitive enterprise content.
\nMitigation: Review Box OAuth permissions during connection, use an account with the least privileges needed, and follow enterprise Box policies.
\nRisk: Write actions such as sharing changes, deletions, user or group changes, retention policies, legal holds, and signature requests can have high-impact effects.
\nMitigation: Use tool descriptions and previews before writes, then execute only after the user clearly confirms the target resource and intended effect.
\n\n\n## Reference(s):
\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/box-files)
\n- [Box Developer Documentation](https://developer.box.com/)
\n- [Box API Reference](https://developer.box.com/reference/)
\n- [ClawLink](https://claw-link.dev)
\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw)
\n\n\n## Skill Output:
\n**Output Type(s):** [Guidance, Shell commands, Configuration, API Calls, Markdown]
\n**Output Format:** [Markdown with inline shell commands and JSON tool-call examples]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses live ClawLink tool discovery before Box tool calls; write operations require preview and user confirmation.]
\n\n## Skill Version(s):
\n0.1.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.0: 3 files, 3561 bytes\n\nFiles: skill-card.md (2536b), SKILL.md (4982b), _meta.json (128b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: box-files\ndescription: Browse files and folders, manage sharing and collaboration, inspect enterprise content, and coordinate file workflows — powered by ClawLink.\n---\n\n# Box via ClawLink\n\nWork with Box from chat — browse files, inspect metadata, manage sharing and collaboration, and coordinate file workflows.\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 Box 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 Box at [claw-link.dev/dashboard?add=box](https://claw-link.dev/dashboard?add=box)\n7. When the user confirms Box is connected, call `clawlink_list_integrations` and then `clawlink_list_tools` with the `box` 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 Box\n\nTell the user to open https://claw-link.dev/dashboard?add=box and connect Box there. The page opens the add-connection panel filtered to Box. ClawLink's hosted page runs the hosted OAuth flow — the user clicks through the Box login and authorization screen. When they confirm it is done, call `clawlink_list_integrations` to verify, then call `clawlink_list_tools` with integration `box`.\n\n## Using Box 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 Box is connected.\n2. Call `clawlink_list_tools` with integration `box`.\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 `box`.\n5. If no Box tools appear, direct the user to https://claw-link.dev/dashboard?add=box.\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 Box tasks (actual availability depends on the user's connected account, permissions, scopes, and current ClawLink tool catalog):\n\n- Browse files, folders, and metadata\n- Search enterprise content\n- Review sharing, collaboration, and access details\n- Manage files and folders after confirmation\n- Coordinate collaboration changes after confirmation\n- Inspect enterprise content state before write actions\n\n## Rules\n\n- Always use ClawLink tools for Box. Do not ask the user for separate Box 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 Box is not connected, direct the user to https://claw-link.dev/dashboard?add=box.\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- Box API: https://developer.box.com/\n\nFile v0.1.0:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"box-files\",\n \"version\": \"0.1.0\",\n \"publishedAt\": 1778077317728\n}\n\nFile v0.1.0:skill-card.md\n\n## Description:
\nBrowse files and folders, manage sharing and collaboration, inspect enterprise content, and coordinate file workflows 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:
\nOpenClaw users use this skill to connect Box through ClawLink, discover the live Box tool catalog, browse and search content, inspect metadata and access state, and coordinate file or collaboration changes with confirmation.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill can access and manage Box files through ClawLink, so OAuth scopes and connected account permissions may expose sensitive enterprise content.
\nMitigation: Review the Box OAuth consent scopes and install only if the user trusts ClawLink and the referenced plugin to broker Box access.
\nRisk: File, folder, collaborator, sharing, destructive, or bulk changes can affect external content and collaborators.
\nMitigation: Use previews and explicit user confirmation before write, destructive, sharing, collaborator, or bulk actions.
\nRisk: Credentials or pairing tokens could be exposed if copied into chat or repeated in responses.
\nMitigation: Do not ask for or echo raw Box or ClawLink credentials; use ClawLink pairing and hosted OAuth flows.
\n\n\n## Reference(s):
\n- [ClawHub Box Skill Page](https://clawhub.ai/hith3sh/box-files)
\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- [Box API](https://developer.box.com/)
\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-use guidance]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses ClawLink's live Box catalog as the source of truth and requires user confirmation before write, destructive, external-facing, or bulk 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: Box Owner: hith3sh Summary: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse... Tags: latest:1.0.6 Version history: v1.0.6 | 2026-06-09T07:04:45.188Z | user Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source. v","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Box API │\n│ (User Chat) │ │ (OAuth) │ │ (Files) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Box │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Box │\n │ File │ │ Auth │ │ Web App │\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 Box tools\nclawlink_list_tools --integration box\n\n# Search for a specific tool\nclawlink_search_tools --query \"file\" --integration box"},{"language":"bash","snippet":"clawlink_list_integrations"},{"language":"bash","snippet":"clawlink_list_tools --integration box"},{"language":"text","snippet":"┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List files → Get metadata → 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: box-files\ndescription: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse enterprise content, manage file sharing, automate document workflows, or coordinate Box Sign signature requests.\n---\n\n# Box\n\n\n\nAccess Box via the Box API with managed OAuth authentication. Browse files, inspect metadata, manage sharing and collaboration, and coordinate file workflows from chat.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=box-files) for hosted connection flows and credentials so you do not need to configure Box API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Box |\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 Box |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Box API │\n│ (User Chat) │ │ (OAuth) │ │ (Files) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect Box │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Box │\n │ File │ │ Auth │ │ Web App │\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 Box again.\"\n\n## Quick Start\n\n```bash\n# List integrations\nclawlink_list_integrations\n\n# List Box tools\nclawlink_list_tools --integration box\n\n# Search for a specific tool\nclawlink_search_tools --query \"file\" --integration box\n```\n\n## Authenticat"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"box-files\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1780988685188\n}"},{"path":"skill-card.md","content":"## Description:\n\nManage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box 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\nEmployees, developers, and content administrators use this skill to browse Box content, manage file sharing and collaboration, automate document workflows, inspect metadata, and coordinate Box Sign requests from an agent chat.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill asks users to activate an unpinned third-party plugin that can perform high-impact Box account actions.\n\nMitigation: Review the ClawLink plugin and publisher trust before installing, and prefer a pinned or verified plugin release when available.\n\nRisk: Write actions can create, move, copy, delete, share, or change Box resources, including collaborations, users, groups, retention policies, legal holds, and signature requests.\n\nMitigation: Use tool description and preview steps before writes, require explicit user confirmation, and verify the target resource and intended effect before execution.\n\nRisk: Tool calls operate with the connected Box account's permissions and enterprise policies.\n\nMitigation: Connect only a minimum-permission Box account appropriate for the task and use extra review for administrative or compliance-sensitive operations.\n\n## Reference(s):\n\n- [Box Developer Documentation](https://developer.box.com/)\n- [Box API Reference](https://developer.box.com/reference/)\n- [ClawLink OpenClaw Documentation](https://docs.claw-link.dev/openclaw)\n- [ClawLink Verification](https://claw-link.dev/verify)\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/skills/box-files)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, API calls, guidance]\n\n**Output Format:** [Markdown guidance with shell command examples and JSON tool parameters]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Uses the live ClawLink Box tool catalog as the source of truth for available actions.]\n\n## Skill Version(s):\n\n1.0.6 (source: server release evidence)\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 Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse... Skill: Box Owner: hith3sh Summary: Manage Box files, folders, collaborations, shared links, metadata, and enterprise content workflows via the Box API. Use this skill when users want to browse... Tags: latest:1.0.6 Version history: v1.0.6 | 2026-06-09T07:04:45.188Z | user Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source. v","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1055,"uniquenessScore":51,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T12:35:05.604Z","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-09T12:35:05.604Z","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-10T01:13:01.522Z","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"}]}}}