Configuration — PicoClaw Docs | Workspace, Agents, Providers

Workspace layout

PicoClaw stores data in your configured workspace (default ~/.picoclaw/workspace):

~/.picoclaw/workspace/
├── sessions/   # Conversation sessions and history
├── memory/     # Long-term memory (MEMORY.md)
├── state/      # Persistent state (last channel, etc.)
├── cron/       # Scheduled jobs database
├── skills/     # Custom skills
├── AGENTS.md   # Agent behavior guide
├── HEARTBEAT.md # Periodic task prompts (every 30 min)
├── IDENTITY.md # Agent identity
├── SOUL.md     # Agent soul
├── TOOLS.md    # Tool descriptions
└── USER.md     # User preferences

Agents defaults

Option	Default	Description
`workspace`	~/.picoclaw/workspace	Working directory for the agent
`restrict_to_workspace`	true	Restrict file/command access to workspace
`model`	glm-4.7	Default LLM model
`max_tokens`	8192	Max tokens per response
`temperature`	0.7	Sampling temperature
`max_tool_iterations`	20	Max tool calls per turn

Providers

Set providers.<name>.api_key and optionally api_base. See Providers & API Keys for details.

Tools (web search)

Brave Search (API key) or DuckDuckGo (no key). Example:

"tools": {
  "web": {
    "brave": { "enabled": false, "api_key": "YOUR_KEY", "max_results": 5 },
    "duckduckgo": { "enabled": true, "max_results": 5 }
  }
}

Heartbeat

Periodic tasks via HEARTBEAT.md. Config:

"heartbeat": {
  "enabled": true,
  "interval": 30
}

Interval in minutes (min: 5). Env: PICOCLAW_HEARTBEAT_ENABLED, PICOCLAW_HEARTBEAT_INTERVAL.

Full config example

See config.example.json on GitHub for a complete template.