القائمة
Send WhatsApp messages through NanoClaw's IPC. Use when an agent needs to notify the human via WhatsApp about completed work, failures, decisions needed, or status updates.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Complete reference for the factory CLI — all commands, arguments, options, and usage. Use when an agent needs to invoke factory commands, check correct syntax, or understand available options.
When and how to write a human-action-needed entry to memory/{agent}/needs.md. Agents write these entries when they hit blockers that only a human can resolve.
When you encounter a failure, correction, or new pattern, write a learning and optionally propose a skill.
How the factory workspace is organized and what each directory means.
What to examine during a reflection pass and how to write observations to memory/{agent}/needs.md.
When and how to write scenario holdouts for factory verification.
| name | nanoclaw-whatsapp |
| description | Send WhatsApp messages through NanoClaw's IPC. Use when an agent needs to notify the human via WhatsApp about completed work, failures, decisions needed, or status updates. |
NanoClaw watches a filesystem directory for JSON message files. Write a .json file to NanoClaw's IPC messages directory, and NanoClaw picks it up within 1 second and sends it via WhatsApp.
Write to the notifications/ directory in the Factory workspace. This is a symlink to NanoClaw's IPC:
notifications/
Write a JSON file with a unique name (timestamp + random suffix recommended):
{
"type": "message",
"chatJid": "855718665780@s.whatsapp.net",
"text": "Your message content here"
}
type must be "message"chatJid is the WhatsApp chat to send to (the self-chat JID above is the human's main channel)text is the message body (plain text, WhatsApp formatting supported: bold, italic, code)Use this pattern to avoid collisions:
{timestamp}-{agent}-{brief}.json
Example: 1740470400000-verifier-spec-passed.json
Use judgement. Not every action needs a WhatsApp message. Good reasons to notify:
Do NOT notify for routine heartbeat activity, daily log entries, or minor internal state changes.
Keep messages brief and actionable. The human reads these on a phone.
Good:
Spec "multi-cli-backend-support" verified. 4/4 scenarios pass. Ready for deployment.
Bad:
Hello! I wanted to let you know that I have completed the verification process for the specification titled "multi-cli-backend-support". The verification involved running 4 scenarios, all of which passed successfully. The work is now ready for the next stage of the pipeline.
cat > notifications/$(date +%s%3N)-operator-health.json << 'EOF'
{
"type": "message",
"chatJid": "855718665780@s.whatsapp.net",
"text": "Health alert: git-commit-viewer API returning 503 for 2 consecutive checks. Maintenance task created."
}
EOF
Only agents with write access to the NanoClaw IPC path can send messages. The NanoClaw IPC watcher validates that messages originate from the main group directory (which has unrestricted send permissions).