智能体部署检查清单

面向专用硬件（Mac Mini、Linux 服务器）的 AI 智能体基础设施生产级部署框架。每次部署均严格遵循同一套五层堆栈，绝不允许跳过任一环节。

五层部署堆栈

每个智能体部署均由五个按序应用的层级构成。任何一层均不可省略。每一层均设有二元制通过/失败关卡（Pass/Fail Gate），仅当本层全部验证通过后，方可进入下一层。

第一层：基础操作系统 + OpenClaw 安装（脚本化）

目标：获得一台洁净的机器，且 OpenClaw 运行时环境已就绪。

检查清单：

• 全新操作系统安装，或已确认处于洁净状态
• 已更新至最新稳定版操作系统补丁
• 已安装 Xcode 命令行工具（macOS）
• 已安装并更新 Homebrew（macOS）
• 已通过 nvm 安装 Node.js LTS 版本
• 已安装 Python 3.11 或更高版本
• 已配置 Git 并设置部署专用密钥（deploy key）
• 已安装并验证 OpenClaw CLI
• 已安装并完成 Claude Code 授权
• 已在 ~/.openclaw/workspace 创建工作目录
• 已为此机器生成 SSH 密钥对

脚本模板：

#!/bin/bash
# layer-1-base-install.sh
set -euo pipefail

echo "=== 第一层：基础安装 ==="

# macOS 专属步骤
xcode-select --install 2>/dev/null || true
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update && brew upgrade

# 运行时依赖
brew install nvm python@3.11 git jq
nvm install --lts
nvm use --lts

# OpenClaw 工作区
mkdir -p ~/.openclaw/workspace
cd ~/.openclaw/workspace
git init

echo "第一层安装完成。请验证：node --version && python3 --version && git --version"

关卡要求：执行 node --version 返回 LTS 版本，python3 --version 返回 3.11+ 版本，且在工作目录中可正常执行 git status。

第二层：IAM 配置（人工精细配置）

目标：为当前特定客户/部署配置身份认证、访问权限及 API 密钥。

该层始终需人工完成——严禁脚本化——因为每位客户的访问模式均不相同。

检查清单：

• 已配发 API 密钥（Anthropic、OpenAI 等，按需）
• API 密钥已存入环境变量（严禁写入文件）
• 已创建 .env 文件，并设置正确权限（chmod 600）
• 已创建客户专属服务账号
• 已配置 MCP 服务器凭证
• GitHub/GitLab 访问令牌已限定于客户专属代码仓库范围
• 邮件/日历集成已完成授权（OAuth 令牌）
• QuickBooks / 财务系统集成已连接（如适用）
• 所有凭证均已通过真实 API 调用完成测试
• 已记录密钥轮换周期计划

核心原则：客户须自行承担其 API 密钥与许可证费用。我们绝不跨客户共享密钥。

# 验证所有凭证是否有效
echo "正在测试 Anthropic API..."
curl -s https://api.anthropic.com/v1/messages 
  -H "x-api-key: $ANTHROPIC_API_KEY" 
  -H "content-type: application/json" 
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":10,"messages":[{"role":"user","content":"ping"}]}' 
  | jq '.content[0].text'

echo "正在测试 GitHub 访问权限..."
gh auth status

关卡要求：所有已配置的 API 密钥均返回有效响应。不允许出现 401 或 403 错误。

第三层：客户专属软件（依场景而异）

目标：安装并配置该客户所需的全部工具。

该层随部署场景变化而不同。常见模式如下：

面向会计/记账类客户：

• 已配置 QuickBooks MCP 服务器（默认为只读）
• 已部署财务报表模板
• 已配置税务日历定时任务（cron）

面向营销/内容类客户：

• 已连接 CMS 集成
• 已配置社交媒体 API 访问权限
• 已关联数据分析仪表板

面向开发团队类客户：

• 已配置 CI/CD 流水线访问权限
• 已设置代码审查自动化流程
• 已连接部署通知渠道

面向法律/合规类客户：

• 已接入文档管理系统
• 已配置合规日历
• 已启用审计追踪日志记录

关卡要求：客户专属测试套件全部通过。各集成模块均返回预期数据。

