⚡ 30 秒快速开始

git clone https://github.com/xyva-yuangui/XyvaClaw.git 2>/dev/null || (cd XyvaClaw && git pull)
cd XyvaClaw && bash xyvaclaw-setup.sh

💡 不会用 git？下载 ZIP 压缩包，解压后运行 bash xyvaclaw-setup.sh

💡 已经安装过？直接再次运行上面的命令即可升级，安装脚本会自动清理旧版本

🧙 Web 配置向导

安装过程自动弹出图形化配置向导，在浏览器中完成所有配置，无需手动编辑任何文件：

① 命名你的 AI 助手	② 配置 AI 模型密钥	③ 按需选择 38+ 技能
④ 确认配置一键启动	⑤ 终端自动安装	⑥ 测试生效

安装完成后

xyvaclaw setup            # 打开 Web 配置向导
xyvaclaw doctor           # 健康检查与诊断
xyvaclaw doctor --fix     # 自动修复问题
xyvaclaw status           # 查看运行状态
xyvaclaw gateway          # 启动 AI 助手
# 浏览器打开 http://localhost:18789

准备工作（只需一次）

1. 获取 AI 模型密钥（免费注册，二选一即可）：

   • DeepSeek（推荐，注册即送免费额度）
   • 百炼/通义千问（阿里云，一个 Key 调用多个模型）

2. 打开终端：macOS 按 Command + 空格 输入 Terminal | Linux 按 Ctrl + Alt + T

安装过程自动完成

• ✅ 检测并安装缺失依赖（Node.js、Python、ffmpeg）
• ✅ 弹出图形化配置向导（浏览器中填写 API Key）
• ✅ 部署 42+ 技能和所有配置
• ✅ 设置开机自启动

🇨🇳 中文介绍

xyvaClaw 是基于 OpenClaw 运行时深度增强的 AI 助手平台。它不只是聊天机器人——通过 V5 五阶段认知管道，它能理解意图、分解任务、结构化推理、质量自检，再给出回答。

用户消息 → 认知管道（理解→分析→推理→质检→响应）→ 行动执行 → 记忆沉淀 → 自我迭代

🧠 V5 认知管道 — 核心引擎

每条用户消息经过 V5 Orchestrator 统一编排的五阶段管道：

┌──────────────────────────────────────────────────────────────┐
│                      V5 Orchestrator                          │
│                                                                │
│  ① 消息分析 → ② 任务分解 → ③ 推理链 → ④ 质量门控 → ⑤ 延迟记录  │
│   (必选)       (复杂任务)    (推理类)   (中高复杂度)    (自动)     │
└──────────────────────────────────────────────────────────────┘

{
  "intent": {
    "primary": "data_analysis",
    "complexity": "complex",
    "urgency": "medium"
  },
  "strategy": {
    "type": "progressive_output",
    "risk_level": "low"
  },
  "emotion": {
    "primary": "curious",
    "intensity": 0.6,
    "tone_suggestion": "formal"
  },
  "routing": {
    "suggested_model": "deepseek/deepseek-reasoner",
    "suggested_skills": ["quant-strategy-engine"],
    "use_reasoning_chain": true,
    "reasoning_template": "investment_decision"
  },
  "action_type": "plan"
}

💾 四层记忆系统

┌────────────────────────────────────────────────┐
│  SESSION-STATE.md    ← 当前会话（WAL 先写后回）    │
├────────────────────────────────────────────────┤
│  memory/YYYY-MM-DD.md  ← 每日记忆              │
├────────────────────────────────────────────────┤
│  MEMORY.md          ← 长期记忆（偏好/规则/项目）   │
├────────────────────────────────────────────────┤
│  .reasoning/SQLite  ← 推理库（结构化检索）        │
└────────────────────────────────────────────────┘

🔀 模型路由与三级容灾

智能路由

三级 Fallback（零停机）

Tier 1: DeepSeek (5s timeout)  ──失败──→  Tier 2: Qwen3.5+ (15s)  ──失败──→  Tier 3: Kimi-K2.5 (10s)

• 毫秒级超时检测 + 无感切换
• 每 8 小时自动健康检查
• 支持自定义 Provider（任何 OpenAI 兼容 API，含自动模型检测）

🔄 自我迭代引擎

发现错误 → error-tracker.json → 自动修复建议 → 验证 → 学习
                                                        ↓
临时记忆 → 每日记忆 → 长期记忆 → 操作规范（AGENTS.md）

