# How to Install and Use Gog in OpenClaw - Tool: OpenClaw - Difficulty: Beginner - Time required: 10 minutes - Last updated: March 2026 ## TL;DR To use the GOG skill in OpenClaw, run `clawhub install gog`, configure your GOG API credentials in OpenClaw's config file, and start searching game catalogs, checking prices, and managing your wishlist directly from OpenClaw chat. The GOG ClawHub skill makes the entire GOG.com gaming library accessible through natural language prompts. ## Why Bring GOG Into Your OpenClaw Workflow GOG.com has built one of the largest collections of DRM-free PC games, with a catalog spanning indie gems, classic RPGs, strategy titles, and modern releases from major studios. If you spend time tracking game prices, curating a wishlist, or researching titles before purchasing, doing that work through repeated website visits and manual price checking is slow. The GOG ClawHub skill brings the entire GOG catalog into OpenClaw so you can search, compare, and manage your game library through conversation. The most immediate use case is price tracking and deal discovery. The GOG skill lets you ask OpenClaw to search for games by genre, developer, price range, or sale status — and GOG's regular sales and promotions mean there are always new deals surfacing. Rather than checking the GOG homepage manually, you can prompt OpenClaw to find currently discounted games in a category you care about and get a formatted list with current prices and discount percentages. Beyond search, the skill supports wishlist management: adding games to your wishlist, checking if wishlist items are currently on sale, and removing titles you have already purchased. For dedicated PC gamers who use GOG as their primary storefront, integrating it with OpenClaw turns routine library management tasks into simple chat commands rather than multi-step website interactions. ## Before you start - OpenClaw installed and running (see openclaw.ai for installation instructions) - ClawHub CLI available in your terminal (bundled with OpenClaw) - A GOG account at gog.com - GOG API credentials — check the GOG developer documentation or community resources for current API access options - Terminal/command line access to run the clawhub install command ## Step-by-step guide ### 1. Install the GOG Skill via ClawHub Open your terminal and run the clawhub install command to add the GOG skill to your OpenClaw instance. ClawHub downloads the skill package, verifies its integrity, and registers it with your local OpenClaw configuration. Installation takes 10-30 seconds. When complete, you will see a success message showing the installed version number and the configuration keys the skill requires. The skill will not activate until credentials are configured — attempting to use it before setup will return a clear error message listing the missing configuration. If the install fails with a 'command not found' error, verify that your OpenClaw installation is complete and that the ClawHub binary is on your PATH. Running `clawhub --version` is a quick way to confirm ClawHub is accessible before attempting skill installations. ``` clawhub install gog ``` **Expected result:** Terminal shows 'gog@X.X.X installed successfully. Required config: GOG_API_KEY (or similar credentials)'. The skill appears in `clawhub list` output. ### 2. Get Your GOG API Credentials GOG provides API access for developers and integration use cases. To get your credentials, navigate to your GOG account settings at gog.com. Look for 'Developer' or 'API Access' sections in the account settings page — GOG's API credential process may vary depending on account type and the current state of their developer program. For personal use integrations through OpenClaw, GOG may issue credentials directly through account settings, or you may need to use the GOG Galaxy authentication flow to obtain an access token. Check the GOG developer documentation or the OpenClaw community forums for the most current credential acquisition process, as GOG periodically updates how API access is managed. Once you have your GOG API key or OAuth credentials, note the exact variable names that the feishu-bridge skill expects — run `clawhub info gog` to see the precise configuration key names. These must match exactly what you set in OpenClaw's configuration. If GOG direct API credentials are not available for your account type, the gog skill may support an alternative authentication method using your GOG username and password combined with session token extraction — refer to the skill's documentation via `clawhub info gog` for the currently supported authentication approaches. **Expected result:** You have your GOG API credentials (API key, access token, or equivalent) copied and ready to configure in OpenClaw. ### 3. Configure GOG Credentials in OpenClaw Add your GOG credentials to OpenClaw's configuration using the `clawhub config set` command or by editing the `~/.openclaw/.env` file directly. Use the exact variable names shown in `clawhub info gog` output — these must match precisely for the skill to authenticate correctly with GOG's API. After adding your credentials, run `clawhub reload` to apply the changes. OpenClaw will pick up the new configuration without a full restart. Verify the credentials are set by running `clawhub config get` for each credential variable — you should see a masked value confirming the key is present. If the skill uses OAuth-style access tokens that expire, you will need to refresh them periodically. Some versions of the gog skill handle token refresh automatically; check the skill documentation to understand the token lifecycle for your installed version. ``` # Add to ~/.openclaw/.env (use the exact variable name from `clawhub info gog`) GOG_API_KEY=your_gog_api_key_here # Or set via clawhub config command clawhub config set GOG_API_KEY your_gog_api_key_here # Verify the key is saved clawhub config get GOG_API_KEY # Apply changes clawhub reload ``` **Expected result:** `clawhub config get GOG_API_KEY` returns a masked value. Running `clawhub status` shows the gog skill as 'active' rather than 'needs configuration'. ### 4. Test the Skill with a Game Catalog Search Open OpenClaw chat and run a test prompt to confirm the GOG skill is working. Start with a simple catalog search — asking for games in a specific genre or by a specific developer. The gog skill activates automatically when OpenClaw recognizes game catalog intent in your prompts, or you can explicitly invoke it by mentioning 'on GOG' or 'using GOG' in your query. A successful response will include game titles, current prices, and brief descriptions from the GOG catalog. The response typically takes 2-5 seconds as OpenClaw queries the GOG API and formats the results. If you see an authentication error in the response, double-check your credential configuration from the previous step. If the skill does not activate on your first test, try rephrasing to explicitly mention GOG: 'Search GOG for...' or 'Use the GOG skill to find...' This signals to OpenClaw that the GOG skill specifically should handle the request rather than routing to a general search skill. **Expected result:** OpenClaw returns a formatted list of GOG games matching your criteria, with titles, prices, and descriptions. The response includes data that matches what you would see on the GOG website for those titles. ### 5. Advanced Usage: Wishlist Management and Sale Alerts Beyond catalog search, the GOG skill supports wishlist operations when properly authenticated with your personal GOG account. You can add games to your wishlist, view current wishlist contents, check which items are on sale, and remove games you have already acquired. Wishlist functionality requires that your GOG credentials grant access to your personal account data — not just public catalog data. If your API key is scoped to public catalog access only, wishlist prompts will return a permissions error. In that case, check `clawhub info gog` for instructions on upgrading your credential scope to include account data access. For sale monitoring, you can create a recurring OpenClaw prompt that checks your wishlist against current GOG sale prices. Combined with a notification skill (Telegram, Discord, or Feishu), this creates an automated deal alert system: OpenClaw checks GOG daily and notifies you the moment a wishlist game hits your target price. RapidDev can help set up automated GOG sale monitoring workflows that combine the GOG skill with notification and scheduling integrations in OpenClaw — useful for building personal deal-tracking systems without manual daily checks. ``` # Configure GOG skill options in ~/.openclaw/skills/gog.yaml gog: include_dlc: false # include DLC in search results (default: false) currency: "USD" # preferred currency for prices (default: USD) language: "en" # catalog language (default: en) max_results: 10 # max results per search query (default: 5) include_coming_soon: false # include unreleased games in results ``` **Expected result:** Wishlist queries return personalized data from your GOG account, showing current sale status and prices for games on your list. Sale notifications include accurate discount information matching the GOG website. ## Best practices - Store GOG credentials only in your OpenClaw `.env` file or via `clawhub config set` — never in chat prompts or files that might end up in version control. - Run `clawhub info gog` after installation to understand the exact credential variable names and available configuration options before attempting setup. - Set your preferred currency in the GOG skill config (`currency: "USD"` or your local currency) to get accurate prices without mental currency conversion. - For wishlist monitoring workflows, test the wishlist read access separately from catalog search to confirm your credentials have the required account data scope. - Use specific game titles or developer names in your first test prompts rather than broad genre terms — this gives a cleaner confirmation that the API connection is working. - Combine the GOG skill with a notification skill (Telegram, Discord) to build automated sale alerts that notify you when wishlist items hit your target discount threshold. - Set `include_dlc: false` in your skill config unless you specifically want DLC results mixed into game searches — DLC entries can dilute catalog search results. - Refresh GOG credentials proactively if your access type uses expiring tokens — a credential expiry mid-workflow is more disruptive than a planned refresh. ## Use cases ### Game Discovery by Genre and Price Search the GOG catalog for games matching your preferences — genre, theme, price range, or review score. Get a curated shortlist from OpenClaw rather than manually browsing category pages, with enough detail to make a quick purchase decision. Prompt example: ``` Search GOG for highly-rated strategy games under $15 that are currently on sale. Show me the top 5 with their current price, discount percentage, and a one-line description of each game. ``` ### Wishlist Sale Monitoring Check whether any games on your GOG wishlist have gone on sale today. This replaces manually visiting the GOG website to check each wishlist item, condensing the check into a single OpenClaw prompt. Prompt example: ``` Check my GOG wishlist and tell me which games are currently on sale or at their lowest recorded price. Include the current price, the discount percentage, and how long the sale runs. ``` ### Game Research and Comparison Before buying a game, ask OpenClaw to pull detailed information about it from GOG — description, system requirements, available DLC, user rating, and current price. Useful for comparing two or three similar titles before deciding which one to purchase. Prompt example: ``` Look up 'Disco Elysium' on GOG and give me its current price, user rating, content warnings, approximate play time if available, and whether the base game includes all DLC or if any is sold separately. ``` ## Troubleshooting ### OpenClaw returns 'gog: authentication failed' or '401 Unauthorized' when running game searches Cause: GOG_API_KEY (or the equivalent credential) is missing from OpenClaw's configuration, set under an incorrect variable name, or the credential has expired or been revoked. Solution: Run `clawhub config get GOG_API_KEY` (or the variable name shown in `clawhub info gog`) to confirm the credential is present. If it returns empty, re-run the `clawhub config set` command with the correct variable name and value. Run `clawhub reload` after correcting the configuration. ``` # Check and re-set credential clawhub config get GOG_API_KEY clawhub config set GOG_API_KEY your_gog_api_key_here clawhub reload ``` ### `clawhub install gog` fails with a timeout or '429 Too Many Requests' error Cause: ClawHub's skill registry enforces rate limits during peak usage. This is a ClawHub registry issue unrelated to GOG. Solution: Wait 2-5 minutes and retry the install. If the problem persists, use `clawhub install gog --force` to clear any partial installation state and retry a clean install. ``` # Force reinstall clawhub install gog --force ``` ### Game searches return results but wishlist operations fail with a permissions error Cause: Your GOG API credentials are scoped to public catalog access only and do not include permission to access your personal account data (wishlist, library, purchase history). Solution: Run `clawhub info gog` to check if the skill requires a different credential for account-level operations. You may need to re-authenticate using a different GOG OAuth flow that grants account access scope. Follow the credential upgrade instructions in the skill documentation. ### GOG search results are empty or show very few games for broad queries Cause: The GOG API may apply stricter filtering than the website, or the search query does not match GOG's catalog taxonomy for genre and category names. Solution: Try searching by exact game title or developer name first to confirm the API connection is working. For genre searches, use GOG's exact category names (visible in their URL slugs on the website) rather than descriptive terms. Increase `max_results` in the skill config if results are cut off. ``` # Increase max results in skill config gog: max_results: 20 ``` ## Frequently asked questions ### How do I install the GOG skill in OpenClaw? Run `clawhub install gog` in your terminal. Then get your GOG API credentials from your GOG account settings or developer portal, configure them in OpenClaw with `clawhub config set GOG_API_KEY your-key`, and run `clawhub reload`. You can then search the GOG catalog directly from OpenClaw chat. ### What can I do with the GOG integration in OpenClaw? The GOG skill lets you search the GOG game catalog by genre, price, or developer from OpenClaw chat, check current prices and active sale discounts, manage your GOG wishlist, and look up detailed game information including descriptions, ratings, and system requirements — all through natural language prompts. ### How do I configure the GOG API key in OpenClaw? Run `clawhub config set GOG_API_KEY your-key-here` from the terminal (use the exact variable name shown in `clawhub info gog`), or add the variable to your `~/.openclaw/.env` file. Run `clawhub reload` after setting the credential. Verify it is saved with `clawhub config get GOG_API_KEY`. ### Why is my GOG wishlist not accessible even though catalog search works? Catalog search uses public API access, while wishlist operations require credentials scoped to your personal account data. Your current API key may only have public catalog permissions. Run `clawhub info gog` to check if the skill requires a different authentication flow for account-level access, and follow the instructions for obtaining account-scoped credentials. ### Can OpenClaw notify me automatically when GOG games go on sale? Yes — combine the GOG skill with a notification skill (Telegram, Discord, or another messaging integration). Set up an OpenClaw workflow that checks your GOG wishlist for current sales and sends a notification when a discount threshold is met. This creates an automated deal alert without manual daily checks. ### Does RapidDev help set up GOG automation with OpenClaw? Yes — RapidDev can help configure GOG as part of a multi-skill OpenClaw workflow, particularly for teams or individuals building automated deal monitoring systems that combine GOG with notification integrations. Reach out to RapidDev if you need help connecting the GOG skill to other tools in your OpenClaw setup. ### OpenClaw GOG rate limit errors — how do I handle them? GOG's API enforces rate limits on how many requests can be made per time window. If you hit rate limits, add pauses between sequential GOG queries in your OpenClaw workflows and reduce the frequency of automated wishlist checks. Avoid running multiple simultaneous GOG queries from the same OpenClaw session. --- Source: https://www.rapidevelopers.com/openclaw-integrations/gog © RapidDev — https://www.rapidevelopers.com/openclaw-integrations/gog