MonoClaw

Team Telegram Assistant

Deploy Mona as a shared Telegram assistant for your team. Everyone gets access to a capable AI that remembers context and respects boundaries.

Prerequisites

  • Working MonoClaw installation
  • A Telegram bot token from @BotFather
  • Admin access to add bots to your team group

Step 1: Create the bot

  1. Message @BotFather
  2. Send /newbot
  3. Name it (e.g., "Mona Assistant")
  4. Copy the HTTP API token

Step 2: Configure MonoClaw

monoclaw gateway setup

Choose Telegram and paste your token.

Step 3: Set up security

User allowlist

Add team members:

monoclaw gateway allowlist add <user-id-1>
monoclaw gateway allowlist add <user-id-2>

Find user IDs by having team members message @userinfobot.

Admin users

Designate admins who can run /update and /restart:

monoclaw config set gateway.telegram.admins ["<admin-user-id>"]

Step 4: Add to group chat

  1. Add @YourBotName to your team group
  2. Make sure the bot has permission to read messages
  3. Test with @YourBotName hello

Step 5: Configure tools

Enable tools relevant to your team:

monoclaw tools enable core
monoclaw tools enable web
monoclaw tools enable code_execution

Step 6: Set context

Create a team context file:

cat > ~/.monoclaw/team-context.md << 'EOF'
# Team Context

## Who we are
- Fintech startup in Hong Kong
- Tech stack: Python, React, PostgreSQL
- Common tasks: API development, data analysis, compliance checks

## How to help
- Provide concise, actionable answers
- Include code examples when relevant
- Flag any security implications
- Use Cantonese for casual questions, English for technical ones
EOF

Step 7: Test common workflows

Code review

@Mona review this function:
```python
def transfer_funds(from_account, to_account, amount):
    # ...


### Research

@Mona what's the latest on HKMA's virtual banking regulations?


### System admin

@Mona check if our server disk usage is above 80%


## Step 8: Set up voice mode

For convenience in group settings:

```bash
monoclaw config set telegram.voice.enabled true

Team members can send voice messages instead of typing.

Monitoring

Check gateway health:

monoclaw gateway status
monoclaw gateway logs

Best practices

  • Start in DMs — Test the bot privately before adding to groups
  • Use allowlists — Prevent unauthorized access
  • Set clear expectations — Tell the team what Mona can and can't do
  • Review sessions — Check monoclaw sessions list for usage patterns
  • Update regularly — Use /update from the group to keep Mona current