> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bot Default Tools

> The 20+ tools every bot gets automatically

Bot default tools provide instant superpowers to every bot deployment, automatically injecting 20+ safe and useful tools when agents have no explicit tool configuration.

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph TB
    subgraph "Auto-Injected Bot Tools"
        BOT[🤖 Bot]
        BOT --> FILE[📁 Files<br/>read/write/edit/list/search]
        BOT --> PLAN[📋 Planning<br/>todo_add/list/update]
        BOT --> SKILL[🧠 Skills<br/>skill_manage/list/view]
        BOT --> WEB[🌐 Web<br/>search_web/web_crawl]
        BOT --> MEM[💾 Memory<br/>store/search memory & learning]
        BOT --> SCHED[⏰ Schedule<br/>schedule_add/list/remove]
    end
    classDef bot fill:#8B0000,stroke:#7C90A0,color:#fff
    classDef cat fill:#189AB4,stroke:#7C90A0,color:#fff
    class BOT bot
    class FILE,PLAN,SKILL,WEB,MEM,SCHED cat
```

## Quick Start

<Steps>
  <Step title="Zero-Config Bot">
    ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    from praisonaiagents import Agent
    from praisonai.bots import TelegramBot

    agent = Agent(
        name="Assistant",
        instructions="You help users. Use any tool you need."
    )

    # No tools= passed — bot auto-injects safe defaults
    TelegramBot(token="YOUR_TOKEN", agent=agent).start()
    ```
  </Step>

  <Step title="Custom Tool Selection">
    ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    from praisonaiagents.bots import BotConfig

    config = BotConfig(
        token="YOUR_TOKEN",
        default_tools=["search_web", "read_file", "todo_add"],  # override list
        auto_approve_tools=True,  # default True for bots
    )

    bot = TelegramBot(config=config, agent=agent)
    ```
  </Step>
</Steps>

***

## How It Works

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
sequenceDiagram
    participant B as 🤖 Bot
    participant A as 🤖 Agent
    participant D as 📦 Defaults
    participant W as 📁 Workspace
    
    B->>A: Check agent.tools
    A-->>B: None (empty)
    B->>D: Apply smart defaults
    D->>W: Check workspace config
    W-->>D: ✅ Workspace available
    D-->>B: Full tool list (20+ tools)
    B->>A: Inject tools
    A-->>B: Ready with superpowers
```

Smart defaults activate when:

| Condition                   | Behavior                 | Result              |
| --------------------------- | ------------------------ | ------------------- |
| **Agent has no tools**      | Auto-inject defaults     | Full 20+ tool suite |
| **Agent has tools=\[]**     | Respect explicit empty   | No tools injected   |
| **Agent has tools=\[...]**  | Keep existing tools      | No injection        |
| **No workspace configured** | Filter destructive tools | Safe subset only    |

***

## Configuration Options

### Complete Default Tools List

| Tool              | Category      | Safe without workspace? | Notes                                  |
| ----------------- | ------------- | :---------------------: | -------------------------------------- |
| `search_web`      | Web           |            ✅            | Search the internet                    |
| `web_crawl`       | Web           |            ✅            | Crawl and extract web content          |
| `store_memory`    | Memory        |            ✅            | Store information in memory            |
| `search_memory`   | Memory        |            ✅            | Search stored memories                 |
| `store_learning`  | Learning      |            ✅            | Store learned knowledge                |
| `search_learning` | Learning      |            ✅            | Search learned knowledge               |
| `schedule_add`    | Scheduling    |            ✅            | Add scheduled tasks                    |
| `schedule_list`   | Scheduling    |            ✅            | List scheduled tasks                   |
| `schedule_remove` | Scheduling    |            ✅            | Remove scheduled tasks                 |
| `clarify`         | Clarification |            ✅            | Ask clarifying questions               |
| `read_file`       | Files         |      ✅ (read-only)      | **NEW** — Read files from workspace    |
| `write_file`      | Files         |  ⚠️ requires workspace  | **NEW** — Write files to workspace     |
| `edit_file`       | Files         |  ⚠️ requires workspace  | **NEW** — Edit files with find/replace |
| `list_files`      | Files         |            ✅            | **NEW** — List directory contents      |
| `search_files`    | Files         |            ✅            | **NEW** — Search for patterns in files |
| `todo_add`        | Planning      |            ✅            | **NEW** — Add tasks to todo list       |
| `todo_list`       | Planning      |            ✅            | **NEW** — List todo items              |
| `todo_update`     | Planning      |            ✅            | **NEW** — Update todo status/content   |
| `skills_list`     | Skills        |            ✅            | **NEW** — List available skills        |
| `skill_view`      | Skills        |            ✅            | **NEW** — View skill details           |
| `skill_manage`    | Skills        |  ⚠️ requires workspace  | **NEW** — Create/edit/delete skills    |

