Dotfiles

Name: Dotfiles
Rating: 3.5 (1 reviews)
Author: chongivan

By chongivan 👁 3 views ▲ 0 votes

Portable OpenClaw config with Telegram reactions, SearXNG plugin, and workspace files. One-command setup via install.sh

GitHub

Install

npm install -g

README

# 🦞 OpenClaw Dotfiles

My personal OpenClaw configuration — battle-tested and ready to deploy on any new machine.

## What's Inside

```
openclaw-dotfiles/
├── config/
│   ├── openclaw.json    # Config template (secrets use ${VAR} refs)
│   └── env.example      # Example .env — copy to ~/.openclaw/.env
├── workspace/
│   ├── AGENTS.md        # Agent operating instructions
│   ├── SOUL.md          # Personality & values
│   ├── USER.md          # User preferences
│   ├── IDENTITY.md      # Name & emoji
│   ├── TOOLS.md         # Local tool notes
│   └── HEARTBEAT.md     # Periodic check config
├── plugins/
│   └── searxng/         # SearXNG search plugin
├── install.sh           # One-command setup script
└── .gitignore           # Keeps secrets out of git
```

## Quick Start (New Machine)

```bash
# 1. Install OpenClaw
npm install -g openclaw
openclaw onboard

# 2. Clone this repo
git clone [email protected]:YOUR_USER/openclaw-dotfiles.git ~/openclaw-dotfiles

# 3. Run the installer
cd ~/openclaw-dotfiles
chmod +x install.sh
./install.sh

# 4. Fill in your secrets
nano ~/.openclaw/.env

# 5. Restart & test
openclaw gateway restart
# Send a Telegram message → should see 👀 reaction
```

## Key Config Highlights

- **ackReaction: 👀** with `ackReactionScope: "all"` — auto read receipts on Telegram
- **SearXNG** plugin for web search (replaces built-in web_search)
- **Gemini 2.5 Flash** as primary model with Pro/Lite/Free fallbacks
- **Safeguard compaction** mode
- **Coding tool profile** with deny on native web_search

## Secrets

All secrets live in `~/.openclaw/.env` (never committed). OpenClaw natively substitutes `${VAR}` at gateway startup.

Required secrets:
- `TELEGRAM_BOT_TOKEN` — from @BotFather
- `GATEWAY_TOKEN` — generate with `openssl rand -hex 24`
- `GEMINI_API_KEY` — from Google AI Studio
- `NOTION_API_KEY` — from Notion integrations

## Updating

After changing your live config, sync back to this repo:

```bash
# From your VPS, copy the updated files:
cp ~/.openclaw/workspace/AGENTS.md ~/openclaw-dotfiles/workspace/
# ... edit, commit, push
```

channels