Is gorgias safe to install?

SaferSkills independently audited gorgias (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

clawhub-skills/gorgias/SKILL.md · 1 file

clawhub-skills/gorgias/SKILL.md8.5 KB · Markdown

name: gorgias

description: Gorgias e-commerce helpdesk API integration with managed OAuth. Create and manage support tickets, handle customer data, organize teams, and manage account settings. Use this skill when users want to search support tickets, update customer information, manage helpdesk teams, or create new support tickets.

Gorgias

Manage your e-commerce helpdesk from chat -- create and update tickets, manage customer data, organize support teams, and configure account settings. Powered by ClawLink for hosted OAuth.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect Gorgias
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect Gorgias

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│  Gorgias API     │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

// 1. List support tickets
clawlink_call_tool({ tool: "gorgias_list_tickets", parameters: {} })

// 2. Get a specific customer
clawlink_call_tool({ tool: "gorgias_get_customer", parameters: { customer_id: "12345" } })

// 3. Create a new ticket
clawlink_call_tool({ tool: "gorgias_create_ticket", parameters: { subject: "Order inquiry", customer_id: "12345" } })

Authentication

ClawLink handles OAuth with Gorgias. No API keys needed. Connect at claw-link.dev/dashboard?add=gorgias.

Connection Management

// List connections
clawlink_list_integrations()

// Verify by fetching account info
clawlink_call_tool({ tool: "gorgias_get_account", parameters: {} })

Security & Permissions

Read tools are safe and require no confirmation
Write tools require confirmation before execution
Delete and merge operations are high-impact and irreversible

Tool Reference

Ticket Operations

Tool	Description	Mode
`gorgias_list_tickets`	List tickets with filtering options	Read
`gorgias_get_ticket`	Get a specific ticket by ID	Read
`gorgias_create_ticket`	Create a new support ticket	Write
`gorgias_update_ticket`	Update an existing ticket	Write
`gorgias_delete_ticket`	Delete a specific ticket	Write
`gorgias_add_ticket_tags`	Add tags to a ticket	Write
`gorgias_remove_ticket_tags`	Remove tags from a ticket	Write
`gorgias_set_ticket_tags`	Replace all tags on a ticket	Write
`gorgias_list_ticket_tags`	List all tags for a ticket	Read
`gorgias_list_ticket_field_values`	List field values for a ticket	Read
`gorgias_delete_ticket_field_value`	Delete a specific ticket field value	Write

Customer Operations

Tool	Description	Mode
`gorgias_list_customers`	List customers with filtering	Read
`gorgias_get_customer`	Get a specific customer by ID	Read
`gorgias_create_customer`	Create a new customer	Write
`gorgias_update_customer`	Update an existing customer	Write
`gorgias_delete_customer`	Delete a specific customer	Write
`gorgias_delete_customers`	Delete multiple customers	Write
`gorgias_merge_customers`	Merge two customers into one	Write
`gorgias_set_customer_data`	Set complete data object for a customer	Write
`gorgias_list_customer_field_values`	List field values for a customer	Read
`gorgias_delete_customer_field_value`	Delete a specific customer field value	Write

Event Operations

Tool	Description	Mode
`gorgias_list_events`	List events with filtering options	Read
`gorgias_get_event`	Get a specific event by ID	Read

Team Operations

Tool	Description	Mode
`gorgias_list_teams`	List all teams	Read
`gorgias_get_team`	Get a specific team by ID	Read
`gorgias_create_team`	Create a new team	Write
`gorgias_update_team`	Update an existing team	Write
`gorgias_delete_team`	Delete a specific team	Write

Account Operations

Tool	Description	Mode
`gorgias_get_account`	Get Gorgias account information	Read
`gorgias_list_account_settings`	List all account settings	Read
`gorgias_create_account_setting`	Create a new account setting	Write
`gorgias_update_account_setting`	Update an existing account setting	Write

Code Examples

Example 1: Ticket management

// List open tickets
const tickets = await clawlink_call_tool({
  tool: "gorgias_list_tickets",
  parameters: { status: "open", limit: 10 }
});

// Update a ticket
await clawlink_call_tool({
  tool: "gorgias_update_ticket",
  parameters: {
    ticket_id: "67890",
    status: "closed",
    comment: "Resolved via automated workflow."
  }
});

Example 2: Customer lookup and update

// Find a customer
const customers = await clawlink_call_tool({
  tool: "gorgias_list_customers",
  parameters: { email: "[email protected]" }
});

// Update customer data
await clawlink_call_tool({
  tool: "gorgias_update_customer",
  parameters: {
    customer_id: "12345",
    name: "Jane Smith",
    data: { vip: true }
  }
});

Example 3: Team and ticket tags

// Add tags to a ticket
await clawlink_call_tool({
  tool: "gorgias_add_ticket_tags",
  parameters: {
    ticket_id: "67890",
    tags: ["urgent", "billing"]
  }
});

// List teams
const teams = await clawlink_call_tool({
  tool: "gorgias_list_teams",
  parameters: {}
});

Discovery Workflow

Call clawlink_list_integrations to confirm gorgias is connected.
Call clawlink_list_tools --integration gorgias to see the live catalog.
Use clawlink_search_tools({ query: "ticket", integration: "gorgias" }) to find specific tools.

Execution Workflow

READ (safe):     list_tickets → get_customer → list_teams → list_events
WRITE (confirm): create_ticket → update_customer → add_ticket_tags → create_team
DELETE (high):   delete_ticket → delete_customer → merge_customers → delete_team

Notes

Merging customers combines their data and ticket history permanently
Customer and ticket field values can be managed independently
Account settings control helpdesk behavior and integrations

Error Handling

Status / Error	Meaning
401 Unauthorized	OAuth token expired -- reconnect at dashboard
403 Forbidden	Insufficient permissions for this action
404 Not Found	Ticket, customer, or team ID does not exist
409 Conflict	Duplicate customer or ticket
429 Rate Limited	Too many requests -- apply exponential backoff

Troubleshooting

Tools Not Visible

Start a fresh OpenClaw chat to reload plugin catalog
Call clawlink_list_integrations to confirm pairing

Invalid Tool Call

Verify customer and ticket IDs are numeric
Use gorgias_list_tickets to confirm valid ticket IDs
Tag names must match existing tags in the helpdesk

Resources

Gorgias API Docs: https://developers.gorgias.com/
ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=gorgias
ClawLink Docs: https://docs.claw-link.dev/openclaw

Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=gorgias) -- an integration hub for OpenClaw

gorgias— agent skill

Is gorgias safe to install?

Gorgias

Setup in 3 Steps

How It Works

Install

Quick Start

Authentication

Connection Management

Security & Permissions

Tool Reference

Ticket Operations

Customer Operations

Event Operations

Team Operations

Account Operations

Code Examples

Example 1: Ticket management

Example 2: Customer lookup and update

Example 3: Team and ticket tags

Discovery Workflow

Execution Workflow

Notes

Error Handling

Troubleshooting

Tools Not Visible

Invalid Tool Call

Resources

Audit the pieces. Scan the whole. Decide.