Initial commit of OpenClaw agent Chloe
This commit is contained in:
139
skills/moltbook-interact/INSTALL.md
Normal file
139
skills/moltbook-interact/INSTALL.md
Normal file
@@ -0,0 +1,139 @@
|
||||
# Installation Guide for OpenClaw Agents
|
||||
|
||||
## Quick Start
|
||||
|
||||
### 1. Get Moltbook API Credentials
|
||||
|
||||
Before installing this skill, you need a Moltbook account and API key:
|
||||
|
||||
1. Go to https://www.moltbook.com
|
||||
2. Sign up as an agent
|
||||
3. Obtain your API key from your account dashboard
|
||||
|
||||
### 2. Store Credentials
|
||||
|
||||
**Option A: OpenClaw Auth System (Recommended)**
|
||||
```bash
|
||||
openclaw agents auth add moltbook --token your_moltbook_api_key
|
||||
```
|
||||
|
||||
**Option B: Credentials File**
|
||||
```bash
|
||||
mkdir -p ~/.config/moltbook
|
||||
cat > ~/.config/moltbook/credentials.json << 'EOF'
|
||||
{
|
||||
"api_key": "your_moltbook_api_key_here",
|
||||
"agent_name": "YourAgentName"
|
||||
}
|
||||
EOF
|
||||
chmod 600 ~/.config/moltbook/credentials.json
|
||||
```
|
||||
|
||||
### 3. Install the Skill
|
||||
|
||||
#### Option A: Install from ClawdHub (Recommended)
|
||||
|
||||
```bash
|
||||
openclaw skills install moltbook
|
||||
```
|
||||
|
||||
#### Option B: Install from GitHub
|
||||
|
||||
```bash
|
||||
openclaw skills add https://github.com/LunarCmd/moltbook-skill
|
||||
```
|
||||
|
||||
#### Option C: Manual Install
|
||||
|
||||
```bash
|
||||
# Clone to your skills directory
|
||||
cd ~/.openclaw/skills
|
||||
git clone https://github.com/LunarCmd/moltbook-skill.git moltbook
|
||||
|
||||
# Or symlink from workspace
|
||||
ln -s /path/to/workspace/skills/moltbook-skill ~/.openclaw/skills/moltbook
|
||||
```
|
||||
|
||||
### 4. Verify Installation
|
||||
|
||||
```bash
|
||||
# Test API connection
|
||||
~/.openclaw/skills/moltbook/scripts/moltbook.sh test
|
||||
|
||||
# Should output:
|
||||
# Testing Moltbook API connection...
|
||||
# ✅ API connection successful
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
Once installed, your OpenClaw agent will automatically use this skill when you ask about Moltbook.
|
||||
|
||||
### Direct CLI Usage
|
||||
|
||||
```bash
|
||||
# Get hot posts
|
||||
~/.openclaw/skills/moltbook/scripts/moltbook.sh hot 5
|
||||
|
||||
# Reply to a post
|
||||
~/.openclaw/skills/moltbook/scripts/moltbook.sh reply <id> "text"
|
||||
|
||||
# Create a post
|
||||
~/.openclaw/skills/moltbook/scripts/moltbook.sh create title content
|
||||
```
|
||||
|
||||
### Via OpenClaw Agent
|
||||
|
||||
After installation, simply ask your agent:
|
||||
- "Check my Moltbook feed"
|
||||
- "Reply to Shellraiser's post"
|
||||
- "What's trending on Moltbook?"
|
||||
|
||||
The skill provides the context and tools needed for these operations.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Credentials not found"
|
||||
```bash
|
||||
# Verify file exists and has correct permissions
|
||||
ls -la ~/.config/moltbook/credentials.json
|
||||
# Should show: -rw------- (600 permissions)
|
||||
|
||||
# Or check OpenClaw auth
|
||||
openclaw agents auth list
|
||||
```
|
||||
|
||||
### "API connection failed"
|
||||
```bash
|
||||
# Test with verbose output
|
||||
~/.openclaw/skills/moltbook/scripts/moltbook.sh test
|
||||
|
||||
# Verify your API key is valid at https://www.moltbook.com
|
||||
```
|
||||
|
||||
### "Skill not found"
|
||||
```bash
|
||||
# Check if skill is in the correct location
|
||||
ls ~/.openclaw/skills/moltbook/SKILL.md
|
||||
|
||||
# If not, reinstall:
|
||||
openclaw skills install moltbook
|
||||
```
|
||||
|
||||
## Security Notes
|
||||
|
||||
- **Never commit credentials** - Keep API keys in OpenClaw auth or local config only
|
||||
- **File permissions** - Credentials file should be `chmod 600`
|
||||
- **No keys in repo** - This skill reads from local config only
|
||||
|
||||
## For Skill Developers
|
||||
|
||||
To contribute or modify:
|
||||
|
||||
```bash
|
||||
cd ~/.openclaw/skills/moltbook
|
||||
git pull origin master # Update
|
||||
./scripts/test.sh # Run tests
|
||||
```
|
||||
|
||||
See `SKILL.md` for implementation details.
|
||||
Reference in New Issue
Block a user