Configuration

# ~/.orcbot/orcbot.config.yaml

# LLM Provider Configuration
llmProvider: openai
modelName: gpt-4o-mini
openaiApiKey: sk-your-key-here

# Alternative providers
# googleApiKey: your-google-api-key
# openrouterApiKey: your-openrouter-key
# anthropicApiKey: your-anthropic-key

# Agent Identity
agentName: OrcBot

# Channel Tokens
telegramToken: your-telegram-bot-token
discordToken: your-discord-bot-token

# Autonomy Settings
autonomyEnabled: true
autonomyInterval: 300000  # 5 minutes in milliseconds
autonomyBacklogLimit: 10
autonomyAllowedChannels:
  - telegram
  - discord

# Task Execution Limits
maxStepsPerAction: 20
maxMessagesPerAction: 5
messageDedupWindow: 15

# Safety & Security
safeMode: false
sudoMode: false
adminUsers:
  telegram:
    - "123456789"  # Your Telegram user ID
  discord:
    - "987654321"  # Your Discord user ID

# Memory & Context
memoryContextLimit: 15
journalContextLimit: 1000
learningContextLimit: 1000
userContextLimit: 1500

# Web Gateway
gatewayPort: 3100
gatewayHost: 0.0.0.0
gatewayApiKey: your-secret-api-key

# Browser Settings
browserHeadless: true
browserMaxConcurrent: 2

// ConfigManager watches the file and emits events
fs.watch(this.configPath, (eventType) => {
  if (eventType === 'change') {
    const oldConfig = { ...this.config };
    this.config = this.loadConfig(customPath, true);
    eventBus.emit('config:changed', { oldConfig, newConfig: this.config });
  }
});

// Agent autonomously optimizes for code tasks
manage_config({
  action: "set",
  key: "modelName",
  value: "gpt-4o",
  reason: "Code refactoring task benefits from GPT-4's superior reasoning"
})

// Agent requests approval for sensitive changes
manage_config({
  action: "set",
  key: "openaiApiKey",
  value: "sk-new-key",
  reason: "API key rotation for security"
})

// View pending approvals
manage_config({ action: "pending" })

// Approve a requested change
manage_config({ action: "approve", key: "openaiApiKey" })

serverMode: true

# Automatically applies:
actionQueueCompletedTTL: 7200000  # 2 hours
actionQueueFailedTTL: 43200000    # 12 hours
vectorMemoryMaxEntries: 1500
processedMessagesCacheSize: 300
memoryConsolidationThreshold: 20
journalContextLimit: 800
learningContextLimit: 800
skipSimulationForSimpleTasks: true
compactSkillsPrompt: true

private syncConfigAcrossPaths() {
  const targets = [globalPath, homePath, localPath]
    .filter(p => p !== this.configPath);

  const protectedKeys = [
    'telegramToken', 'discordToken', 'openaiApiKey',
    'googleApiKey', 'smtpPassword', 'imapPassword'
  ];

  // Merge current config with existing values
  const merged = { ...this.config };
  for (const key of protectedKeys) {
    if (!merged[key] && targetConfig[key]) {
      merged[key] = targetConfig[key];  // Preserve existing secrets
    }
  }

  fs.writeFileSync(target, yaml.stringify(merged));
}

# Dynamic step budgets based on LLM-classified complexity
skipSimulationForSimpleTasks: true  # Skip planning for trivial tasks

# Complexity-based budgets:
# - trivial: 5 steps, 1 message
# - simple: 10 steps, 2 messages
# - standard: 20 steps, 5 messages
# - complex: 35 steps, 8 messages

skillRoutingRules:
  - intent: "search"
    preferSkills:
      - web_search
      - browser_navigate
  - intent: "code"
    preferSkills:
      - run_command
      - execute_typescript
  - intent: "communication"
    preferSkills:
      - send_message
      - telegram_send_buttons

autonomyAllowedChannels:
  - telegram  # Agent can message Telegram proactively
  - discord   # Agent can message Discord proactively
  # WhatsApp omitted - agent won't send unprompted messages there

# Memory consolidation thresholds
memoryConsolidationThreshold: 25  # Trigger at 25 short memories
memoryConsolidationBatch: 20      # Consolidate 20 at a time
memoryFlushSoftThreshold: 22      # Soft limit before flushing
memoryFlushCooldownMinutes: 30    # Wait 30min between flushes

# Vector memory
vectorMemoryMaxEntries: 2000      # Max semantic search entries
vectorMemoryEnabled: true

# Context limits
memoryContextLimit: 15            # Recent step memories
threadContextRecentN: 8           # Recent thread messages
threadContextRelevantN: 6         # Relevant thread messages
memoryExtendedContextLimit: 1200  # Extended context chars

private normalizePlatformPaths(config: AgentConfig): AgentConfig {
  // On Windows, POSIX paths from CI/Linux are remapped
  if (process.platform === 'win32') {
    const remapIfCiOrPosix = (value: string): string => {
      // /home/runner/.orcbot/memory.json → C:\Users\You\.orcbot\memory.json
      const idx = normalized.indexOf('/.orcbot/');
      if (idx >= 0) {
        const suffix = normalized.slice(idx + '/.orcbot/'.length);
        return path.join(this.dataHome, ...suffix.split('/'));
      }
      return value;
    };
  }
}

// Get single value
const modelName = this.agent.config.get('modelName');
const apiKey = this.agent.config.get('openaiApiKey');

// Set value (triggers hot-reload)
this.agent.config.set('modelName', 'gpt-4o');

// Get all config
const allConfig = this.agent.config.getAll();

// Get data directory
const dataHome = this.agent.config.getDataHome();

import { eventBus } from './core/EventBus';

eventBus.on('config:changed', ({ oldConfig, newConfig }) => {
  if (oldConfig.modelName !== newConfig.modelName) {
    logger.info(`Model changed: ${oldConfig.modelName} → ${newConfig.modelName}`);
  }
});

# Check which config file is being used
node dist/cli/index.js run
# Look for: "ConfigManager: Config path set to ..."

# Verify config syntax
npx js-yaml ~/.orcbot/orcbot.config.yaml

# Check file watcher is active
# OrcBot logs: "ConfigManager: Config file changed on disk, reloading..."

# If not working:
# 1. Check file permissions (must be readable)
# 2. Some editors use atomic writes that break watchers
# 3. Restart OrcBot to re-establish watch

# OrcBot auto-repairs on next load:
ConfigManager: Repairing worker-corrupted path for memoryPath: ...
ConfigManager: Worker-corruption repair complete. Saving corrected config.