🦞 养龙虾手册

📌 什么是”龙虾”？
本文中的”龙虾”指的是 OpenClaw —— 一只全能的 AI 自动化助手。它能够运行在你的服务器上，执行测试、部署、监控、通知等任务。本手册将带你深入了解它的内部构造和配置技巧。

一、OpenClaw 架构概览

1.1 核心组件

1.2 数据流向

graph LR
    A[用户消息] --> B(Gateway)
    B --> C{意图识别}
    C -->|简单指令| D[直接执行]
    C -->|复杂任务| E[AI 规划]
    E --> F[分步执行]
    F --> G[结果返回]
    D --> G
    G --> H[用户]

二、配置文件详解

2.1 openclaw.json 基础设置

{
  "gateway": {
    "port": 18170,
    "host": "0.0.0.0"
  },
  "models": {
    "default": "openrouter/stepfun/step-3.5-flash:free",
    "fallback": [
      "opencode/minimax-m2.5-free",
      "openrouter/z-ai/glm-4.5-air:free"
    ]
  },
  "workspace": "/root/.openclaw/workspace",
  "credentials": "./credentials"
}

::: warning⚠️ 安全性建议
切勿将 credentials/ 目录提交到 Git。该目录包含 API Key 和敏感配置。在 .gitignore 中确保已添加。 :::

2.2 技能管理

OpenClaw 的技能位于 ~/.openclaw/skills/ 或全局路径 /usr/lib/node_modules/openclaw/skills/。每个技能必须包含 SKILL.md 说明其用途和使用方法。

技能安装来源

• ClawdHub: 官方技能市场 https://clawhub.com
• GitHub: 任意开源仓库（需通过 skill-vetter 审计）
• 本地: 直接复制到 skills 目录

三、记忆系统

3.1 文件缓存

• MEMORY.md: 长期记忆（仅主会话加载）
• memory/YYYY-MM-DD.md: 每日日志
• HEARTBEAT.md: 心跳任务检查清单

3.2 PowerMem 集成

PowerMem 使用 OpenRouter API 实现向量检索。轻量版部署后，可通过 memory_recall 工具搜索历史记录。

四、自动化与 Crontab

OpenClaw 的健康检查脚本 healthcheck_suite.sh 可用于定时任务：

# 每天 13:00 执行健康检查并通知
0 13 * * * /root/.openclaw/workspace/healthcheck_suite.sh | /usr/bin/openclaw notify

💡 提示
所有定时任务执行后，记得主动向用户发送结果通知，否则任务”白跑了”。

五、常见问题排查

六、参考资料

• OpenClaw 官方文档
• GitHub 仓库
• 社区 Discord

🪄 保持好奇心，享受养龙虾的乐趣！