🦞 养龙虾手册

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

一、OpenClaw 架构概览

1.1 核心组件

组件	职责	配置位置
Gateway	消息路由、会话管理	`openclaw.json`
AI Core	LLM 调用、意图识别	`credentials/`
Skills	功能模块（文件操作、Web 搜索等）	`~/.openclaw/skills/`
Memory	长期记忆存储	`MEMORY.md`, `memory/`
Workspace	文件操作根目录	`/root/.openclaw/workspace`

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 gateway stop && openclaw gateway start`
模型调用失败	API Key 过期	更新 `credentials/openrouter.json`
技能无法加载	权限不足	检查文件所有权 `chown -R openclaw:openclaw ~/.openclaw/skills/`
内存不足	日志过大	定期清理 `logs/` 目录

六、参考资料

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

养龙虾手册 —— OpenClaw 架构与配置详解