### Intentionally Excluded Tools

These tools are **NOT** auto-injected and require explicit opt-in:

| Tool             | Reason              | How to Enable                   |
| ---------------- | ------------------- | ------------------------------- |
| `delegate_task`  | Stub implementation | Add to `default_tools` manually |
| `session_search` | Placeholder only    | Add to `default_tools` manually |

### Smart Defaults Configuration

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents.bots import BotConfig

# Disable auto-injection completely
config = BotConfig(
    token="YOUR_TOKEN",
    default_tools=[],  # explicit empty list
)

# Custom safe subset
config = BotConfig(
    token="YOUR_TOKEN", 
    default_tools=[
        "search_web", "store_memory", "todo_add",
        "read_file", "skills_list"
    ]
)

# Full suite (same as default when workspace configured)
config = BotConfig(
    token="YOUR_TOKEN",
    workspace_dir="./bot-workspace",  # enables destructive tools
    default_tools=None,  # use full defaults
)
```

### Tool Approval Settings

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Auto-approve all tool calls (default for bots)
config = BotConfig(
    auto_approve_tools=True,  # ← Default: True for chat bots
)

# Require manual approval (useful for development)
config = BotConfig(
    auto_approve_tools=False,  # Agents show confirmation prompts
)
```

***

## Common Patterns

### Workspace-Aware Filtering

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Without workspace: safe tools only
config = BotConfig(
    token="YOUR_TOKEN",
    # No workspace_dir set
    # Result: write_file, edit_file, skill_manage filtered out
)

# With workspace: full tool suite
config = BotConfig(
    token="YOUR_TOKEN",
    workspace_dir="./safe-sandbox",
    # Result: all 20+ tools available
)
```

### Development vs Production

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Development: explicit tool control
agent = Agent(
    name="Dev Bot",
    tools=["search_web", "read_file"]  # explicit list prevents defaults
)

# Production: trust smart defaults  
agent = Agent(
    name="Prod Bot", 
    instructions="Help users with anything"
    # No tools= → auto-injection activates
)
```

### Tool Categories by Use Case

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Minimal web assistant
config = BotConfig(default_tools=[
    "search_web", "web_crawl", "store_memory", "search_memory"
])

# File-focused assistant  
config = BotConfig(default_tools=[
    "read_file", "write_file", "edit_file", "list_files", "search_files"
])

# Learning assistant
config = BotConfig(default_tools=[
    "store_learning", "search_learning", "skills_list", "skill_view", "skill_manage"
])
```

***

## Best Practices

<AccordionGroup>
  <Accordion title="Trust Smart Defaults">
    In most cases, let the bot auto-inject tools rather than specifying manually. Smart defaults adapt based on workspace configuration and provide the safest possible tool suite.
  </Accordion>

  <Accordion title="Workspace Security">
    Destructive file tools (`write_file`, `edit_file`, `skill_manage`) are automatically filtered out unless a workspace is configured. This ensures bots are safe by construction.
  </Accordion>

  <Accordion title="Development Testing">
    Use `auto_approve_tools=False` during development to see exactly which tools your bot is calling. Switch to `auto_approve_tools=True` for production deployments.
  </Accordion>

  <Accordion title="Explicit Override">
    To disable auto-injection, pass an explicit empty list: `Agent(tools=[])`. Passing no tools parameter triggers smart defaults.
  </Accordion>
</AccordionGroup>

***

## Related

<CardGroup cols={2}>
  <Card title="Workspace" icon="folder-lock" href="/docs/features/workspace">
    How workspace containment enables safe file tools
  </Card>

  <Card title="BotOS" icon="robot" href="/docs/concepts/bot-os">
    Multi-platform bot orchestration concepts
  </Card>
</CardGroup>