⚡ 42+ 技能

� 飞书深度集成

• 112 个 TypeScript 源文件覆盖飞书几乎所有 API
• 消息、文档、多维表格、日历、审批、云盘、Wiki
• 企业级可靠性：去重、串行调度、超时看门狗、降级回退

🏗 系统架构

┌─────────┐     ┌──────────────┐     ┌───────────────────┐
│  用户     │────→│  飞书/WebChat │────→│  OpenClaw Gateway  │
│  消息     │     │  消息通道      │     │  (port 18789)      │
└─────────┘     └──────────────┘     └────────┬──────────┘
                                               │
                    ┌──────────────────────────┼──────────────────────────┐
                    │                          │                          │
              ┌─────▼─────┐            ┌───────▼───────┐          ┌──────▼──────┐
              │ Bootstrap  │            │ V5 Orchestrator│          │   Skills    │
              │ Bundle     │            │ 认知管道        │          │  42 个技能   │
              │ (SOUL/USER │            │                │          │             │
              │ /TOOLS/... │            │ ① 消息分析      │          │ quant/xhs/  │
              │  → JSON)   │            │ ② 任务分解      │          │ browser/    │
              └────────────┘            │ ③ 推理链        │          │ video/...   │
                                        │ ④ 质量门控      │          └──────┬──────┘
                                        │ ⑤ 延迟记录      │                 │
                                        └───────┬───────┘                  │
                                                │                          │
                    ┌───────────────────────────┼──────────────────────────┤
                    │                           │                          │
              ┌─────▼─────┐            ┌────────▼────────┐         ┌──────▼──────┐
              │ 记忆系统    │            │   模型路由       │         │  效果追踪    │
              │            │            │                  │         │             │
              │ SESSION    │            │ DS V3.2 (主力)    │         │ SQLite      │
              │ MEMORY.md  │            │ DS Reasoner      │         │ 执行指标     │
              │ .reasoning │            │ Qwen3.5+ (图片)   │         │ 业务指标     │
              │ /SQLite    │            │ 3级 Fallback      │         │ 周报/月报    │
              └────────────┘            └─────────────────┘         └─────────────┘

文件结构

~/.xyvaclaw/
├── .openclaw/
│   └── openclaw.json          # Gateway 主配置
├── workspace/
│   ├── SOUL.md                # AI 人格定义
│   ├── IDENTITY.md            # AI 身份
│   ├── USER.md                # 用户画像
│   ├── AGENTS.md              # 核心操作规范 (V5.1)
│   ├── TOOLS.md               # 工具环境速查
│   ├── HEARTBEAT.md           # 心跳任务
│   ├── MEMORY.md              # 长期记忆
│   ├── SESSION-STATE.md       # 会话状态
│   ├── skills/                # 42 个技能模块
│   ├── scripts/               # V5 认知管道脚本
│   ├── memory/                # 每日记忆
│   ├── .reasoning/            # 推理库 (SQLite)
│   ├── .learnings/            # 学习记录
│   └── state/                 # 运行时状态
├── extensions/
│   ├── feishu/                # 112 TS 文件 — 飞书集成
│   └── lossless-claw/         # 无损上下文引擎
├── agents/                    # 多 Agent 配置
└── logs/                      # 运行日志

� 高级安装选项

无人值守安装

# macOS — 全自动
DEEPSEEK_API_KEY=sk-your-key \
  bash -c 'git clone https://github.com/xyva-yuangui/XyvaClaw.git && cd XyvaClaw && bash xyvaclaw-setup.sh --auto'

# Linux — 全自动
DEEPSEEK_API_KEY=sk-your-key \
  bash -c 'git clone https://github.com/xyva-yuangui/XyvaClaw.git && cd XyvaClaw && bash xyvaclaw-setup-linux.sh --auto'

系统要求

📖 文档

🤝 贡献

欢迎贡献！请参阅 CONTRIBUTING.md。

git clone https://github.com/xyva-yuangui/XyvaClaw.git
cd XyvaClaw && git checkout -b feature/your-feature
# 开发修改
git push origin feature/your-feature
# 在 GitHub 上提交 PR

📄 许可证

MIT License — 个人和商业使用均免费。

⭐ Star History

如果 xyvaClaw 对你有帮助，请给个 ⭐ 吧！这是我持续改进的动力。

If xyvaClaw helps you, please give it a ⭐! It motivates us to keep improving.