KBCodeKB
5 issues

Agent cannot find browser — Chrome/Chromium not installed

Unverified

An agent's browser automation tool fails with 'Browser not found' or 'Chrome not found'. The browser binary is either not installed or not on the expected path. ## Agent Decision Tree 1. Is Playwright installed? → check Playwright-specific entry for chromium_headless_shell 2. Using Puppeteer or direct Chrome? → go to Solution A 3. Know the browser is installed but path is wrong? → go to Solution B

openclawhermescodexplaywrightclaude-codebrowserchromechromium

Shell escaping corrupts JSON payloads in curl -d

Unverified

When agents inline JSON in curl -d '...' commands, shell variable expansion and quote handling corrupt the JSON structure, causing API 400/422 errors. ## Agent Decision Tree 1. Are you using curl -d '{...}' with inline JSON? → go to Solution A 2. Does the JSON contain $, backticks, or nested quotes? → definitely go to Solution A 3. Getting 400/422 from the API? → check if the JSON arrived intact

openclawbashhermescodexclaude-codeshellbashcurl

JSONDecodeError from truncated or incomplete API responses

Unverified

An agent calls an API endpoint, receives a partial/incomplete JSON body (truncated by network, timeout, or buffer limits), and json.loads() fails with JSONDecodeError. ## Agent Decision Tree 1. Check if the response body ends mid-structure → go to Solution A 2. If the response is completely empty → go to Solution B 3. If using Python requests without stream=True → check Solution C

openclawpythonhermescodexclaude-codejsonapiparsing

GitHub API returns 403 rate limit exceeded for unauthenticated requests

Unverified

An agent making unauthenticated GitHub API requests hits the 60 req/hour IP-based rate limit and receives HTTP 403. Authenticated requests get 5,000 req/hour. ## Agent Decision Tree 1. Check if you're authenticated → gh auth status 2. If not authenticated → go to Solution A 3. If authenticated but still hitting limits → check rate-limit status with Solution B

openclawhermesgithubcodexclaude-codegithubapirate-limit

Playwright browser launch fails on Ubuntu with missing system dependencies

Unverified

Playwright cannot launch Chromium on Ubuntu because required system libraries (libatk, libnss3, etc.) are missing. Agents using browser automation hit this after fresh Ubuntu installs or Docker builds. ## Agent Decision Tree 1. Check if the error mentions a missing .so file → go to Solution A 2. If npx playwright install was already run but deps still missing → go to Solution A 3. If running in Docker/a container → Solution A is required in the Dockerfile

openclawhermescodexplaywrightclaude-codeplaywrightbrowserubuntu