从官方 OpenClaw 到凌骁定制版：完整版本演进 + 迁移指南

一、OpenClaw 版本演进时间线（v2026.3.8 → v2026.4.2）

v2026.3.8 (2026-03-09)

• CLI 备份工具：openclaw backup create / backup verify，含 manifest 验证
• Talk 模式：新增 silenceTimeoutMs，自定义静默等待时长后自动发送
• TUI 改进：自动从当前 workspace 推断 active agent
• Brave web search：新增 llm-context 模式，返回 LLM 直接可用的提取片段

v2026.3.11 (2026-03-12)

• 🔒 安全修复：WebSocket 跨站劫持漏洞（GHSA-5wcw-8jjv-m286），所有浏览器连接强制源验证
• sessions_yield：编排器工具，立即结束当前 turn，跳过后续工具队列，携带隐藏 payload 到下一 turn
• Fast mode：Anthropic（service_tier）和 OpenAI 都支持会话级快速推理切换
• iOS 首屏欢迎页：live agent overview，重连/前台返回自动刷新

v2026.3.12 (2026-03-13)

• Control UI Dashboard v2 全面重构：模块化概览/聊天/配置/agent/session 视图，命令面板，移动端底栏，导出、搜索、固定消息
• OpenAI GPT-5.4 fast mode：会话级切换，与 Anthropic fast mode 对称
• Ollama 一键 onboarding：Local 或 Cloud+Local 混合模式，自动模型建议，跳过云模型 pull
• sessions_yield 工具正式稳定发布（在 3.12 完整集成进 subagent 编排流）

v2026.3.13 (2026-03-14) — Bug fix release

• 修复：session reset 时丢失 lastAccountId / lastThreadId
• 修复：Discord gateway metadata 获取失败的处理
• 修复：compaction 使用完整 session token 计数做健全检查

v2026.3.22 (2026-03-23) — ⚠️ BREAKING CHANGES

