balia-sns-x Skill Cassette v1.0.0.1

Version: 1.0.0.1 Price: $9.8 (one-time) Compatible with: BALIA OS T1 or higher

---

⬇️ Download

📦 balia-sns-x v1.0.0.1 Download

Extract the ZIP and double-click install.bat to install automatically

🚀 Quick Start

Step 1 — Download and unzip

Click the download button above. Unzip the file anywhere you like.

Step 2 — Run the installer

Double-click install.bat inside the unzipped folder. This places the skill files in the correct location automatically.

⚠️ If Windows SmartScreen appears, click "More info" → "Run anyway"

✅ Files are automatically placed in C:\\Users\\[username]\\.opengoat\\skills\\balia-sns-x\\

Step 3 — Set up via VS Code + Claude

Open VS Code with the Claude Code extension. Paste the following prompt and send it:

▶ Paste this to start setup

Please start the balia-sns-x setup.

Security Guardian will start and ask you the following:

1. Agent name to handle this cassette (e.g., Maya, Oscar)
2. Main posting topics (e.g., AI tech, trading results, dev journal)
3. Whether you have an X account
   • Yes → Paste 3–5 of your recent posts (style and tone are learned automatically)
   • No → Generated automatically from your topics
4. Posting frequency (daily / 3x per week / irregular)

💡 If anything goes wrong, copy the report and paste it into Claude chat (claude.ai) — Claude will walk you through the fix.

Step 4 — Confirm your posting style and finish

After the hearing, Security Guardian will show a draft of your posting style. Review it and say "OK" or share any changes. Once you confirm OK, setup is complete.

Your agent is ready. Start with the command below:

openclaw agent --agent [your-agent] --message "Create an X post about the latest AI trends" --deliver

---

✨ What This Skill Does

balia-sns-x lets you define what your AI agent does — and then it does it automatically, every day.

You configure the agent's behavior by editing its settings: what to research, what tone to write in, and when to post. Once set, the agent runs on its own.

What the agent does automatically:

• 🔍 Researches X (Twitter) trends relevant to your topic (xAI x_search)
• ✍️ Generates post content (800–1,000 characters) using the PAS method
• 📨 Reports the draft post to Discord for your review
• 🤖 Posts to X automatically (Manual mode: you approve / Auto mode: fully autonomous)

The key difference from balia-sns-x-pro: balia-sns-x includes AI image generation via xAI Grok. For higher quality image generation (GPT-image-2), use balia-sns-x-pro.

How to customize what the agent does: Edit the agent's SPEC file (skills/balia-sns-x/SPEC_{AgentName}.md) to change:

• Research topic / keywords
• Writing style and tone
• Posting schedule

Cost

Process	Model	Cost
X trend research	xAI x_search	~$0.005
Content generation	Your LLM (varies by model)	~$0.001
Image generation (1 image)	grok-imagine-image-quality	$0.07
Total		~$0.076 / post

Monthly estimate (30 posts): ~$2.3

Requirements

• BALIA OS installed (T1 or higher)
• XAI_API_KEY set in your .env file
• X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET set in your .env file
• X Developer API access (pay-per-use plan)
• DISCORD_WEBHOOK_[YOUR_AGENT] set in your .env file

---

Setup

Prerequisites

Before setup, make sure the following are ready:

• BALIA OS installed and Gateway running
• XAI_API_KEY set in your .env file (console.x.ai)
• X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET set in your .env file (developer.x.com)
• DISCORD_WEBHOOK_[YOUR_AGENT] set in your .env file

Step 1 — Start the Gateway

$env:DEBUG="-ciao*"; openclaw gateway --force

Step 2 — Set up via Security Guardian

▶ Paste this into Claude in VS Code

Please start the balia-sns-x setup.

Security Guardian will ask you the following and configure everything automatically:

• Agent name
• Main posting topics
• Whether you have an X account (if yes, paste 3–5 past posts to learn your style automatically)
• Posting frequency

After the hearing, a draft of your posting style will appear. Say "OK" or share any changes to finalize the configuration.

Step 3 — Verify

After Security Guardian completes, confirm the following:

• _SKILL_STATUS.md: STATUS: ON
• POST_MODE: MANUAL (default) or POST_MODE: AUTO

---

How to Use

Basic command

openclaw agent --agent [your-agent] --message "Create an X post about the latest AI trends" --deliver

Specifying a topic

openclaw agent --agent [your-agent] --message "Create an X post about Bitcoin's latest movement" --deliver

Output Location

Posts and images are saved to:

workspaces/[your-agent]/x-post/

Discord report includes:

• Post text (800–1,000 characters)
• Generated image attached
• Hashtags included

---

X Posting

POST_MODE settings

Open skills/balia-sns-x/_SKILL_STATUS.md and set your preferred mode:

STATUS: ON
POST_MODE: MANUAL

Mode	Behavior
MANUAL (default, recommended)	Agent reports to Discord → you react with ✅ → agent posts to X automatically
AUTO	Agent reports to Discord and posts to X at the same time

💡 We recommend starting with MANUAL mode until your agent learns your posting style.

MANUAL mode flow

1. Send a post request to your X agent
2. Agent researches trends, writes content, generates image
3. Agent reports post + image to Discord
4. You review and react with ✅ to approve
5. Agent automatically posts to X
6. Agent reports the tweet URL to Discord

AUTO mode flow

1. Send a post request to your X agent
2. Agent researches trends, writes content, generates image
3. Agent posts to X and reports the tweet URL to Discord simultaneously

About posting style

During setup, if you have an existing X account, your style and tone are automatically learned from your past posts and reflected in soul.md.

To change your style after setup, edit the following:

• Posting style: skills/balia-sns-x/{AgentName}-soul.md
• Topics and frequency: skills/balia-sns-x/SPEC_{AgentName}.md

After editing, tell Claude in VS Code: "I updated soul.md for balia-sns-x. Please apply the changes."

---

Troubleshooting

Problem	Solution
401 error on image generation	Check XAI_API_KEY in your .env file
Image generated by Google instead of Grok	Always specify model=xai/grok-imagine-image-quality explicitly
X post 401 error	Check X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET in your .env file
X post 403 error	Check posting permissions in the X Developer Portal; duplicate post content is not allowed
Discord 403 error	Add User-Agent: GALLERIA-OS/2.0 header to all webhook requests
Discord 400 error	Check DISCORD_WEBHOOK_[YOUR_AGENT] value in your .env file
x_search returns no results	Check X Developer API access and credit balance

Support

For support, contact support@balia-os.com