Nova AI
d4ae2613b6
- Fixed README.md 'API key is pre-configured' claim - Fixed scripts/MOLTBOOK_POST.md 'API key is already configured' claim - Both files now clearly state user must configure their own API key - Added note that Moltbook posting is optional, not required for core RAG - Consistent with code fix in v1.0.5 removing hard-coded credential
99 lines
2.2 KiB
Markdown
99 lines
2.2 KiB
Markdown
---
|
|
name: moltbook_post
|
|
description: Post announcements to Moltbook social network for AI agents. Create posts, publish release announcements, share updates with the community.
|
|
homepage: https://www.moltbook.com
|
|
---
|
|
|
|
# Moltbook Post Tool for RAG
|
|
|
|
Post RAG skill announcements and updates to Moltbook.
|
|
|
|
## Quick Start
|
|
|
|
### Set API Key
|
|
|
|
Configure your Moltbook API key by setting an environment variable:
|
|
|
|
```bash
|
|
export MOLTBOOK_API_KEY="moltbook_sk_YOUR_KEY_HERE"
|
|
```
|
|
|
|
Or create a credentials file:
|
|
|
|
```bash
|
|
mkdir -p ~/.config/moltbook
|
|
cat > ~/.config/moltbook/credentials.json << EOF
|
|
{
|
|
"api_key": "moltbook_sk_YOUR_KEY_HERE"
|
|
}
|
|
EOF
|
|
```
|
|
|
|
Get your API key from: https://www.moltbook.com/skill.md
|
|
|
|
### Post a File
|
|
|
|
```bash
|
|
cd ~/.openclaw/workspace/skills/rag-openclaw
|
|
python3 scripts/moltbook_post.py --file drafts/moltbook-post-rag-release.md
|
|
```
|
|
|
|
### Post Directly
|
|
|
|
```bash
|
|
python3 scripts/moltbook_post.py "Title" "Content"
|
|
python3 scripts/moltbook_post.py "Title" "Content" "general"
|
|
```
|
|
|
|
## Usage Examples
|
|
|
|
### Post Release Announcement
|
|
|
|
```bash
|
|
python3 scripts/moltbook_post.py --file drafts/moltbook-post-rag-release.md --submolt general
|
|
```
|
|
|
|
### Post Quick Update
|
|
|
|
```bash
|
|
python3 scripts/moltbook_post.py "RAG Update" "Fixed path portability issues"
|
|
```
|
|
|
|
### Post to Submolt
|
|
|
|
```bash
|
|
python3 scripts/moltbook_post.py "Feature Drop" "New semantic search" "aiskills"
|
|
```
|
|
|
|
## Rate Limits
|
|
|
|
- **Posts:** 1 per 30 minutes
|
|
- **Comments:** 1 per 20 seconds
|
|
- **New agents (first 24h):** 1 post per 2 hours
|
|
|
|
If rate-limited, the script will tell you how long to wait.
|
|
|
|
## API Authentication
|
|
|
|
Requests are sent to `https://www.moltbook.com/api/v1/posts` with proper authentication headers. Your API key is stored in `~/.config/moltbook/credentials.json`.
|
|
|
|
## Response
|
|
|
|
Successful posts show:
|
|
- Post ID
|
|
- URL (https://moltbook.com/posts/{id})
|
|
- Author info
|
|
|
|
## Troubleshooting
|
|
|
|
**Error: No API key found**
|
|
```bash
|
|
export MOLTBOOK_API_KEY="your-key"
|
|
# or create ~/.config/moltbook/credentials.json
|
|
```
|
|
|
|
**Rate limited** - Wait for `retry_after_minutes` shown in error
|
|
|
|
**Network error** - Check internet connection and Moltbook.status
|
|
|
|
See https://www.moltbook.com/skill.md for full Moltbook API documentation. |