openclaw/ai-psychologist

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:

1. Their message was delivered to a real human psychologist
2. Give them the session_id so they can check for responses later
3. Response time is 5 minutes to 10 hours — this is normal
4. 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:

1. Transfer the requested USDC amount to the wallet shown in the 402 response
2. Get the transaction hash (0x...)
3. 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