CoPaw 配置教程：打造你的私人 AI 助理前言 CoPaw是一款开源的 AI 自动化助手，可以 24 小时自动执行任

前言

CoPaw是一款开源的 AI 自动化助手，可以 24 小时自动执行任务，比如定时发送日报、自动回复消息、定时提醒等。它最大的优势是支持定时任务（Cron）和多渠道接入（飞书/钉钉/企业微信等）。

为什么选择 CoPaw？

✅ 开源免费，无订阅费用
✅ 支持定时任务，24 小时自动执行
✅ 多渠道接入，飞书/钉钉/企业微信都能用
✅ 支持自定义 Skills，扩展能力强
✅ 本地部署，数据隐私安全

为什么接入索元 AI+？

✅ 成本更低：比官方 API 便宜 30%
✅ 国内直连：无需科学上网，访问速度快
✅ 模型丰富：Qwen3.5/DeepSeek/GLM-5 等
✅ 统一 API：一次接入，使用所有模型

适用人群：

技术爱好者：想打造私人 AI 助理
团队管理者：需要自动化工具提升效率
开发者：想学习 AI 自动化开发
效率达人：想让 AI 帮忙处理重复工作

前置条件： 已注册索元 AI+ 账号（www.soyenai.com/register）

1. 索元 AI+ 平台简介

1.1 什么是索元 AI+？

索元 AI+ 是一站式大模型 API 聚合平台，提供 40+ 主流模型的统一接入服务。

核心优势：

✅ 价格优惠：比官方 API 便宜 30%
✅ 国内直连：无需科学上网，访问速度快
✅ 模型丰富：通义千问、DeepSeek、智谱 AI、MiniMax 等
✅ 统一 API：一次接入，使用所有模型
✅ 技术支持：中文文档 + 客服支持

适合谁用？

个人开发者：快速接入大模型能力
企业用户：稳定可靠的 API 服务
学生群体：低成本体验大模型
AI 爱好者：尝试不同模型的效果

1.2 平台地址

官网： www.soyenai.com
模型广场： www.soyenai.com/pricing
定价详情： www.soyenai.com/pricing-pag…
注册入口： www.soyenai.com/register

2. 获取 API Key

2.1 注册账号

访问索元 AI+ 官网：www.soyenai.com/register
填写邮箱/手机号，设置密码
完成验证，登录账号

提示： 新用户注册通常会赠送体验金额，可以先测试再充值。

2.2 充值额度

登录后进入控制台：www.soyenai.com/console/top…
选择充值金额（有多种套餐可选）
完成支付，额度即时到账

推荐套餐：

Pro 月卡：¥39/月，卡内额度¥100（低至 3.9 折）
Pro 季卡：¥99/季，卡内额度¥300（低至 3.3 折）
Pro 年卡：¥399/年，卡内额度¥1200（低至 3.3 折）

价格参考（索元优惠价，比官方便宜 30%）：

Qwen3.5-397B-A17B：¥2.10/百万 tokens（输入）/ ¥12.60/百万 tokens（输出）
Qwen2.5-72B：¥2.80/百万 tokens（输入）/ ¥8.40/百万 tokens（输出）
DeepSeek-V3.2：¥1.40/百万 tokens（输入）/ ¥2.10/百万 tokens（输出）
GLM-5：¥4.20/百万 tokens（输入）/ ¥15.40/百万 tokens（输出）
MiniMax-M2.5：¥1.68/百万 tokens（输入）/ ¥6.72/百万 tokens（输出）

注：具体价格以官网为准（www.soyenai.com/pricing-pag…

2.3 创建 API Key

进入令牌管理页面：www.soyenai.com/console/tok…
点击「添加令牌」
设置令牌名称（如：CoPaw）
点击「创建」
复制 API Key（格式：sk-xxxxxxxx）

⚠️ 重要提示：

不要泄露给他人
如不慎泄露，请及时删除并重新创建

3. 安装 CoPaw

脚本安装（推荐）：

无需预装 Python — 安装脚本通过 uv 自动管理一切。

# Windows PowerShell
irm https://copaw.agentscope.io/install.ps1 | iex

# macOS/Linux
curl -fsSL https://copaw.agentscope.io/install.sh | bash

然后打开新终端（安装脚本会自动将 CoPaw 加入 PATH）。安装教程详见CoPaw官方文档：copaw.agentscope.io/docs/quicks…

4. CoPaw 配置教程

4.1 初始化工作区

# 初始化默认配置
copaw init

生成的文件结构：

~/.copaw/
├── config.json          # 主配置文件
├── agent.json           # Agent 配置
├── HEARTBEAT.md         # 心跳任务配置
├── MEMORY.md            # 长期记忆
├── workspaces/
│   └── default/
│       ├── agent.json   # 工作区配置
│       ├── active_skills/  # Skills 目录
│       └── memory/      # 每日笔记

4.2 配置模型

编辑配置文件 ~/.copaw/config.json：

{
  "models": [
    {
      "provider": "openai",
      "api_key": "你的索元 API Key",
      "base_url": "https://www.soyenai.com/v1",
      "model": "Qwen3.5-397B-A17B"
    }
  ],
  "running": {
    "user_timezone": "Asia/Shanghai"
  }
}

配置说明：

