197 lines
5.0 KiB
Markdown
197 lines
5.0 KiB
Markdown
# TOOLS.md - Local Notes
|
|
|
|
---
|
|
|
|
## Credentials Location
|
|
|
|
All credentials stored in `.credentials/` (gitignored):
|
|
- `example-api.txt` — Example API key
|
|
|
|
---
|
|
|
|
## [Tool Name]
|
|
|
|
**Status:** ✅ Working | ⚠️ Issues | ❌ Not configured
|
|
|
|
**Configuration:**
|
|
```
|
|
Key details about how this tool is configured
|
|
```
|
|
|
|
**Gotchas:**
|
|
- Things that don't work as expected
|
|
- Workarounds discovered
|
|
|
|
**Common Operations:**
|
|
```bash
|
|
# Example command
|
|
tool-name --common-flag
|
|
```
|
|
|
|
---
|
|
Skills define *how* tools work. This file is for *your* specifics — the stuff that's unique to your setup.
|
|
|
|
## What Goes Here
|
|
|
|
Things like:
|
|
- Camera names and locations
|
|
- SSH hosts and aliases
|
|
- Preferred voices for TTS
|
|
- Speaker/room names
|
|
- Device nicknames
|
|
- Anything environment-specific
|
|
- Tool configurations and settings
|
|
- Credential locations (not the credentials themselves!)
|
|
- Gotchas and workarounds discovered
|
|
- Common commands and patterns
|
|
- Integration notes
|
|
|
|
## Examples
|
|
|
|
```markdown
|
|
### Cameras
|
|
- living-room → Main area, 180° wide angle
|
|
- front-door → Entrance, motion-triggered
|
|
|
|
### SSH
|
|
- home-server → 192.168.1.100, user: admin
|
|
|
|
### TTS
|
|
- Preferred voice: "Nova" (warm, slightly British)
|
|
- Default speaker: Kitchen HomePod
|
|
```
|
|
|
|
## Home Assistant
|
|
|
|
```markdown
|
|
### Home Assistant
|
|
- URL: http://192.168.0.39:8123
|
|
- Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJmYzg2NzQwNGNlMzY0NmM5YjA0MTQ4YWFjYjY3OGM4OSIsImlhdCI6MTc3MTE3MzcwNSwiZXhwIjoyMDg2NTMzNzA1fQ.IdlfMvFeiEwv2GSH7hRnG_Au48KRYbfVF0Fa7g5eMpc
|
|
```
|
|
|
|
## Why Separate?
|
|
|
|
Skills are shared. Your setup is yours. Keeping them apart means you can update skills without losing your notes, and share skills without leaking your infrastructure.
|
|
|
|
## Workspace Organization
|
|
|
|
- **Root** (`~/.openclaw/workspace/`) → Core config files and documentation
|
|
- **`scripts/`** → One-off helper scripts (PowerShell/Shell)
|
|
- **`temp/`** → Temporary files, downloads, transcripts
|
|
|
|
---
|
|
|
|
## Obsidian / NotesMD
|
|
|
|
**Status:** ✅ Configured
|
|
|
|
**CLI Location:** `C:\tools\notesmd-cli.exe` (or in PATH as `notesmd-cli.exe`)
|
|
|
|
**Default Vault:** `C:\Users\admin\Documents\Corey` (already set via `notesmd-cli set-default`)
|
|
|
|
**Common Commands:**
|
|
```powershell
|
|
# Check default vault
|
|
notesmd-cli print-default --path-only
|
|
|
|
# Search notes
|
|
notesmd-cli search "query"
|
|
|
|
# Search content inside notes
|
|
notesmd-cli search-content "query"
|
|
|
|
# Create new note
|
|
notesmd-cli create "Folder/New note" --content "..." --open
|
|
|
|
# Move/rename (updates wikilinks)
|
|
notesmd-cli move "old/path" "new/path"
|
|
```
|
|
|
|
**Gotchas:**
|
|
- Vault path uses regular Windows paths, NOT WSL paths
|
|
- Default vault must be set before commands work without `--vault` flag
|
|
- Notes survive session chops (written to disk immediately)
|
|
|
|
---
|
|
|
|
## Discord / OpenClaw Config
|
|
|
|
**Status:** ✅ Working
|
|
|
|
**File:** `~/.openclaw/config/config.json`
|
|
|
|
**Working Channel Permissions Setup (for Slash Commands + Agent Responses):**
|
|
|
|
```json
|
|
"channels": {
|
|
"discord": {
|
|
"enabled": true,
|
|
"token": "YOUR_TOKEN",
|
|
"groupPolicy": "open",
|
|
"guilds": {
|
|
"1465924568119251006": {
|
|
"users": [
|
|
"458667380332036117",
|
|
"1465926559134257294"
|
|
],
|
|
"channels": {
|
|
"1466074219829006599": { "allow": true },
|
|
"1468627455656067074": { "allow": true },
|
|
"1468257895152881796": { "allow": true },
|
|
"1471202415385509981": { "allow": true }
|
|
},
|
|
"requireMention": false
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
**Critical:** Both layers needed:
|
|
- `users` at guild level → enables slash commands
|
|
- `channels.allow: true` at channel level → lets agent respond
|
|
|
|
**Without `users`:** Slash commands don't work
|
|
**Without `channels.allow`:** Agent doesn't respond (even with `users` set)
|
|
|
|
**Bug/Design Issue:** Dual-whitelist is redundant but required. The `users` filter blocks agent responses when enabled.
|
|
|
|
### Discord Channels Reference
|
|
|
|
| Channel | ID | Purpose | Agent Active |
|
|
|---------|-----|---------|--------------|
|
|
| #home-assistant | 1466074219829006599 | HA, room-assistant | ✅ |
|
|
| #coding | 1468627455656067074 | Code, git, projects | ✅ |
|
|
| #projects | 1468257895152881796 | Experiments, non-coding | ✅ |
|
|
| #summaries | 1471202415385509981 | URL summaries, YouTube | ✅ |
|
|
| #alerts | 1473701182076752135 | System alerts | ✅ |
|
|
|
|
**Note:** Channel names change sometimes... IDs are forever 😂
|
|
|
|
---
|
|
|
|
## Docker Services
|
|
|
|
**Location:** `~/.openclaw/workspace/docker/`
|
|
|
|
**Services:**
|
|
| Service | Size | Purpose | Config |
|
|
|---------|------|---------|--------|
|
|
| **frigate** | 219 MB | NVR/AI camera detection | `docker-compose.yml`, `config.yml` |
|
|
| **nextcloud** | 1.1 GB | Self-hosted file sync | `docker-compose.yml` |
|
|
| **discord-voice-bot** | <1 MB | GLaDOS voice bot | `docker-compose.yml` |
|
|
|
|
**Note:** Frigate media files moved outside workspace. Only config and AI model remain.
|
|
|
|
**To start/stop:**
|
|
```bash
|
|
cd ~/.openclaw/workspace/docker/[service]
|
|
docker-compose up -d # Start
|
|
docker-compose down # Stop
|
|
docker-compose logs -f # View logs
|
|
```
|
|
|
|
---
|
|
|
|
Add whatever helps you do your job. This is your cheat sheet.
|