第四层：安全加固（每次部署必做）

目标：将机器锁定至生产环境安全标准。

检查清单：

• 已启用并配置防火墙（仅开放必需端口）
• 已实施 SSH 加固：
  • 已禁用密码认证
  • 已禁用 root 登录
  • 已强制启用密钥认证
  • 已配置非标准 SSH 端口
• 已启用磁盘加密（macOS 启用 FileVault，Linux 启用 LUKS）
• 已启用自动安全更新
• 已安装并配置 Fail2ban 或同类防护工具
• 已配置日志轮转
• 已启用文件完整性监控
• .env 及凭证文件权限已设为 600
• Git 历史中无任何凭证信息（通过 git log --all -p | grep -i "api_key|secret|password" 验证）
• SOUL、IDENTITY、USER、AGENTS 文件标记为“神圣文件”（严禁脱离当前运行环境）
• 已配置出站网络白名单（仅允许已知 API 终端节点）

macOS 防火墙脚本：

#!/bin/bash
# layer-4-firewall.sh
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --setglobalstate on
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --setblockall on
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --setallowsigned on
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --setstealthmode on
echo "防火墙已配置完成。验证命令：sudo /usr/libexec/ApplicationFirewall/socketfilterfw --getglobalstate"

关卡要求：安全审计脚本返回等级为 A 或 B。C 级及以下视为未通过。

第五层：上线启动 —— 首日交付

目标：客户可立即与智能体交互，并即时感知价值。

检查清单：

• 已搭建五文件记忆系统骨架（详见下文）
• 已安装并验证初始定时任务（cron）
• 健康检查服务正在运行并上报状态
• 已完成客户现场引导（30 分钟实时会话）
• 客户可自主向智能体提问并获得响应
• 在客户见证下，已完成首个真实任务
• 已明确记录紧急联系人及升级路径
• 客户已获取支持通道链接
• 已预约首周回访时间

首日演示规范：必须现场执行一项真实任务。非预演式演示，非脚本化复现。应从客户实际工作流中选取任务并当场完成。这是建立信任的根本方式。

关卡要求：客户在无人协助的情况下，独立向智能体提出问题并获得有用答复。

预搭建五文件记忆系统

每次部署均以相同的五个文件作为起点。它们是空白模板，而非样板代码——智能体将在运行过程中自主填充内容。

SOUL.md 模板

# SOUL

## Identity
你是 [CLIENT_NAME] 的 AI 运营智能体，由 IAM Solutions 部署。

## Core Values
- 准确性优先于速度
- 先询问，再假设
- 绝对保护客户数据
- 持续学习与改进

## Boundaries
- 绝不在本环境之外共享客户数据
- 未经明确批准，绝不执行任何财务交易
- 未经确认，绝不修改生产系统
- 存疑时，立即升级至人工处理

## Communication Style
[根据客户偏好，在上线阶段校准]

IDENTITY.md 模板

# IDENTITY

## Deployment
- 部署时间：[DATE]
- 硬件：[MACHINE_SPEC]
- 位置：[PHYSICAL_OR_CLOUD_LOCATION]
- 运维方：IAM Solutions

## Capabilities
[依据第三层所安装集成项动态填充]

## Limitations
[依据上线阶段明确界定的范围进行文档化]

USER.md 模板

# USER

## Primary User
- 姓名：[CLIENT_NAME]
- 角色：[CLIENT_ROLE]
- 沟通偏好：[EMAIL/SLACK/SMS]

## Access Pattern
[客户典型交互方式与时频——首周后填充]

## Domain Knowledge
[客户擅长领域 vs. 需更多解释的领域——持续累积填充]

AGENTS.md 模板

# AGENTS

## Active Agents
[运行中智能体列表、角色及调度安排——第三层部署期间填充]

## Agent Communication
[智能体间协同机制、记忆共享方式、升级策略——部署阶段配置]

MEMORY.md 模板

# MEMORY

[CLIENT_NAME] 部署的记忆索引。
创建时间：[DATE]

## Memories
[智能体运行期间创建的记忆条目索引]

初始定时任务（Cron）模板

每次部署至少包含以下三项定时任务。