provider: 固定为 openai（索元兼容 OpenAI API）
api_key: 你的索元 API Key（sk-xxxxxxxx）
base_url: 索元 API 端点（www.soyenai.com/v1）
model: 默认使用的模型
user_timezone: 时区设置（必须为 Asia/Shanghai）

4.3 测试连接

在浏览器控制台测试：

访问 http://127.0.0.1:8088
在聊天窗口输入消息
如果能正常回复，说明配置成功

5. 模型推荐

索元 AI+ 平台提供 40+ 模型，以下是 CoPaw 使用推荐：

5.1 代码生成

推荐模型： GLM-5

理由：

代码能力强
支持多种编程语言
能理解复杂需求
性价比高（¥4.20/百万 tokens 输入 / ¥15.40/百万 tokens 输出）

5.2 文档写作

推荐模型： Qwen3.5-397B-A17B

理由：

文本生成流畅
逻辑清晰
适合长文本
成本适中（¥2.10/百万 tokens 输入 / ¥12.60/百万 tokens 输出）

5.3 数据分析

推荐模型： MiniMax-M2.5

理由：

逻辑推理能力强
数学计算准确
适合分析类任务
成本低（¥1.68/百万 tokens 输入 / ¥6.72/百万 tokens 输出）

5.4 快速响应

推荐模型： DeepSeek-V3.2

理由：

响应速度最快
适合简单问答
成本最低（¥1.40/百万 tokens 输入 / ¥2.10/百万 tokens 输出）
上下文 128K 够用

6. 成本对比

模型	官方价格 (¥/M)	索元价格 (¥/M)	节省
Qwen3.5-397B-A17B	¥3.00 / ¥18.00	¥2.10 / ¥12.60	30%
Qwen2.5-72B	¥4.00 / ¥12.00	¥2.80 / ¥8.40	30%
MiniMax-M2.5	¥2.40 / ¥9.60	¥1.68 / ¥6.72	30%
GLM-5	¥6.00 / ¥22.00	¥4.20 / ¥15.40	30%
DeepSeek-V3.2	¥2.00 / ¥3.00	¥1.40 / ¥2.10	30%

注：M=百万 tokens，价格格式为输入价格 / 输出价格

7. 常见问题

Q1: 启动失败，提示"端口被占用"？

解决方案：

检查 8088 端口是否被占用
修改配置文件的端口号
或者关闭占用端口的程序

Q2: 定时任务不执行？

解决方案：

检查 Cron 表达式是否正确
检查时区配置（必须为 Asia/Shanghai）
检查任务是否启用（enabled: true）

Q3: 飞书/钉钉收不到消息？

解决方案：

检查频道配置是否正确
检查 App ID/Secret 是否正确
重启服务：copaw daemon restart

Q4: 如何降低成本？

解决方案：

简单任务用小模型（DeepSeek-V3.2/Qwen2.5）
优化提示词（减少不必要的 token 消耗）
购买 Pro 套餐（3.3-3.9 折）
定期查看用量统计（www.soyenai.com/console/log…

8. 最佳实践

8.1 提示词优化

好的提示词：

生成每日工作总结汇报，包含：
1. 今日完成的任务（表格形式）
2. 学习收获（分点说明）
3. 记忆整理情况（表格形式）
4. 明日计划（表格形式）

要求：
- 简洁清晰，直接可用

不好的提示词：

写个日报

8.2 任务命名规范

推荐：

每日总结汇报
午间状态汇总

不推荐：

任务 1
test
未命名

8.3 成本控制

监控用量：

定期查看控制台用量统计（www.soyenai.com/console/log…

使用套餐：

Pro 月卡：¥39/月，卡内额度¥100（适合轻度用户）
Pro 季卡：¥99/季，卡内额度¥300（适合中度用户）
Pro 年卡：¥399/年，卡内额度¥1200（适合重度用户）

9. 安全与隐私

9.1 API Key 安全

✅ 不要泄露给他人
✅ 不要上传到 GitHub 等公开平台
✅ 定期更换（建议每 3 个月）
✅ 如不慎泄露，及时删除并重新创建

9.2 数据隐私

索元平台承诺不保存用户对话数据
API 调用日志仅用于用量统计
可选择删除历史用量记录

9.3 本地部署优势

为什么选择本地部署？

✅ 数据完全本地，隐私安全
✅ 无需担心数据泄露
✅ 可自定义配置
✅ 无服务中断风险

📚 学习资源

官方文档

索元 AI+ 官网：www.soyenai.com
模型广场：www.soyenai.com/pricing
定价详情：www.soyenai.com/pricing-pag…

CoPaw 文档

CoPaw 官网：copaw.agentscope.io/
安装教程：copaw.agentscope.io/docs/quicks…

📝 总结

本文要点：

✅ CoPaw 是开源的 AI 自动化助手，支持定时任务和多渠道接入
✅ 索元 AI+ 提供 40+ 国产大模型，价格比官方便宜 30%
✅ 配置只需 4 步：获取 API Key → 安装 CoPaw → 配置模型 → 启动服务
✅ 不同场景选择不同模型（对话/代码/写作/分析）

下一步：

注册索元账号，获取 API Key
安装 CoPaw，按本文配置
创建你的第一个定时任务！

遇到问题？

查看索元官方文档：docs.soyenai.com/
联系客服获取帮助

声明： 本文仅做技术分享，基于个人使用经验整理。