📄 WOLAI_SYNC_README.md

⬇️ 下载文件

wolai-sync Skill 已创建完成!

📦 打包文件: /root/.openclaw/workspace/wolai-sync.skill

📂 Skill 目录: /root/.openclaw/workspace/skills/wolai-sync/

🚀 快速开始

1. 获取 wolai API Token

登录 wolai → 「设置」→「开发者」→ 生成 API Token

2. 测试 API 连接

cd /root/.openclaw/workspace/skills/wolai-sync
./test_wolai.sh YOUR_API_TOKEN

3. 同步对话内容

方式一:追加到现有页面

python3 scripts/sync_conversation.py \
  --token YOUR_API_TOKEN \
  --page-id YOUR_PAGE_ID \
  --conversation-file conversation.json

方式二:创建新页面

python3 scripts/sync_conversation.py \
  --token YOUR_API_TOKEN \
  --parent-id PARENT_PAGE_ID \
  --title "对话记录" \
  --conversation-file conversation.json

📋 对话数据格式

创建 conversation.json

{
  "user": {
    "name": "用户名",
    "id": "user_id"
  },
  "messages": [
    {
      "role": "user",
      "content": "用户输入"
    },
    {
      "role": "assistant",
      "content": "助手回复"
    }
  ],
  "tags": ["标签1", "标签2"]
}

🔧 核心功能

自动同步对话

自动将对话按时间戳和格式化追加到 wolai 页面,不会覆盖原有内容。

API 客户端

scripts/wolai_api.py 提供完整的 wolai API 封装:

  • 创建/更新页面
  • 获取页面详情
  • 搜索页面

安全设计

  • Token 通过参数传递,不硬编码
  • 支持环境变量存储
  • 建议添加到 .gitignore

📖 详细文档

查看完整文档:

💡 使用建议

  1. 定期归档: 按天/周创建新页面归档对话
  2. 标签分类: 使用 tags 标记重要对话
  3. 项目协作: 将项目相关对话同步到项目文档
  4. 知识管理: 保存有价值的问答和解决方案

🔍 调试技巧

查看 API 响应详情:

python3 scripts/wolai_api.py \
  --token YOUR_TOKEN \
  --action get \
  --page-id PAGE_ID

搜索页面:

python3 scripts/wolai_api.py \
  --token YOUR_TOKEN \
  --action search \
  --query "关键词"

❓ 常见问题

Q: 如何找到页面ID?
A: 打开 wolai 页面,URL 最后一部分就是页面ID

Q: 更新会覆盖原有内容吗?
A: 不会,自动追加到页面末尾

Q: 有频率限制吗?
A: 建议单次同步少于 100 个内容块

Q: Token 安全吗?
A: Token 仅用于 API 调用,不会上传到其他地方


需要进一步定制功能或遇到问题,随时告诉我!