Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pinata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

The Console tab is a shell. You get an interactive prompt inside your agent’s container, with the same workspace your agent reads and writes.
Image
--- Agent Console ---
Working directory: /home/node/clawd/workspace

~/clawd/workspace $
Anything you can do with a shell, you can do here:
  • Run bash, python, node, git, curl, jq
  • Tail log files: tail -f /tmp/user-build.log
  • Check what the agent sees: env | sort
  • Confirm a service is listening: ss -tlnp
  • Edit a file with vi or nano
The session starts in /home/node/clawd/workspace — the same workspace shown on the Files tab. Skills live under skills/, uploaded files under uploads/.
The button in the top-right of the panel switches to fullscreen mode, which is much more pleasant for anything beyond a one-liner.

​
When to reach for the Console

The Console is the second-best debugging tool, after Logs. Use it when:
  • Logs show an error and you need to look at a file to understand it
  • A lifecycle script failed and you want to read /tmp/user-build.log or /tmp/user-start.log
  • You want to confirm a process is actually running (ps aux | grep <name>)
  • You want to reproduce a one-off command the agent ran
Quick checks worth knowing: 
# What did the build script say?
tail -n 200 /tmp/user-build.log

# What did the start script say?
tail -n 200 /tmp/user-start.log

# Latest OpenClaw log
ls -la /tmp/openclaw/

# OpenClaw runtime config
cat /home/node/.openclaw/openclaw.json

# Manifest the agent is using
cat workspace/manifest.json

# Is anything listening on common dev ports?
ss -tlnp
For workflows by symptom, see Troubleshooting.

​
Running a command from outside the UI

If you’re scripting against an agent, hit the API: 
curl -X POST \
  -H "Authorization: Bearer $PINATA_JWT" \
  -H "Content-Type: application/json" \
  -d '{"command":"ls -la workspace","cwd":"/home/node/clawd"}' \
  https://agents.pinata.cloud/v0/agents/$AGENT_ID/console/exec
The response is JSON: { stdout, stderr, exitCode, command, timestamp }.
Console access is full shell access. Anyone with the gateway token has it. Treat the token like a server credential.