Skip to main content

​
Configuration overview

OpenPawz works out of the box with sensible defaults. This page covers the optional settings you can tune after installation.

​
Provider setup

Each AI provider needs an API key (cloud) or a running instance (local). Configure providers in Settings → Models.
1

Open Settings

Click the gear icon in the bottom-left of the sidebar, then select Models.
2

Add a provider

Click Add Provider and choose from the list: Ollama, OpenAI, Anthropic, Google, DeepSeek, Grok, Mistral, OpenRouter, Moonshot, or Custom.
3

Enter credentials

For cloud providers, paste your API key. For Ollama, enter the host URL (default: http://localhost:11434).
4

Select default model

Pick a default model for new agents. You can override this per agent later.
→ Full provider guides: Providers

​
Workspace profiles

OpenPawz has a modular sidebar. Choose a workspace profile to show only the views you need.
ProfileVisible views
AllEverything — agents, channels, tasks, trading, research, content, mail
DeveloperAgents, tasks, browser, orchestrator, extensions
TraderAgents, trading, tasks, automations
WriterAgents, content studio, research, mail
MinimalAgents only
Change profiles in Settings → Workspace or create custom combinations. → Deep dive: Modular workspace

​
Environment variables

Some features require environment variables set in Settings → Environment:
VariablePurpose
OPENAI_API_KEYOpenAI provider access
ANTHROPIC_API_KEYAnthropic provider access
SMTP_HOST / IMAP_HOSTEmail tool configuration
GITHUB_TOKENGitHub tool access
TAILSCALE_AUTH_KEYTailscale mesh networking
Environment variables are stored locally and never transmitted.

​
Agent defaults

Set default values for new agents in Settings → Agent Defaults:
  • Default provider & model — which AI backs new agents
  • Default system prompt — baseline instructions
  • Temperature & token limits — generation parameters
  • Tool access — which tools are enabled by default
  • Memory settings — auto-capture and auto-recall toggles
Individual agents can override any default. → Deep dive: Agents guide

​
Advanced settings

Session compaction

Configure when and how sessions are compacted to manage context window limits. Set token thresholds, summary depth, and archive behavior.

Voice & TTS

Configure text-to-speech providers and voice settings for agents that speak their responses.

Browser sandbox

Set Chromium path, viewport size, proxy, and timeout settings for web automation.

Container sandbox

Configure Docker socket path, default image, resource limits, and network policies for isolated execution.