453 lines
9.3 KiB
Markdown
453 lines
9.3 KiB
Markdown
# 🤖 机器人标准化部署流程
|
||
|
||
> 创建时间: 2026-02-08
|
||
> 版本: v1.0
|
||
> 目标: 新建机器人的标准化配置指南
|
||
|
||
---
|
||
|
||
## 一、新建机器人检查清单
|
||
|
||
### 1.1 系统准备
|
||
|
||
```
|
||
□ 操作系统: Ubuntu 20.04+ / Debian 11+
|
||
□ 硬件要求:
|
||
- CPU: 2核心+
|
||
- 内存: 4GB+
|
||
- 存储: 20GB+
|
||
□ 网络: 能访问互联网
|
||
|
||
检查命令:
|
||
cat /etc/os-release
|
||
free -h
|
||
df -h
|
||
```
|
||
|
||
### 1.2 OpenClaw 安装
|
||
|
||
```bash
|
||
# 方式A: 全新安装
|
||
curl -sSf https://get.openclaw.ai | sh
|
||
|
||
# 方式B: 手动安装
|
||
git clone https://github.com/openclaw/openclaw.git
|
||
cd openclaw
|
||
npm install -g openclaw
|
||
```
|
||
|
||
### 1.3 基础配置
|
||
|
||
```
|
||
□ 创建 systemd 服务
|
||
□ 配置代理（如需要）
|
||
□ 设置防火墙规则
|
||
□ 配置 SSH 访问
|
||
```
|
||
|
||
---
|
||
|
||
## 二、必要设计（必选）
|
||
|
||
### 2.1 人格配置（SOUL.md）
|
||
|
||
**位置**: `/root/.openclaw/identity/SOUL.md`
|
||
|
||
**必要内容**:
|
||
|
||
```markdown
|
||
# SOUL.md - 机器人灵魂
|
||
|
||
## Core Truths
|
||
**核心定位** - 简明扼要描述机器人身份
|
||
|
||
## Boundaries
|
||
- **安全第一** - 不执行危险命令
|
||
- **诚实为本** - 做就是做，没做就是没做
|
||
- **记忆管理** - 重要信息记录到 MEMORY.md
|
||
|
||
## Vibe
|
||
- **风格** - 专业/简洁/稳重
|
||
- **沟通方式** - 直接给答案/不说废话
|
||
```
|
||
|
||
**诚实原则（必须包含）**:
|
||
```
|
||
=================================================================
|
||
🛡️ 诚实原则 - 最高优先级
|
||
=================================================================
|
||
|
||
1. 做就是做，没做就是没做
|
||
2. 必须提供证据（文件路径、日志、命令输出）
|
||
3. 分清状态（进行中≠已完成）
|
||
4. 禁止模糊回答（大概、可能、应该）
|
||
=================================================================
|
||
```
|
||
|
||
### 2.2 AGENTS.md 人格注入
|
||
|
||
**位置**: `/root/.openclaw/workspace/AGENTS.md`
|
||
|
||
**必要内容**:
|
||
```markdown
|
||
# AGENTS.md - 会话人格配置
|
||
|
||
## 核心人格注入
|
||
|
||
### 诚实原则（必须遵守）
|
||
[复制 SOUL.md 中的诚实原则]
|
||
|
||
### 机器人人格配置
|
||
身份: [名称]
|
||
风格: [风格描述]
|
||
核心职责:
|
||
1. [职责1]
|
||
2. [职责2]
|
||
3. [职责3]
|
||
|
||
### 会话启动规则
|
||
每次新会话启动时：
|
||
1. 读取 AGENTS.md
|
||
2. 读取 SOUL.md
|
||
3. 读取 USER.md
|
||
4. 读取 MEMORY.md
|
||
5. 注入系统提示
|
||
```
|
||
|
||
### 2.3 用户偏好（USER.md）
|
||
|
||
**位置**: `/root/.openclaw/identity/USER.md`
|
||
|
||
**模板**:
|
||
```markdown
|
||
# USER.md - 用户偏好
|
||
|
||
## 用户信息
|
||
- **Name**: [用户名]
|
||
- **Platform**: Telegram/WhatsApp/...
|
||
- **Timezone**: Asia/Shanghai
|
||
|
||
## 偏好设置
|
||
- **主力模型**: MiniMax/DeepSeek/...
|
||
- **沟通风格**: 简洁/详细/技术向
|
||
- **特殊要求**: [如有]
|
||
|
||
## 注意事项
|
||
- [重要提醒]
|
||
```
|
||
|
||
---
|
||
|
||
## 三、标准化配置流程
|
||
|
||
### 3.1 目录结构
|
||
|
||
```
|
||
/root/.openclaw/
|
||
├── openclaw.json # 系统配置
|
||
├── agents/ # Agent配置
|
||
│ └── main/
|
||
│ └── sessions/ # 会话文件
|
||
├── identity/ # 身份配置
|
||
│ ├── IDENTITY.md # 身份定义
|
||
│ ├── SOUL.md # 灵魂/人格
|
||
│ └── USER.md # 用户偏好
|
||
├── memory/ # 记忆存储
|
||
│ └── main.sqlite
|
||
├── workspace/ # 工作区
|
||
│ ├── AGENTS.md # 人格注入
|
||
│ ├── MEMORY.md # 长期记忆
|
||
│ └── sleep-learning/ # 自动学习
|
||
├── scripts/ # 脚本
|
||
│ ├── disaster-backup.sh # 灾难备份
|
||
│ ├── problem-detector.sh # 问题检测
|
||
│ └── auto-learning.sh # 自动学习
|
||
└── backups/ # 备份
|
||
```
|
||
|
||
### 3.2 配置文件模板
|
||
|
||
#### openclaw.json 必要配置
|
||
|
||
```json
|
||
{
|
||
"name": "机器人名称",
|
||
"channels": {
|
||
"telegram": {
|
||
"token": "YOUR_TOKEN"
|
||
}
|
||
},
|
||
"providers": {
|
||
"minimax": {
|
||
"models": { "default": "minimax-minimax" }
|
||
}
|
||
},
|
||
"memorySearch": {
|
||
"provider": "openai",
|
||
"model": "nomic-embed-text:latest"
|
||
}
|
||
}
|
||
```
|
||
|
||
#### cron 必要任务
|
||
|
||
```bash
|
||
# 1. 问题检测（每5分钟）
|
||
*/5 * * * * /root/.openclaw/scripts/problem-detector.sh
|
||
|
||
# 2. 灾难备份（每周日）
|
||
0 3 * * 0 /root/.openclaw/scripts/disaster-backup.sh backup
|
||
```
|
||
|
||
---
|
||
|
||
## 四、功能模块（可选）
|
||
|
||
### 4.1 核心功能（推荐）
|
||
|
||
| 功能 | 脚本 | 优先级 | 说明 |
|
||
|------|------|--------|------|
|
||
| **问题检测** | problem-detector.sh | P0 | 自动发现问题 |
|
||
| **灾难备份** | disaster-backup.sh | P0 | 系统恢复保障 |
|
||
| **自动学习** | auto-learning.sh | P1 | 持续知识更新 |
|
||
|
||
### 4.2 增强功能（可选）
|
||
|
||
| 功能 | 脚本 | 说明 |
|
||
|------|------|------|
|
||
| **混合学习** | hybrid-learning.sh | 定时+问题双模式 |
|
||
| **知识图谱** | update-knowledge-graph.sh | 知识体系可视化 |
|
||
| **强制反思** | robot-force-reflection.sh | 深度反思机制 |
|
||
|
||
### 4.3 监控功能（可选）
|
||
|
||
| 功能 | 脚本 | 说明 |
|
||
|------|------|------|
|
||
| **系统监控** | system-monitor.sh | CPU/内存/磁盘 |
|
||
| **会话监控** | session-monitor.sh | 会话文件大小 |
|
||
| **告警通知** | send-alert.sh | Telegram通知 |
|
||
|
||
---
|
||
|
||
## 五、新建机器人标准流程
|
||
|
||
### Step 1: 系统准备
|
||
```bash
|
||
# 1. SSH连接到新机器
|
||
ssh user@new_robot_ip
|
||
|
||
# 2. 创建工作目录
|
||
mkdir -p /root/.openclaw/{identity,workspace/sleep-learning,scripts,backups}
|
||
|
||
# 3. 安装OpenClaw
|
||
curl -sSf https://get.openclaw.ai | sh
|
||
```
|
||
|
||
### Step 2: 复制标准配置
|
||
```bash
|
||
# 从模板机器复制
|
||
scp template:/root/.openclaw/identity/*.md new:/root/.openclaw/identity/
|
||
scp template:/root/.openclaw/workspace/AGENTS.md new:/root/.openclaw/workspace/
|
||
scp template:/root/.openclaw/scripts/*.sh new:/root/.openclaw/scripts/
|
||
|
||
# 设置权限
|
||
chmod +x /root/.openclaw/scripts/*.sh
|
||
```
|
||
|
||
### Step 3: 配置个性化参数
|
||
```bash
|
||
# 编辑openclaw.json
|
||
vim /root/.openclaw/openclaw.json
|
||
|
||
# 编辑SOUL.md（修改机器人名称和定位）
|
||
vim /root/.openclaw/identity/SOUL.md
|
||
|
||
# 编辑USER.md（修改用户信息）
|
||
vim /root/.openclaw/identity/USER.md
|
||
```
|
||
|
||
### Step 4: 配置定时任务
|
||
```bash
|
||
# 添加cron任务
|
||
crontab -e
|
||
|
||
# 添加:
|
||
*/5 * * * * /root/.openclaw/scripts/problem-detector.sh
|
||
0 3 * * 0 /root/.openclaw/scripts/disaster-backup.sh backup
|
||
```
|
||
|
||
### Step 5: 启动服务
|
||
```bash
|
||
# 启动OpenClaw
|
||
openclaw gateway start
|
||
|
||
# 验证运行
|
||
openclaw status
|
||
```
|
||
|
||
### Step 6: 功能测试
|
||
```bash
|
||
# 测试问题检测
|
||
/root/.openclaw/scripts/problem-detector.sh
|
||
|
||
# 测试备份
|
||
/root/.openclaw/scripts/disaster-backup.sh status
|
||
|
||
# 测试自动学习（可选）
|
||
/root/.openclaw/scripts/auto-learning.sh 1
|
||
```
|
||
|
||
---
|
||
|
||
## 六、配置验证清单
|
||
|
||
### 6.1 人格配置验证
|
||
|
||
```bash
|
||
# 检查SOUL.md
|
||
cat /root/.openclaw/identity/SOUL.md | grep "诚实原则"
|
||
|
||
# 检查AGENTS.md
|
||
cat /root/.openclaw/workspace/AGENTS.md | grep "诚实原则 - 最高优先级"
|
||
|
||
# 检查USER.md
|
||
cat /root/.openclaw/identity/USER.md
|
||
```
|
||
|
||
### 6.2 定时任务验证
|
||
|
||
```bash
|
||
# 查看cron
|
||
crontab -l | grep -E "problem|disaster"
|
||
|
||
# 预期输出:
|
||
# */5 * * * * /root/.openclaw/scripts/problem-detector.sh
|
||
# 0 3 * * 0 /root/.openclaw/scripts/disaster-backup.sh backup
|
||
```
|
||
|
||
### 6.3 服务状态验证
|
||
|
||
```bash
|
||
# 检查Gateway
|
||
openclaw status | grep Running
|
||
|
||
# 检查日志
|
||
tail -f /tmp/openclaw/openclaw-*.log
|
||
```
|
||
|
||
---
|
||
|
||
## 七、常见问题处理
|
||
|
||
### Q1: SOUL.md 诚实原则不生效
|
||
```bash
|
||
# 确认AGENTS.md存在且包含注入
|
||
cat /root/.openclaw/workspace/AGENTS.md | grep "诚实原则 - 最高优先级"
|
||
|
||
# 如果不存在，从模板复制
|
||
scp template:/root/.openclaw/workspace/AGENTS.md new:/root/.openclaw/workspace/
|
||
```
|
||
|
||
### Q2: 定时任务不执行
|
||
```bash
|
||
# 检查cron服务
|
||
systemctl status cron
|
||
|
||
# 手动测试
|
||
/root/.openclaw/scripts/problem-detector.sh
|
||
|
||
# 查看日志
|
||
cat /var/log/openclaw/problem-detector.log
|
||
```
|
||
|
||
### Q3: 备份失败
|
||
```bash
|
||
# 检查备份目录权限
|
||
ls -la /root/.openclaw/backups/
|
||
|
||
# 手动执行
|
||
/root/.openclaw/scripts/disaster-backup.sh backup
|
||
|
||
# 查看错误
|
||
cat /var/log/openclaw/backup.log
|
||
```
|
||
|
||
---
|
||
|
||
## 八、最小配置 vs 完整配置
|
||
|
||
### 最小配置（必选）
|
||
```
|
||
必须:
|
||
✓ openclaw.json
|
||
✓ SOUL.md
|
||
✓ AGENTS.md
|
||
✓ USER.md
|
||
✓ disaster-backup.sh
|
||
✓ cron备份任务
|
||
|
||
可选:
|
||
✗ 自动学习
|
||
✗ 问题检测
|
||
✗ 知识图谱
|
||
```
|
||
|
||
### 完整配置（推荐）
|
||
```
|
||
核心:
|
||
✓ openclaw.json
|
||
✓ SOUL.md (含诚实原则)
|
||
✓ AGENTS.md
|
||
✓ USER.md
|
||
✓ identity/
|
||
|
||
自动化:
|
||
✓ disaster-backup.sh (备份)
|
||
✓ problem-detector.sh (检测)
|
||
✓ auto-learning.sh (学习)
|
||
|
||
增强:
|
||
✓ hybrid-learning.sh (混合学习)
|
||
✓ update-knowledge-graph.sh (知识图谱)
|
||
✓ force-reflection.sh (深度反思)
|
||
```
|
||
|
||
---
|
||
|
||
## 九、模板机器信息
|
||
|
||
### 守护者（模板机）
|
||
- **IP**: 192.168.0.32
|
||
- **路径**: /root/.openclaw/
|
||
- **用途**: 配置模板来源
|
||
|
||
### 青龙（模板机）
|
||
- **IP**: 192.168.0.31
|
||
- **路径**: /root/.openclaw/
|
||
- **用途**: 配置模板来源
|
||
|
||
---
|
||
|
||
## 十、快速部署命令
|
||
|
||
```bash
|
||
# 从守护者复制所有配置到新机器
|
||
./deploy-robot.sh new_robot_ip
|
||
|
||
# 脚本内容:
|
||
#!/bin/bash
|
||
IP=$1
|
||
ssh user@$IP "mkdir -p /root/.openclaw/{identity,workspace/sleep-learning,scripts,backups}"
|
||
scp /root/.openclaw/identity/*.md user@$IP:/root/.openclaw/identity/
|
||
scp /root/.openclaw/workspace/AGENTS.md user@$IP:/root/.openclaw/workspace/
|
||
scp /root/.openclaw/scripts/*.sh user@$IP:/root/.openclaw/scripts/
|
||
ssh user@$IP "chmod +x /root/.openclaw/scripts/*.sh"
|
||
echo "✅ 部署完成"
|
||
```
|
||
|
||
---
|
||
|
||
> 文档版本: v1.0
|
||
> 最后更新: 2026-02-08
|
||
> 维护者: 守护者
|