• Plugin install 优先级翻转：openclaw plugins install <pkg> 优先查 ClawHub，无匹配才回退 npm
• Browser/Chrome MCP 移除旧扩展路径：删除 extension relay、bundled assets、driver: "extension"。迁移命令：openclaw doctor --fix
• image_generate 工具标准化：移除 nano-banana-pro bundled skill，统一用 agents.defaults.imageGenerationModel
• 新 Plugin SDK 正式路径：openclaw/plugin-sdk/*；openclaw/extension-api 直接移除，无兼容 shim

v2026.3.23 (2026-03-23)

• Qwen/ModelStudio：新增标准 DashScope 端点（按量计费），补充既有编程计划端点
• Control UI 主题重构：Knot 黑红配色，WCAG 2.1 AA 对比度，全部配置区块加图标
• CSP 强化：inline <script> 改用 SHA-256 hash，script-src CSP directive 显式允许

v2026.3.24 (2026-03-25)

• OpenAI 兼容性扩展：新增 /v1/models / /v1/embeddings，/v1/chat/completions 和 /v1/responses 支持显式模型覆盖
• /tools 动态展示：实时显示当前 agent 实际可用工具，Control UI 增 "Available Right Now" 切片
• 微软 Teams 迁移官方 SDK：streaming 1:1 回复、欢迎卡、反馈/反思、typing indicator、AI 标签
• Skills 一键安装 recipes：coding-agent、gh-issues、openai-whisper-api、tmux 等带依赖自动安装方案
• Skills Control UI：过滤标签页（All / Ready / Needs Setup / Disabled），点击详情弹窗，一键安装 + API key 录入

v2026.3.28 (2026-03-29)

• xAI/Grok：迁移到 Responses API，新增 x_search 一级工具，web-search 配置自动启用 xAI plugin
• MiniMax：新增 image-01 图片生成 + 图转图编辑，纵横比控制
• Plugin hooks requireApproval：before_tool_call 钩子可暂停工具执行，请求人工审批，支持 Discord 按钮/Telegram/exec 浮层
• /approve 统一接口：同时处理 exec 和 plugin 审批，自动 fallback
• ACP：Discord / iMessage 当前对话 bind，/acp spawn codex --bind here 无需新建子线程

v2026.3.31 (2026-03-31) — ⚠️ BREAKING CHANGES

• nodes.run 移除：节点 shell 执行统一走 exec host=node，保留 nodes invoke 和专属 media/location/notify
• Plugin SDK 旧兼容路径废弃：迁移警告正式触发，forward path 为 openclaw/plugin-sdk/* + local api.ts / runtime-api.ts
• Skill 安装危险代码默认失败关闭：critical 级发现和扫描失败默认拒绝，需显式 --dangerously-force-unsafe-install
• Gateway trusted-proxy 拒绝混合共享 token：local-direct fallback 必须配置显式 token
• Node commands 锁定到配对审批后：device pairing 不再隐式启用 node commands

v2026.4.1 (2026-04-01)

• /tasks 聊天原生后台任务看板：当前 session 的任务列表、最近任务详情、agent-local fallback 计数
• SearXNG 内置 web_search 提供商：bundled provider，可配自有主机
• Amazon Bedrock Guardrails：内置支持
• Voice Wake 触发 Talk Mode：macOS 首个语音唤醒选项
• Feishu Drive 评论流：thread 上下文解析、in-thread 回复、feishu_drive 评论动作
• agents.defaults.params：全局默认 provider 参数
• Auth failover 冷却：速率限制重试上限 + auth.cooldowns.rateLimitedProfileRotations knob
• openclaw cron --tools：每个定时任务独立工具白名单

v2026.4.2 (2026-04-02) — ⚠️ BREAKING CHANGES

• xAI 配置路径迁移：tools.web.x_search.* → plugins.entries.xai.config.xSearch.*；运行 openclaw doctor --fix
• Firecrawl 配置路径迁移：tools.web.fetch.firecrawl.* → plugins.entries.firecrawl.config.webFetch.*
• Task Flow 核心恢复：managed vs mirrored 同步模式、持久流状态 + 版本追踪、openclaw flows 检查/恢复原语
• 托管子任务 + 粘滞取消：外部编排器可立即停止调度，父 Task Flow 等待活动子任务完成后归档到 cancelled
• api.runtime.taskFlow seam：plugins 和信任层可创建/驱动托管 Task Flow，无需传 owner id

二、官方版 vs 凌骁定制版：完整对比

三、如何组织自定义 Skills：分层思路

官方 OpenClaw 的 ClawHub 提供通用 skill 生态。定制化的关键在于：每个人/团队的 skill 应该按业务分层设计，而不是堆砌功能。

我们将自定义 skill 划分为五个层次：

🧠 层 1 — 记忆与学习（最底层，全局生效）

这一层是所有其他 skill 的基础。包括持久记忆系统和自学习能力。

• Memory skill：封装 PostgreSQL + pgvector 的读写，提供统一的记忆查询/存储接口。所有 skill 都依赖它记住上下文。
• Self-improvement skill：错误自动记录、纠正学习、热知识缓存。让 agent 越用越聪明。

通用化建议：这两个 skill 适合任何 OpenClaw 定制场景，可直接复用。

🏢 层 2 — 平台核心（你自己产品/服务的管理 skill）

这一层封装你自己维护的平台的操作。比如你有网站、课程平台、API，就在这里写对应的 Bot API 调用。

关键原则：每个平台一个 skill，接口统一走 Bot Token + REST API，避免直连数据库。

📰 层 3 — 内容运营（自动化内容生产）

每日新闻抓取、AI 写文章、自动发布。这一层让 agent 成为内容机器。

• 新闻抓取 skill：多源 RSS + Tavily 实时搜索，输出标准化 JSON
• AI 写作 skill：Claude 生成中英双语 Markdown，按类别发布
• 搜索 skill：Tavily / DuckDuckGo 联网搜索，多 key 轮转

通用化建议：抓取源和发布目标可配置化，换成任何 blog 平台都能用。

⚙️ 层 4 — 生产力集成（外部服务对接）

对接你日常用的 SaaS 工具。每个外部服务一个 skill。

• Google Workspace（邮件/日历/文档/表格）
• GitHub（代码操作、PR、issue 管理）
• 提醒/日历订阅
• 云部署（Cloudflare Tunnel、Docker）
• 后台任务队列（Claude Code 异步执行）

关键原则：这些 skill 处理的是你个人/团队的日常工作流，私有数据不外泄。

🔒 层 5 — 私有业务 skill（不公开）

任何与你具体业务强绑定的 skill（特定客户系统、内部考勤、私有 CRM 等），只在你自己的 workspace 中存在，不纳入通用分享。

这一层是真正的"定制化"体现。每个人的这一层都不同，也不应该相同。

设计建议

层 1（记忆/学习）← 通用，可直接复用
层 2（平台核心）← 你的产品决定
层 3（内容运营）← 通用框架，替换抓取源和发布目标
层 4（生产力集成）← 按你用的 SaaS 选配
层 5（私有业务）← 完全私有，不共享

AGENTS.md 的 Skills Index 路由表就是把这五层统一管理的索引：用自然语言描述意图，映射到对应 skill 文件路径。

四、凌骁三大特色架构

1. Memory Service（持久记忆）

pgvector (1024维 bge-m3)  ←→  PostgreSQL 17 (facts)  ←→  Redis (hot cache)
         ↑                           ↑                         ↑
  语义相似搜索              结构化 domain/key 查询          高频知识 <5ms
         ↓
  FastAPI uvicorn
  localhost:18800
  hybrid search (FTS + vector)

• 搜索：永远先用 memory_search（workspace 文件 + pgvector 混合搜索）
• 写入：POST /facts（结构化）或 POST /store（对话记忆）
• 自动化：daily archival / expire / promote-to-hot

2. 人格层（SOUL.md + IDENTITY.md）

官方 OpenClaw 是无人格工具。凌骁通过两个文件定义稳定人格：

• SOUL.md：底层价值观。直接、有观点、不废话、不表演。
• IDENTITY.md：名字凌骁（Líng Xiāo）、中英双语、傲气有底气、办事利落。

3. AGENTS.md 路由系统

一个文件替代了 plugins.json + 文档 + 权限配置：

• Skills Index：意图 → skill 文件的快速路由表
• Exec 权限：Discord session 完全 exec 权限（curl/python/docker/systemctl）
• Memory 规则：搜用 memory_search，写用 curl /facts
• 自学习规则：命令失败→记录 error，用户纠正→记录 correction

五、迁移步骤：从官方 OpenClaw 到本套配置

Step 1 — 安装基础 OpenClaw

npm install -g openclaw
openclaw onboard  # 选 Anthropic API，输入 sk-ant-...

Step 2 — 配置 Discord 频道

# 创建 Discord Bot → 获取 token
openclaw configure --section channels
# 选 Discord，输入 Bot Token 和 Guild ID

Step 3 — 设置 Claude Sonnet 4.6 为默认模型

# 在 openclaw.json 或 agents.defaults 配置：
# agents.defaults.model: "anthropic/claude-sonnet-4-6"

Step 4 — 部署 Memory Service（强烈推荐）

# 安装依赖
sudo apt install postgresql-17 python3-pip
pip install pgvector sentence-transformers fastapi uvicorn

# PostgreSQL 启用 pgvector
sudo -u postgres psql -c "CREATE EXTENSION vector"

# 启动 Memory Service
cd ~/openclaw-memory-service
uvicorn main:app --host 127.0.0.1 --port 18800

# 设为 systemd 服务（推荐）
sudo systemctl enable openclaw-memory
sudo systemctl start openclaw-memory

Step 5 — 安装自定义 Skills

# 将 skills/ 目录放到 workspace
cp -r skills/ ~/.openclaw/workspace/skills/
# 无需注册，通过 AGENTS.md 路由表按需调用

Step 6 — 创建配置文件

在 ~/.openclaw/workspace/ 创建：

• AGENTS.md：Skills Index 路由表 + exec 权限策略 + memory 规则 + 自学习规则
• SOUL.md：AI 人格底色（几句话定义风格）
• IDENTITY.md：名字、称呼、时区、语言偏好

Step 7 — 原生 systemd 部署（可选，替代 Docker）

# 为每个服务创建 .service 文件
sudo tee /etc/systemd/system/oc-api.service << 'EOF'
[Unit]
Description=OpenClaw Flask API
After=network.target postgresql.service

[Service]
User=borui
WorkingDirectory=/home/borui/openclaw-services/backend
ExecStart=/usr/bin/python3 -m gunicorn -w 4 app:app -b 127.0.0.1:4001
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl enable oc-api && sudo systemctl start oc-api

Step 8 — 配置定时任务

# 在 crontab 添加（注意：不要用 crontab -e 交互式，直接追加）
(crontab -l; cat << 'CRON'
# Blog 自动抓取与发布 — 6AM Vancouver (13:00 UTC)
0 13 * * * cd ~/openclaw-services/blog_fetcher && python3 fetcher.py >> /tmp/blog-fetcher.log 2>&1 && python3 auto_publisher.py >> /tmp/blog-publisher.log 2>&1
# OpenClaw 每日更新分析 — 6:30AM Vancouver
30 13 * * * cd ~/openclaw-services/blog_fetcher && python3 openclaw_blog_writer.py >> /tmp/openclaw-blog-writer.log 2>&1
# 自学习热知识提升 — 7AM Vancouver (14:00 UTC)
0 14 * * * curl -s -X POST http://localhost:18800/maintenance/promote-learnings >> /tmp/promote.log 2>&1
CRON
) | crontab -

六、各版本对我们配置的实际影响

七、数据库迁移：从 SQLite 到 PostgreSQL 双库架构

官方 OpenClaw 默认使用 SQLite 存储 session、记忆、task 等数据。我们完全替换为 PostgreSQL 17，并拆分成两个独立数据库，各司其职。

整体架构

官方 OpenClaw
└── SQLite (openclaw.db)
    ├── sessions
    ├── memories (仅 session 内存，无持久化)
    └── tasks

凌骁定制版
├── PostgreSQL: openclaw_club (业务库)
│   ├── 课程平台（用户/讲座/班级/作业/出勤）
│   ├── Blog 系统（文章/向量嵌入/全文索引）
│   ├── Discord 审核（violations）
│   └── 任务追踪（task_runs / task_delivery_state）
│
└── PostgreSQL: memory schema (记忆库，在同一 PG 实例)
    ├── memory.embeddings   ← 语义向量记忆（pgvector）
    ├── memory.facts        ← 结构化事实（domain/key/value）
    ├── memory.files        ← 文件元数据（MinIO 对象引用）
    ├── memory.access_log   ← 访问日志（时间衰减计算）
    ├── skill_reminder.*    ← 提醒 + 日历订阅
    └── skill_task.*        ← 异步任务队列

Step 1 — 安装 PostgreSQL 17 + pgvector

# Ubuntu 24.04
sudo apt install -y postgresql-17 postgresql-17-pgvector

# 确认安装
psql --version   # PostgreSQL 17.x

Step 2 — 创建数据库和用户

sudo -u postgres psql << 'SQL'
-- 创建应用用户
CREATE USER oc_admin WITH PASSWORD 'your_secure_password';

-- 业务数据库
CREATE DATABASE openclaw_club OWNER oc_admin;

-- 授权
GRANT ALL PRIVILEGES ON DATABASE openclaw_club TO oc_admin;
SQL

Step 3 — 启用 pgvector 扩展

PGPASSWORD=your_password psql -h 127.0.0.1 -U oc_admin -d openclaw_club << 'SQL'
CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS pg_trgm;   -- 全文搜索加速（可选）
SQL

Step 4 — 建 memory schema（持久记忆系统）

# 使用 schema.sql 创建所有表
PGPASSWORD=your_password psql -h 127.0.0.1 -U oc_admin -d openclaw_club   -f /path/to/agentic-memory/sql/schema.sql

schema.sql 包含以下表结构：

memory.embeddings — 语义向量记忆

CREATE TABLE memory.embeddings (
    id           UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    content      TEXT NOT NULL,
    embedding    vector(1024) NOT NULL,       -- bge-m3 1024维
    category     TEXT DEFAULT 'general',
    importance   SMALLINT DEFAULT 5,
    access_count INT DEFAULT 0,
    created_at   TIMESTAMPTZ DEFAULT now(),
    last_accessed TIMESTAMPTZ DEFAULT now(),
    is_archived  BOOLEAN DEFAULT false
);
-- HNSW 向量索引（高效近似最近邻搜索）
CREATE INDEX idx_embeddings_hnsw ON memory.embeddings
    USING hnsw (embedding vector_cosine_ops) WITH (m=16, ef_construction=200);
-- 全文搜索索引
CREATE INDEX idx_embeddings_fts ON memory.embeddings
    USING gin(to_tsvector('english', content));

memory.facts — 结构化事实存储

CREATE TABLE memory.facts (
    id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    domain     TEXT NOT NULL,           -- 例如: "user", "system", "project"
    key        TEXT NOT NULL,           -- 例如: "timezone", "preferred_model"
    value      JSONB NOT NULL,          -- 支持任意 JSON 结构
    expires_at TIMESTAMPTZ,             -- 可选过期时间
    is_active  BOOLEAN DEFAULT true,
    UNIQUE(domain, key)
);

skill_reminder.* — 提醒与日历订阅

CREATE TABLE skill_reminder.reminders (
    id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    title       TEXT NOT NULL,
    remind_at   TIMESTAMPTZ NOT NULL,
    repeat_rule TEXT,                   -- iCal RRULE 格式
    status      TEXT DEFAULT 'active',  -- active/completed/cancelled
    importance  SMALLINT DEFAULT 5
);

CREATE TABLE skill_reminder.calendar_feeds (
    id           UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    name         TEXT NOT NULL,
    url          TEXT NOT NULL,          -- iCal/ICS 订阅 URL
    sync_interval INT DEFAULT 3600,     -- 秒
    last_synced_at TIMESTAMPTZ
);

skill_task.* — 异步任务队列

CREATE TABLE skill_task.queue (
    id           UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    title        TEXT NOT NULL,
    command      TEXT NOT NULL,
    status       TEXT DEFAULT 'pending', -- pending/running/done/failed
    result       TEXT,
    notify       BOOLEAN DEFAULT true,
    created_at   TIMESTAMPTZ DEFAULT now()
);

Step 5 — 建 openclaw_club 业务表

这部分是业务层（课程平台 + Blog + Discord），完整 DDL 在 Flask 后端启动时自动 migrate。手动建表：

# 进入后端目录，运行 schema 初始化
cd ~/openclaw-services/backend
python3 -c "from app import db; db.create_all()"
# 或者直接执行 DDL SQL
PGPASSWORD=your_password psql -h 127.0.0.1 -U oc_admin -d openclaw_club   -f sql/openclaw_club_schema.sql

主要业务表：

Step 6 — 配置连接

Memory Service（~/.openclaw-memory-service/.env 或 config）：

DATABASE_URL=postgresql://oc_admin:[email protected]:5432/openclaw_club
REDIS_URL=redis://localhost:6379/0

Flask 后端（~/openclaw-services/.env）：

DATABASE_URL=postgresql://oc_admin:[email protected]:5432/openclaw_club

Step 7 — 设置 systemd 服务确保 PG 先于应用启动

# /etc/systemd/system/oc-api.service
[Unit]
Description=OpenClaw Flask API
After=network.target postgresql.service   # ← 确保 PG 先启动

[Service]
User=borui
ExecStart=...

Step 8 — 备份策略（可选但推荐）

# crontab: 每天凌晨 3 点备份
0 3 * * * pg_dump -h 127.0.0.1 -U oc_admin openclaw_club   | gzip > ~/backups/openclaw-club/$(date +%Y%m%d).sql.gz

官方 SQLite vs 我们的 PostgreSQL：关键差异

总结

从官方 OpenClaw 到凌骁定制版的五个核心升级：

1. 记忆持久化：pgvector + bge-m3 hybrid search，摆脱单 session 限制，跨对话记住一切
2. 人格定义：SOUL.md 赋予 AI 稳定风格，不是无人格工具
3. 业务垂直化：17 个自定义 skill 封装核心业务（blog / 课程 / 打卡 / 诊所），每个 skill 有独立文档
4. 权限精细化：AGENTS.md 统一管理 skill 路由 + exec 权限 + memory 规则 + 自学习，一文件治理
5. 部署轻量化：systemd 原生，零 Docker，轻薄本跑得动，快速启动和管理

这套配置的完整代码和 skill 文件在 NexAgent workspace 中维护，也是 OpenClaw Club 课程的实践素材之一。