Configuration

Config file: ~/.picoclaw/config.json. Created by picoclaw onboard. See Get Started and GitHub for full examples.

Main sections

  • agents.defaults – workspace, model, max_tokens, temperature, restrict_to_workspace. See Workspace, Security.
  • providers – openrouter, zhipu, anthropic, openai, deepseek, groq, gemini. API keys and api_base. See Providers.
  • channels – telegram, discord, qq, dingtalk, line. Tokens and allowFrom. See Integrations.
  • tools.web – brave, duckduckgo for web search. Optional. See FAQ (API 配置问题).
  • heartbeat – enabled, interval (minutes). See Heartbeat.

Environment variables

Override config with env: e.g. PICOCLAW_AGENTS_DEFAULTS_RESTRICT_TO_WORKSPACE, PICOCLAW_HEARTBEAT_ENABLED, PICOCLAW_HEARTBEAT_INTERVAL. See Security and Heartbeat.

Related