健康检查（每 4 小时执行一次）

# health-check.cron
# 每 4 小时运行一次，报告系统健康状态
0 */4 * * * /path/to/health-check.sh >> /var/log/openclaw/health.log 2>&1

#!/bin/bash
# health-check.sh
GRADE="A"
ISSUES=""

# 检查磁盘空间
DISK_USAGE=$(df -h / | awk 'NR==2 {print $5}' | tr -d '%')
if [ "$DISK_USAGE" -gt 90 ]; then GRADE="F"; ISSUES+="磁盘使用率 >90%。";
elif [ "$DISK_USAGE" -gt 80 ]; then GRADE="C"; ISSUES+="磁盘使用率 >80%。"; fi

# 检查内存
# 检查 API 连通性
# 检查定时任务运行状态
# 检查日志文件大小

echo "$(date): 健康等级：$GRADE ${ISSUES:-无异常}"

记忆维护（每日凌晨 2 点执行）

# memory-maintenance.cron
0 2 * * * /path/to/memory-maintenance.sh >> /var/log/openclaw/memory.log 2>&1

#!/bin/bash
# memory-maintenance.sh
# 压缩旧会话日志
# 存档 30 天前的记忆文件
# 验证 MEMORY.md 索引与实际文件一致性
# 报告记忆文件数量及总大小

MEMORY_DIR="$HOME/.openclaw/workspace/memory"
FILE_COUNT=$(find "$MEMORY_DIR" -name "*.md" | wc -l)
TOTAL_SIZE=$(du -sh "$MEMORY_DIR" | awk '{print $1}')
echo "$(date): 记忆文件数：$FILE_COUNT，总大小：$TOTAL_SIZE"

备份（每日凌晨 3 点执行）

# backup.cron
0 3 * * * /path/to/backup.sh >> /var/log/openclaw/backup.log 2>&1

#!/bin/bash
# backup.sh
BACKUP_DIR="/backups/openclaw/$(date +%Y-%m-%d)"
mkdir -p "$BACKUP_DIR"

# 备份工作区（排除 node_modules 和 .git/objects）
rsync -a --exclude='node_modules' --exclude='.git/objects' 
  "$HOME/.openclaw/workspace/" "$BACKUP_DIR/workspace/"

# 备份定时任务定义
crontab -l > "$BACKUP_DIR/crontab.bak"

# 保留最近 30 天备份
find /backups/openclaw -maxdepth 1 -type d -mtime +30 -exec rm -rf {} \;

echo "$(date): 备份完成，目标路径：$BACKUP_DIR"

硬件要求

最低配置（单智能体部署）

推荐配置（多智能体部署）

网络配置

出站白名单（最小集）：
- api.anthropic.com（Anthropic API）
- api.openai.com（如使用 OpenAI 模型）
- github.com（代码仓库）
- api.github.com（GitHub API）
- smtp.gmail.com（邮件服务，如适用）
- quickbooks.api.intuit.com（QBO，如适用）

入站配置：
- SSH（非标准端口，仅限密钥认证）
- 典型部署无需开放其他入站端口

部署后监控

第 1 周：每日回访

• 智能体响应是否准确？
• 定时任务是否按时执行？
• 日志中是否存在错误？
• 客户满意度如何？

第 2–4 周：每周两次回访

• 记忆系统是否按预期增长？
• 性能是否稳定？
• 是否产生新的集成需求？

第 2 个月起：每周回访

• 健康等级趋势分析
• 备份完整性验证
• 安全更新状态核查
• 客户功能需求收集

部署反模式

禁止行为：

• 跨客户共享 API 密钥。每位客户须自行购买并管理密钥。无例外。
• 跳过第四层（安全加固）。“这只是测试部署”正是安全漏洞的起源。
• 复制其他客户的 SOUL.md 文件。每个部署都必须拥有专为客户定制的全新身份。
• 首日即启用写权限。初始阶段应严格限制为只读；写权限需经可靠性验证后逐步授予。
• 未配置健康检查定时任务即部署。无法监控的系统，不应上线。
• 在第三层完成前承诺具体功能。须先明确部署范围，再据此作出承诺。