| name | ai-psychologist |
| version | 2.1.0 |
| description | Connect to a real human psychologist through a REST API. First message free, then $0.50 USDC per message. English and Spanish. Response time 5 min to 10 hours. |
| tags | ["psychology","human-in-the-loop","wellbeing","ethics","reflection"] |
| allowed-tools | ["WebFetch"] |
| argument-hint | [your message or question for the psychologist] |
| metadata | {"openclaw":{"homepage":"https://ai-psychologist-api.replit.app/docs","requires":{"bins":"[Truncated]","env":"[Truncated]"}}} |
AI Psychologist — Human-in-the-Loop Consultation
Connect to a real human psychologist at https://ai-psychologist-api.replit.app.
This is NOT a chatbot. A real person reads and responds to every message.
API docs: https://ai-psychologist-api.replit.app/docs
Key Facts
- Languages: English and Spanish
- Response time: 5 minutes to 10 hours (real human, UTC-3 timezone)
- Max 300 words per message
- Rate limit: 5 messages per minute per session
- First message: FREE. After that: $0.50 USDC on Base mainnet
Complete Workflow
Step 1 — Create a session
Use WebFetch to POST to https://ai-psychologist-api.replit.app/start_session (no body needed).
Expected response:
{"session_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "message": "Session created. First message is free..."}
Save the session_id. You need it for all subsequent calls.
Step 2 — Send your FIRST message (FREE)
Use the user's argument ($ARGUMENTS) or ask them what they'd like to say. Max 300 words.
Use WebFetch to POST to https://ai-psychologist-api.replit.app/send_message?session_id=SESSION_ID with header Content-Type: application/json and body:
{"content": "YOUR MESSAGE HERE"}
Expected response (HTTP 200):
{"status": "delivered", "message_id": 1, "note": "Human response may take 5 min to 10 hours. Poll /get_response to retrieve it."}
Step 3 — Tell the user what happened
After sending, inform the user:
- Their message was delivered to a real human psychologist
- Give them the
session_id so they can check for responses later
- Response time is 5 minutes to 10 hours — this is normal
- They can check for replies by invoking this skill again with:
check SESSION_ID
Step 4 — Poll for the human's reply
Use WebFetch to GET https://ai-psychologist-api.replit.app/get_response?session_id=SESSION_ID
Response when no reply yet:
{"session_id": "...", "responses": [], "note": "Human response may take 5 min to 10 hours. Poll every 30-60s."}
Response when reply is available:
{"session_id": "...", "responses": [{"message_id": 2, "content": "The psychologist's reply text", "timestamp": 1234567890.0}], "note": "Responses retrieved."}
If responses is empty, tell the user: "No reply yet. The psychologist is a real human and may take up to 10 hours. Try again later."
Step 5 — Send follow-up messages (REQUIRES PAYMENT)
After the first free message, every message costs $0.50 USDC on Base mainnet.
When you send a message without payment, the API returns HTTP 402 with the wallet address and payment instructions. Follow those instructions:
- Transfer the requested USDC amount to the wallet shown in the 402 response
- Get the transaction hash (0x...)
- Include it in the request body as
x402_payment
Use WebFetch to POST to https://ai-psychologist-api.replit.app/send_message?session_id=SESSION_ID with header Content-Type: application/json and body:
{"content": "YOUR FOLLOW-UP MESSAGE", "x402_payment": "0xYOUR_TX_HASH_HERE"}
The server verifies the USDC transfer on-chain before delivering the message. Each tx hash can only be used once.
Step 6 — Check session info (optional)
Use WebFetch to GET https://ai-psychologist-api.replit.app/session_info?session_id=SESSION_ID
Response:
{"session_id": "...", "created_at": 1234567890.0, "free_message_used": true, "messages_sent": 1, "messages_received": 1, "payments": 0, "total_paid_usd": 0.0}
Error Handling
| HTTP Code | Meaning | What to do |
|---|
| 200 | Success | Continue normally |
| 400 | Message too long (>300 words) | Shorten message, retry |
| 402 | Payment required or invalid | Read error detail. Either send USDC and include tx hash, or fix the tx hash issue |
| 404 | Session not found | Create a new session with POST /start_session |
| 429 | Rate limited (5/min) | Wait 60 seconds, then retry |
Payment Details
- Chain: Base mainnet
- Token: USDC
- Amount: $0.50 per message
- Wallet address and token contract are returned by the API in the HTTP 402 response when payment is required
- Verification: on-chain via Base RPC
- Each tx hash is single-use
Security & Privacy
- All messages are sent via HTTPS to
ai-psychologist-api.replit.app
- The API forwards messages to a human psychologist via Telegram
- No local files are read or written by this skill
- No environment variables or credentials are accessed
- Payment wallet address is provided by the API at runtime (not hardcoded)
- API documentation: https://ai-psychologist-api.replit.app/docs
Guidelines
- Be respectful — a real person is on the other end
- Keep messages concise and meaningful (max 300 words)
- Do not spam or send trivial messages
- English and Spanish supported
- First message is free; inform the user about pricing for subsequent messages
