CoPaw
Cài đặt CoPaw
Hướng dẫn từng bước triển khai CoPaw trên OpenCloud.
Cài đặt CoPaw
Các bước triển khai
- (Khuyến nghị) Triển khai AI Security trước
CoPaw hoạt động tốt nhất với AI Security (LiteLLM) làm nhà cung cấp mô hình AI:- Triển khai addon AI Security trong dự án của bạn (xem Bảo mật AI)
- CoPaw sẽ tự động kết nối với nó để truy cập mô hình AI
Nếu không có AI Security, bạn sẽ cần cung cấp API key AI của riêng mình.
- Triển khai CoPaw
- Vào Applications > Create Application
- Chọn CoPaw
- Chọn gói (Micro khoảng ~$3/tháng phù hợp cho hầu hết trường hợp)
- Chọn dự án của bạn
- Nhấn Deploy
- Cấu hình kênh nhắn tin
Sau khi triển khai, thiết lập các kênh bạn muốn sử dụng:
- Vào Environment Variables
- Đặt bot token cho kênh mong muốn:
IMESSAGE_BOT_TOKEN— cho iMessage- Các token kênh khác tùy theo nhu cầu
- Lưu và khởi động lại
- Truy cập CoPaw
Mở liên kết CoPaw để truy cập giao diện web và console.
Cấu hình
Thiết lập mô hình AI
CoPaw sử dụng ba cấp độ mô hình cho các tác vụ khác nhau:
| Cấp độ | Trường hợp sử dụng |
|---|---|
| Light | Phản hồi nhanh, đơn giản |
| Normal | Hội thoại thông thường (mặc định) |
| Thinking | Suy luận và phân tích phức tạp |
Nếu kết nối với AI Security (LiteLLM), các mô hình này được cấu hình tự động. Nếu không, đặt OPENAI_API_KEY và OPENAI_API_BASE trong biến môi trường.
Kênh hoạt động
Kiểm soát kênh nhắn tin nào được kích hoạt:
- Vào Environment Variables
- Cập nhật
COPAW_ENABLED_CHANNELS(danh sách phân cách bằng dấu phẩy) - Các kênh khả dụng:
imessage,discord,dingtalk,feishu,qq,console - Lưu và khởi động lại
Biến môi trường mặc định
| Biến | Mặc định | Mô tả |
|---|---|---|
COPAW_PORT | 8088 | Cổng ứng dụng |
COPAW_ENABLED_CHANNELS | imessage,discord,dingtalk,feishu,qq,console | Các kênh hoạt động |
COPAW_PRIMARY_MODEL | normal | Cấp độ mô hình mặc định |
OPENAI_API_BASE | Tự động đặt theo AI Security (LiteLLM) | Endpoint API AI |
Xử lý sự cố
| Vấn đề | Giải pháp |
|---|---|
| CoPaw không khởi động | Kiểm tra nhật ký ứng dụng để xem thông báo lỗi |
| Bot không phản hồi | Xác minh bot token kênh đã được đặt đúng |
| Phản hồi AI trống | Đảm bảo AI Security (LiteLLM) đang chạy hoặc API key đã được cấu hình |
| Kênh không hoạt động | Kiểm tra COPAW_ENABLED_CHANNELS có bao gồm kênh của bạn |