Copaw Env Config
CoPaw 环境变量与运行配置
环境变量和运行配置是 CoPaw 高级使用的重要组成部分。通过合理配置，可以优化性能、增强安全性、扩展功能。
环境变量
什么是环境变量？
环境变量是存储配置信息的方式，CoPaw 通过环境变量读取外部配置。
为什么使用环境变量？
- 安全性：避免在代码中暴露敏感信息
- 灵活性：不同环境使用不同配置
- 可移植性：配置独立于代码
管理环境变量
通过控制台
- 进入控制台 设置 → 环境变量
- 添加变量：
- 点击 + 添加变量
- 输入变量名和值
- 点击保存
- 编辑变量：
- 修改 Value 字段
- 点击保存
- 删除变量：
- 点击行右侧的 🗑 图标
- 确认删除
- 批量删除：
- 勾选要删除的行
- 点击删除
通过文件
创建 .env
文件：
# API 密钥
OPENAI_API_KEY=sk-xxxxxxxx
DASHSCOPE_API_KEY=sk-xxxxxxxx
数据库配置
DB_HOST=localhost
DB_PORT=5432
DB_NAME=myapp
DB_USER=admin
DB_PASSWORD=your-password
常用环境变量
API 密钥
# OpenAI
OPENAI_API_KEY=sk-xxxxxxxx
DashScope（阿里云）
DASHSCOPE_API_KEY=sk-xxxxxxxx
ModelScope
MODELSCOPE_API_KEY=xxxxxxxx
数据库配置
DB_HOST=localhost
DB_PORT=5432
DB_NAME=myapp
DB_USER=admin
DB_PASSWORD=your-password
邮件配置
EMAIL_HOST=smtp.example.com
EMAIL_PORT=587
EMAIL_USER=user@example.com
EMAIL_PASSWORD=email-password
服务配置
COPAW_HOST=0.0.0.0
COPAW_PORT=8088
LOG_LEVEL=info
代理配置
HTTP_PROXY=http://proxy.example.com:8080
HTTPS_PROXY=http://proxy.example.com:8080
NO_PROXY=localhost,127.0.0.1
运行配置
运行配置影响 CoPaw 的行为和性能。
最大迭代次数
作用
：控制 CoPaw 在执行复杂任务时的最大循环次数
配置建议
：
- 简单任务：5-10
- 复杂任务：15-20
- 高性能服务器：20-30
配置方法
：
- 进入控制台 智能体 → 运行配置
- 修改 最大迭代次数
- 点击保存
最大输入长度
作用
：限制单次对话的最大输入长度
配置建议
：
- 简单对话：4096-8192
- 长文档处理：16384-32768
- 高性能模型：32768-65536
配置方法
：
- 进入控制台 智能体 → 运行配置
- 修改 最大输入长度
- 点击保存
配置文件
CoPaw 的主配置文件位于 ~/.copaw/config.json
。
示例
：
{
"version": "1.0.0",
"server": {
"host": "0.0.0.0",
"port": 8088
},
"agent": {
"model_provider": "dashscope",
"model_name": "qwen3.5-plus",
"max_iterations": 10,
"max_input_length": 8192
},
"skills": {
"enabled": [
"cron",
"pdf",
"docx",
"news"
]
}
}
配置优先级
优先级从高到低：
- 环境变量
- config.json
- 默认值
安全配置
API 密钥管理
最佳实践
：
- 使用环境变量存储 API 密钥
- 避免在代码中硬编码
- 定期更新密钥
- 使用密钥管理服务（如 AWS Secrets Manager）
敏感信息保护
不要记录
：
- API 密钥
- 数据库密码
- 私钥和证书
权限控制
# 设置配置文件权限
chmod 600 ~/.copaw/config.json
设置环境变量文件权限
chmod 600 .env
性能优化
资源限制
# CPU 限制
nice -n 10 copaw app
内存限制
ulimit -v 2097152
缓存配置
COPAW_CACHE_DIR=/var/cache/copaw
COPAW_CACHE_SIZE=1G
COPAW_CACHE_TTL=3600
并发配置
COPAW_MAX_CONCURRENT=10
COPAW_MAX_CONNECTIONS=100
监控和日志
日志配置
# 日志级别
LOG_LEVEL=debug
日志文件
LOG_FILE=/var/log/copaw.log
日志轮转
LOG_MAX_SIZE=100M
LOG_MAX_FILES=10
性能监控
# 启用监控
COPAW_ENABLE_MONITORING=true
监控端口
COPAW_MONITORING_PORT=9090
Token 使用监控
# Token 使用文件
COPAW_TOKEN_USAGE_FILE=/var/log/copaw/token_usage.json
Token 限制
COPAW_MAX_TOKENS_PER_DAY=100000
部署配置
Docker 部署
Dockerfile
：
FROM python:3.11-slim
WORKDIR /app
RUN pip install copaw
COPY .env /app/.env
COPY config.json /app/.copaw/config.json
EXPOSE 8088
CMD ["copaw", "app"]
docker-compose.yml
：
version: '3.8'
services:
copaw:
build: .
ports:
- "8088:8088"
environment:
- OPENAI_API_KEY=${OPENAI_API_KEY}
volumes:
- copaw_data:/root/.copaw
restart: unless-stopped
volumes:
copaw_data:
系统服务
systemd 配置
：
[Unit]
Description=CoPaw AI Assistant
After=network.target
[Service]
Type=simple
User=copaw
WorkingDirectory=/home/copaw
EnvironmentFile=/home/copaw/.env
ExecStart=/usr/local/bin/copaw app
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
启用服务
：
sudo cp copaw.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl start copaw
sudo systemctl enable copaw
命令行操作
# 查看配置
copaw config get
设置配置
copaw config set agent.model_provider openai
查看环境变量
copaw env list
设置环境变量
copaw env set OPENAI_API_KEY sk-xxxxx
测试连接
copaw doctor
常见问题
Q: 环境变量不生效？
A: 检查：
- 变量名是否正确
- 是否重启了 CoPaw
- 是否在正确的环境中设置
Q: 如何查看当前配置？
A:
# 查看配置文件
cat ~/.copaw/config.json
查看环境变量
env | grep COPAW
Q: 运行配置修改后需要重启吗？
A: 部分配置需要重启：
- 需要重启：服务器配置、模型配置
- 不需要重启：运行配置、环境变量
