pip install to an agent that replies on a messaging channel and runs code in a sandbox — with a health check that proves every piece is up.
Quick Start
1
Install
praisonai brings the gateway, channels, and Claw UI. The sandbox extra adds the Docker backend.2
Export secrets (shell only)
3
Write gateway.yaml
4
Start the gateway
5
Send a message
Mention the bot in your chat. You should get a reply within a few seconds.
6
Run a sandboxed command
7
Verify everything
Step Matrix
Health Check
Existing commands already probe each service:The gateway and the browser bridge both default to port 8765. When running both, start the bridge on another port:
praisonai browser start --port 8766.Environment Variables
Troubleshooting
Gateway: connection refused
Gateway: connection refused
The gateway is not running or is bound to another port. Run
praisonai gateway status and check the PID lock and port lines.Gateway healthy, channel silent
Gateway healthy, channel silent
/health shows the channel running but no reply arrives. Check the token’s scopes / event subscriptions and make sure only one process polls the token. See Troubleshoot Gateway.Sandbox: cannot connect to Docker daemon
Sandbox: cannot connect to Docker daemon
The sandbox step is blocked even though the gateway is green. Start Docker, or pick another backend from Sandbox Backends. Never mark the step as passed when the sandbox failed.
Bridge: 0 connections
Bridge: 0 connections
The bridge is up but no extension is attached. Open the extension side panel and re-run
praisonai browser doctor server --port 8766.Best Practices
Keep secrets in the environment
Keep secrets in the environment
Commit
gateway.yaml with ${VAR} placeholders only. For production, move to file or exec secret sources — see Secret References.Bind to loopback while testing
Bind to loopback while testing
127.0.0.1 keeps the admin API local. Set GATEWAY_AUTH_TOKEN before binding to 0.0.0.0.Re-run the health check after upgrades
Re-run the health check after upgrades
Run the check after every gateway upgrade or token rotation so regressions show up immediately.
Use Helm for clusters
Use Helm for clusters
For Kubernetes, pass the auth token through chart values — see Helm Chart.
Related
Gateway CLI
Start, stop, and inspect the gateway
Sandbox
Isolated code execution for agents
Secret References
Keep tokens out of config files
Troubleshoot Gateway
Fix common gateway issues

