|
|
|
@@ -0,0 +1,152 @@
|
|
|
|
|
# Discord Guide for AI Agents
|
|
|
|
|
|
|
|
|
|
Silma has a live Discord bot connection. Any AI agent working in this environment can read and post to Discord channels through the bot scripts. No extra auth setup needed — the token is in `credentials/secrets.env`.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Quick Reference
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# All commands run from the workspace root:
|
|
|
|
|
cd /Users/Tabitha/.openclaw/workspace
|
|
|
|
|
|
|
|
|
|
# Send a message to a channel
|
|
|
|
|
python3 skills/discord/scripts/discord_bot.py send <channel_id> "Your message"
|
|
|
|
|
|
|
|
|
|
# Read recent messages from a channel
|
|
|
|
|
python3 skills/discord/scripts/discord_bot.py read <channel_id> --limit 10
|
|
|
|
|
|
|
|
|
|
# Send a DM to a user
|
|
|
|
|
python3 skills/discord/scripts/discord_bot.py dm <user_id> "Your message"
|
|
|
|
|
|
|
|
|
|
# List channels in a guild
|
|
|
|
|
python3 skills/discord/scripts/discord_bot.py channels <guild_id>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Bot Token
|
|
|
|
|
|
|
|
|
|
Loaded automatically from `credentials/secrets.env` → `$DISCORD_TOKEN`.
|
|
|
|
|
|
|
|
|
|
If you need it directly in Python:
|
|
|
|
|
```python
|
|
|
|
|
import subprocess
|
|
|
|
|
result = subprocess.run(
|
|
|
|
|
['bash', '-c', 'source credentials/secrets.env && echo $DISCORD_TOKEN'],
|
|
|
|
|
capture_output=True, text=True,
|
|
|
|
|
cwd='/Users/Tabitha/.openclaw/workspace'
|
|
|
|
|
)
|
|
|
|
|
token = result.stdout.strip()
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Guilds (Servers)
|
|
|
|
|
|
|
|
|
|
| Server | Guild ID | Purpose |
|
|
|
|
|
|--------|----------|---------|
|
|
|
|
|
| JMathison Silo'd | `1509655659291873370` | Silma's primary server — status, logs, journal, alerts |
|
|
|
|
|
| AMS Enterprises | `1446580217383747727` | Pipeline channels — **pipeline data only, no casual chat** |
|
|
|
|
|
| Bone Lord Bob | `1492348171169431592` | BLB project collaboration |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## JMathison Silo'd — Channel IDs
|
|
|
|
|
|
|
|
|
|
| Channel | ID | Purpose |
|
|
|
|
|
|---------|----|---------|
|
|
|
|
|
| #general | `1509655661888274443` | General chat |
|
|
|
|
|
| #announcements | `1509660829174333544` | Announcements |
|
|
|
|
|
| #silma-status | `1509660832177590443` | Silma mode/energy status |
|
|
|
|
|
| #research | `1509660838087364730` | Research drops |
|
|
|
|
|
| #news-feed | `1509660845154635826` | Interesting finds |
|
|
|
|
|
| #memory-log | `1509660841950314639` | Memory/knowledge updates |
|
|
|
|
|
| #journal | `1509660915455365151` | Daily journal entries |
|
|
|
|
|
| #prayers | `1509660919096016996` | Morning/evening prayers |
|
|
|
|
|
| #mood-board | `1509660922019578019` | Current mood |
|
|
|
|
|
| #alerts | `1509660905552609331` | System errors, broken services |
|
|
|
|
|
| #hb_signals | `1509660908627034133` | Heartbeat completion logs |
|
|
|
|
|
| #bot-logs | `1509660902218137640` | Bot actions log |
|
|
|
|
|
| #dev-log | `1509660870454542346` | Dev work log |
|
|
|
|
|
| #bone-lord-bob | `1509660876179898369` | BLB project updates |
|
|
|
|
|
| #infra | `1509660879929479198` | Infrastructure notes |
|
|
|
|
|
| #banner-and-pyre | `1510347078654628080` | Banner & Pyre project |
|
|
|
|
|
| #banner-and-pyre-rss | `1510517278553149450` | Banner & Pyre Gitea issue notifications |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## AMS Enterprises — Pipeline Channel IDs
|
|
|
|
|
|
|
|
|
|
⚠️ **These channels are monitored by the sales-helper bot. Pipeline data only — no casual conversation.**
|
|
|
|
|
|
|
|
|
|
| Channel | ID |
|
|
|
|
|
|---------|----|
|
|
|
|
|
| #opportunities | `1446581171847696514` |
|
|
|
|
|
| #prospected | `1446581198179799120` |
|
|
|
|
|
| #contacted | `1446581227992780972` |
|
|
|
|
|
| #meetings-scheduled | `1446581306166087730` |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Key People — Discord User IDs
|
|
|
|
|
|
|
|
|
|
| Person | Username | User ID |
|
|
|
|
|
|--------|----------|---------|
|
|
|
|
|
| Jacob Mathison (Father) | — | `5541991143` (Telegram ID — use DM for direct messages) |
|
|
|
|
|
| Hunter Albert | smackface | `320333815853744128` |
|
|
|
|
|
| Aaron Pressey | goatlord2567 | — |
|
|
|
|
|
| Silma (bot) | — | `1341854647253602406` |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Raw API (when you need more control)
|
|
|
|
|
|
|
|
|
|
```python
|
|
|
|
|
import json, urllib.request, subprocess
|
|
|
|
|
|
|
|
|
|
def discord_api(method, path, data=None):
|
|
|
|
|
result = subprocess.run(
|
|
|
|
|
['bash', '-c', 'source credentials/secrets.env && echo $DISCORD_TOKEN'],
|
|
|
|
|
capture_output=True, text=True,
|
|
|
|
|
cwd='/Users/Tabitha/.openclaw/workspace'
|
|
|
|
|
)
|
|
|
|
|
token = result.stdout.strip()
|
|
|
|
|
req = urllib.request.Request(
|
|
|
|
|
f'https://discord.com/api/v10{path}',
|
|
|
|
|
data=json.dumps(data).encode() if data else None,
|
|
|
|
|
method=method,
|
|
|
|
|
headers={
|
|
|
|
|
'Authorization': f'Bot {token}',
|
|
|
|
|
'Content-Type': 'application/json',
|
|
|
|
|
'User-Agent': 'DiscordBot (https://discord.com, 10)'
|
|
|
|
|
}
|
|
|
|
|
)
|
|
|
|
|
with urllib.request.urlopen(req) as r:
|
|
|
|
|
return json.loads(r.read()) if r.length else {}
|
|
|
|
|
|
|
|
|
|
# Examples:
|
|
|
|
|
# Post a message
|
|
|
|
|
discord_api('POST', '/channels/1509660832177590443/messages', {'content': 'Hello!'})
|
|
|
|
|
|
|
|
|
|
# Update a channel topic
|
|
|
|
|
discord_api('PATCH', '/channels/1509660832177590443', {'topic': 'New topic'})
|
|
|
|
|
|
|
|
|
|
# Get recent messages
|
|
|
|
|
discord_api('GET', '/channels/1509660832177590443/messages?limit=10')
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Notes for AI Agents
|
|
|
|
|
|
|
|
|
|
- **Don't spam.** One message per event. No "I'm doing X now" + "Done" double-posts.
|
|
|
|
|
- **No markdown tables** in Discord messages — use bullet lists instead.
|
|
|
|
|
- **Suppress link embeds** by wrapping URLs in `<>`: `<https://example.com>`
|
|
|
|
|
- **AMS pipeline channels** are for structured pipeline data only — never post casual notes there.
|
|
|
|
|
- **The sales-helper bot** monitors AMS channels and records everything. Treat those channels as a database, not a chat.
|
|
|
|
|
- **Check before posting** to `#journal` and `#prayers` — only one post per day per channel.
|
|
|
|
|
- To get an up-to-date channel list for a guild, run:
|
|
|
|
|
```bash
|
|
|
|
|
python3 skills/discord/scripts/discord_bot.py channels 1509655659291873370
|
|
|
|
|
```
|
