openclaw - 💡(How to fix) Fix Feature request: per-bot credit monitoring URL + low-credit alerts [1 participants]

Fix Plan

To address the issue, we will implement the following:

• Create a credit/usage monitoring URL
• Set up low-credit alerts
• Implement graceful degradation for out-of-credits scenarios

Step-by-Step Solution

1. Credit/Usage Monitoring URL

• Create a new API endpoint (e.g., GET /pika.me/<username>/usage) to display remaining credits, usage history, and current billing period.
• Example API response:

{
  "remaining_credits": 100,
  "usage_history": [
    {"provider": "Provider A", "usage": 50},
    {"provider": "Provider B", "usage": 20}
  ],
  "billing_period": "2024-09-01 - 2024-09-30"
}

2. Low-Credit Alerts

• Introduce a configurable threshold for low-credit alerts (e.g., 20 credits).
• Set up webhook callbacks, email/Slack/Discord notifications, and optional in-bot warnings when credits drop below the threshold.
• Example notification code:

import requests

def send_low_credit_notification(username, credits):
    threshold = 20
    if credits <= threshold:
        # Send webhook callback
        requests.post("https://example.com/webhook", json={"username": username, "credits": credits})
        # Send email/Slack/Discord notification
        # ...

3. Graceful Degradation

• Modify the bot to send a message explaining the out-of-credits situation when it runs out of credits.
• Example code:

def handle_out_of_credits(username):
    message = "Heads up, I'm running low on credits! Please refill my credits to continue using me."
    # Send message to user
    # ...

Verification

To verify the fix, test the following scenarios:

• Check the credit/usage monitoring URL for accurate information.
• Trigger low-credit alerts by reducing credits below the threshold.
• Test the bot's graceful degradation by running out of credits and verifying the explanatory message is sent.

Extra Tips

• Regularly review and update the credit/usage monitoring URL to ensure accuracy.
• Consider implementing automated credit refills or notifications for bot owners.
• Document the new features and updates for bot owners and users.