Copaw Cli
CoPaw CLI 命令行工具
CoPaw 提供了强大的命令行工具（CLI），通过 copaw
命令可以完成各种操作。
CLI 概述
为什么使用 CLI？
- 快速高效：无需打开浏览器
- 自动化友好：可以在脚本中使用
- 灵活强大：可以与其他工具组合
基础用法
# 查看帮助
copaw --help
查看特定命令的帮助
copaw app --help
查看版本
copaw --version
应用管理
copaw app
管理 CoPaw 应用的命令。
启动应用
：
copaw app start
copaw app start --port 9000
copaw app start --debug
停止应用
：
copaw app stop
copaw app stop --force
重启应用
：
copaw app restart
copaw app restart --clear-cache
查看状态
：
copaw app status
copaw app status --verbose
查看日志
：
copaw app logs
copaw app logs --follow
copaw app logs --lines 50
定时任务管理
copaw cron
管理 CoPaw 定时任务的命令。
创建定时任务
：
copaw cron create
copaw cron create --interactive
查询定时任务
：
copaw cron list
copaw cron list --simple
copaw cron list --json
暂停定时任务
：
copaw cron pause <task_id>
copaw cron pause --name 每日提醒
恢复定时任务
：
copaw cron resume <task_id>
删除定时任务
：
copaw cron delete <task_id>
copaw cron delete --all
立即执行任务
：
copaw cron run <task_id>
更新定时任务
：
copaw cron update <task_id> --schedule "0 10 "
copaw cron update <task_id> --prompt "新的提示词"
配置管理
copaw config
管理 CoPaw 配置的命令。
查看配置
：
copaw config get
copaw config get --json
copaw config get agent.model_provider
设置配置
：
copaw config set agent.model_provider openai
copaw config set agent.model_name gpt-4
删除配置
：
copaw config unset agent.max_iterations
重置配置
：
copaw config reset
环境变量管理
copaw env
管理 CoPaw 环境变量的命令。
查看环境变量
：
copaw env list
copaw env get OPENAI_API_KEY
设置环境变量
：
copaw env set OPENAI_API_KEY sk-xxxxxxxx
删除环境变量
：
copaw env unset OPENAI_API_KEY
从文件导入
：
copaw env load .env
技能管理
copaw skills
管理 CoPaw Skills 的命令。
列出所有 Skills
：
copaw skills list
copaw skills list --verbose
启用 Skill
：
copaw skills enable pdf
copaw skills enable pdf docx news
禁用 Skill
：
copaw skills disable news
查看 Skill 信息
：
copaw skills info pdf
更新 Skills
：
copaw skills update
copaw skills update pdf
模型管理
copaw models
管理 CoPaw 模型的命令。
Ollama 模型
：
copaw models ollama-pull <model_name>
copaw models ollama-list
copaw models ollama-remove <model_name>
列出可用模型
：
copaw models list
诊断和调试
copaw doctor
检查 CoPaw 系统状态。
copaw doctor
copaw doctor --verbose
copaw doctor --check api,skills,channels
输出示例
：
🔍 CoPaw 系统诊断
✅ 配置文件: 正常
✅ 数据库连接: 正常
✅ Skills: 正常
✅ 频道: 正常
⚠️ API 密钥: OpenAI API Key 未设置
✅ 内存: 正常 (45%)
copaw version
查看 CoPaw 版本。
copaw --version
copaw version --verbose
实用工具
导出数据
# 导出配置
copaw config get --json > config_backup.json
导出定时任务
copaw cron list --json > cron.json
导出环境变量
copaw env list > env.txt
管道和重定向
# 将配置导出到文件
copaw config get --json > config.json
过滤日志
copaw app logs --filter ERROR | grep "API"
统计任务数量
copaw cron list | wc -l
实战案例
案例 1：快速启动和监控
# 启动 CoPaw
copaw app start
查看状态
copaw app status
查看日志
copaw app logs --follow
停止 CoPaw
copaw app stop
案例 2：批量管理定时任务
# 查询所有任务
copaw cron list
暂停所有任务
copaw cron pause $(copaw cron list --simple | awk '{print $1}')
恢复特定任务
copaw cron resume 1 3 5
案例 3：备份和恢复
# 备份配置
cp ~/.copaw/config.json ~/.copaw/config.json.backup
导出数据
copaw export all > copaw_backup.json
备份环境变量
copaw env list > env_backup.txt
案例 4：诊断和修复
# 运行诊断
copaw doctor --verbose
查看日志
copaw app logs --filter ERROR
清理缓存
copaw app restart --clear-cache
脚本自动化
启动脚本
#!/bin/bash
copaw app start
sleep 5
if copaw app status; then
echo "CoPaw 启动成功！"
else
echo "CoPaw 启动失败！"
exit 1
fi
copaw app logs --follow
批量创建定时任务
#!/bin/bash
copaw cron create \
--name "每日提醒" \
--schedule "0 9 " \
--prompt "提醒我今天的工作任务"
copaw cron create \
--name "每周总结" \
--schedule "0 18 5" \
--prompt "总结本周的工作"
备份脚本
#!/bin/bash
BACKUP_DIR="/backup/copaw/$(date +%Y%m%d_%H%M%S)"
mkdir -p $BACKUP_DIR
copaw config get --json > $BACKUP_DIR/config.json
copaw cron list --json > $BACKUP_DIR/cron.json
copaw env list > $BACKUP_DIR/env.txt
echo "备份完成：$BACKUP_DIR"
常见问题
Q: 命令找不到？
A: 检查：
- CoPaw 是否正确安装
- PATH 环境变量是否包含 CoPaw
- 是否需要使用完整路径
Q: 权限不足？
A: 检查：
- 是否有足够的权限
- 是否需要 sudo
- 文件和目录权限是否正确
Q: 如何获取命令的详细帮助？
A:
copaw --help
copaw app --help
copaw cron create --help
Q: CLI 和控制台有什么区别？
A:
- CLI：命令行操作，适合自动化
- 控制台：Web 界面操作，适合日常管理
