CoPaw
CoPaw Installation
Step-by-step guide to deploying CoPaw on OpenCloud.
Install CoPaw
Step-by-step deployment
- (Recommended) Deploy AI Security first
CoPaw works best with AI Security (LiteLLM) as its AI model provider:- Deploy the AI Security addon in your project (see AI Security)
- CoPaw will automatically connect to it for AI model access
Without AI Security, you'll need to provide your own AI API keys directly.
- Deploy CoPaw
- Go to Applications > Create Application
- Select CoPaw
- Choose a plan (Micro at ~$3/month works for most use cases)
- Select your project
- Click Deploy
- Configure messaging channels
After deployment, set up the channels you want to use:
- Go to Environment Variables
- Set the bot token for your desired channel(s):
IMESSAGE_BOT_TOKEN— for iMessage- Other channel-specific tokens as needed
- Save and restart
- Access CoPaw
Open the CoPaw link to access the web interface and console.
Configuration
AI model setup
CoPaw uses three model levels for different tasks:
| Level | Use case |
|---|---|
| Light | Quick, simple responses |
| Normal | Standard conversations (default) |
| Thinking | Complex reasoning and analysis |
If connected to AI Security (LiteLLM), these models are automatically configured. Otherwise, set OPENAI_API_KEY and OPENAI_API_BASE in your environment variables.
Enabled channels
Control which messaging channels are active:
- Go to Environment Variables
- Update
COPAW_ENABLED_CHANNELS(comma-separated list) - Available channels:
imessage,discord,dingtalk,feishu,qq,console - Save and restart
Default environment variables
| Variable | Default | Description |
|---|---|---|
COPAW_PORT | 8088 | Application port |
COPAW_ENABLED_CHANNELS | imessage,discord,dingtalk,feishu,qq,console | Active channels |
COPAW_PRIMARY_MODEL | normal | Default model level |
OPENAI_API_BASE | Auto-set to AI Security (LiteLLM) | AI API endpoint |
Troubleshooting
| Problem | Solution |
|---|---|
| CoPaw won't start | Check application logs for error messages |
| Bot doesn't respond | Verify the channel bot token is set correctly |
| AI responses are empty | Ensure AI Security (LiteLLM) is running or API keys are configured |
| Channel not working | Check COPAW_ENABLED_CHANNELS includes your channel |