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
📖 详细文档
查看完整文档:
💡 使用建议
- 定期归档: 按天/周创建新页面归档对话
- 标签分类: 使用 tags 标记重要对话
- 项目协作: 将项目相关对话同步到项目文档
- 知识管理: 保存有价值的问答和解决方案
🔍 调试技巧
查看 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 调用,不会上传到其他地方
需要进一步定制功能或遇到问题,随时告诉我!