OpenClaw 部署实战：安装、配置与长任务策略

OpenClaw 是开源的长期值守型 AI Agent 框架，把 LLM 接到飞书/Telegram/Discord，配上本地文件系统、浏览器、定时任务，变成 7×24 可调度的工程助手。这篇文章整理我在 2 vCPU / 4 GB RAM VPS 上部署的实操经验。

一、安装

推荐路径

curl -fsSL https://openclaw.ai/install.sh | bash

自动检测系统、安装 Node（要求 24 或 22.14+）、安装 OpenClaw 并启动交互式引导。不想引导加 --no-onboard。

小 VPS 优化

低配机器启动慢，~/.bashrc 加：

export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1

缓存编译结果加速启动，跳过自重启减少开销。

二、配置

配置在 ~/.openclaw/openclaw.json，支持 JSON5。

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { feishu: { allowFrom: ["ou_xxx"] } },
}

编辑方式：交互式向导（openclaw configure）、CLI 单行（openclaw config set）、Control UI（http://127.0.0.1:18789）或直接改文件（Gateway 热重载）。

关键配置项

路径	作用	典型值
agents.defaults.workspace	工作目录	~/.openclaw/workspace
agents.defaults.heartbeat.every	心跳间隔	30m
session.dmScope	DM 隔离	per-channel-peer
tools.exec.timeoutSec	exec 超时	1800

三、Codex 集成

OpenClaw 擅长调度和轻量操作，Codex 擅长代码编写和复杂文件操作。分工原则：OpenClaw 是值班经理，Codex 是外包工程师。

MCP 配置：Codex 通过 MCP 连接 GitHub、Playwright、文档检索等工具。国内 VPS 需要 MCP 启动脚本走代理。

调用模式：

• 前台：exec 启动 Codex 等结果，适合 <1 分钟的短任务
• tmux 后台：通过 tmux 启动，日志持久化，OpenClaw 定期检查进度
• ACP 模式：sessions_spawn 启动持久化 Codex 会话，适合多轮编码

四、网关监控

Systemd 守护：systemctl --user enable openclaw-gateway。配合 watchdog 脚本 + timer 每 5 分钟检查存活，挂了就重启。

心跳巡检：Gateway 每 30 分钟触发 agent 自检，读 HEARTBEAT.md，检查任务停滞、服务异常、资源压力。没问题静默回复 HEARTBEAT_OK，有问题才通知。

Cron 定时任务：openclaw cron add 创建，持久化在 ~/.openclaw/cron/jobs.json，重启不丢。支持一次性和循环任务，可指定会话和推送渠道。

五、Agent 与 Skills

Agent 是完整的独立实例，有自己的工作空间、会话存储和 persona。核心文件：AGENTS.md（行为规则）、SOUL.md（人格）、USER.md（偏好）、HEARTBEAT.md（自检清单）、MEMORY.md（长期记忆）。

Skill 是一个含 SKILL.md 的目录，教 Agent 完成特定任务。加载优先级：workspace skills > ~/.openclaw/skills > 内置 skills。

四层分工：OpenClaw 负责调度监控，Codex 负责代码实现，Skills 把重复操作压缩成模板，Memory 把一次性发现沉淀成持久笔记。

六、长任务策略

用户发来"帮我重构这个项目"——可能 5-30 分钟。策略：

1. 立即回复确认（不跟工具调用混在同一步）
2. 后台 tmux 启动 Codex，日志持久化
3. 完成后读 Codex 日志，总结结果发给用户

原则：预估 <1 分钟前台同步；>1 分钟立即回复 + 后台执行 + 完成通知。低配机器同一时间只跑一个重任务。

七、省 Token

模型分层：fast（免费模型）跑心跳和轻量检查；main 跑日常工程；专用模型只在 UI 审查等特定场景临时切。

上下文管理：心跳开 lightContext 只注入 HEARTBEAT.md；压缩前自动写记忆确保关键信息不丢；避免重读大文件，用 tail/sed/精确行范围。

工作流：先理解再执行减少试错；回复不含无信息量的重复；文件修改一次改多处；重复流程压缩成脚本调用。

会话隔离：长任务用 isolated session，上下文短、生命周期短，不污染主会话。

八、部署检查清单

• openclaw doctor 验证环境
• systemd 守护 + watchdog timer
• 写好 AGENTS.md / SOUL.md / USER.md / HEARTBEAT.md
• Codex MCP + 代理验证连通
• 模型分三层：fast / main / 专用
• 长任务走后台 + 完成通知
• 定期维护 MEMORY.md

遇到问题查 docs.openclaw.ai，或去 Discord 社区 交流。