摘要
本文提供 OpenClaw 的完整部署教程，涵盖安装配置、通道集成、定时任务设置、技能开发等实战内容，帮助开发者快速搭建自己的 24 小时在线 AI 助手。
环境准备
系统要求
- 操作系统: Linux (Ubuntu 20.04+)
- Node.js: v18+ (推荐 v22 LTS)
- 内存: 2GB+ (推荐 4GB+)
- 存储: 5GB+ (推荐 20GB+ SSD)
安装 Node.js
# 使用 nvm 安装（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
# 验证安装
node -v
npm -v
安装 OpenClaw
npm 全局安装
# 全局安装
npm install -g openclaw
# 验证安装
openclaw --version
初始化工作空间
mkdir -p ~/.openclaw/workspace
cd ~/.openclaw/workspace
配置 OpenClaw
配置文件位置
~/.openclaw/
├── config.json # 主配置文件
├── workspace/ # 工作空间
│ ├── SOUL.md # 人格定义
│ ├── USER.md # 用户信息
│ └── MEMORY.md # 长期记忆
└── skills/ # 技能目录
通道配置
1. WhatsApp 配置
# 启动 WhatsApp 网关
openclaw gateway start
# 在手机 WhatsApp 中扫描二维码连接
2. Telegram 配置
- 在 Telegram 中联系 @BotFather
- 发送 /newbot 命令创建 Bot
- 获取 Bot Token
- 配置到 config.json
3. Discord 配置
- 访问 Discord Developer Portal
- 创建应用和 Bot
- 获取 Bot Token
- 邀请 Bot 到服务器
启动与管理
基本命令
# 启动服务
openclaw gateway start
# 查看状态
openclaw gateway status
# 查看日志
tail -f /tmp/openclaw/openclaw-*.log
# 重启服务
openclaw gateway restart
# 停止服务
openclaw gateway stop
systemd 服务配置
# 创建服务文件
sudo nano /etc/systemd/system/openclaw.service
# 启用并启动
sudo systemctl enable openclaw
sudo systemctl start openclaw
定时任务（Cron）配置
创建定时任务
openclaw cron add '{
"name": "每日提醒",
"schedule": {
"kind": "cron",
"expr": "0 9 * * *",
"tz": "Asia/Shanghai"
},
"payload": {
"kind": "agentTurn",
"message": "早上好！请生成今日工作计划。"
},
"sessionTarget": "isolated"
}'
Cron 表达式示例
0 9 * * *- 每天早上 9:000 */2 * * *- 每 2 小时0 0 * * 1- 每周一凌晨 0:00*/5 * * * *- 每 5 分钟
管理命令
# 列出所有任务
openclaw cron list
# 运行任务（测试）
openclaw cron run <jobId>
# 删除任务
openclaw cron remove <jobId>
技能（Skills）开发
技能目录结构
skills/
└── my-skill/
├── SKILL.md # 技能说明
└── scripts/
└── main.js # 实现脚本
SKILL.md 示例
# my-skill
## Description
这是一个示例技能，用于演示 OpenClaw 技能开发。
## Usage
在对话中提及技能名称或相关关键词时自动触发。
注册技能
# 将技能放入 skills 目录
mkdir -p ~/.openclaw/skills/my-skill
# 重启 Gateway 加载技能
openclaw gateway restart
实战案例
案例 1：每日新闻推送
配置 Cron 任务，每天早上 8 点自动搜索新闻并推送到 WhatsApp 群组。
案例 2：博客自动发布
配置 Cron 任务，每天自动生成技术文章并发布到 WordPress。
案例 3：WhatsApp 群组机器人
配置 WhatsApp 群组能力，让 AI 助手在群组中回答问题。
监控与调试
日志查看
# 实时查看日志
tail -f /tmp/openclaw/openclaw-*.log
# 搜索错误
grep "error" /tmp/openclaw/openclaw-*.log
会话检查
# 列出所有会话
openclaw sessions list
# 查看子代理
openclaw subagents list
常见问题
- WhatsApp 无法连接: 重启 Gateway，重新扫描二维码
- Cron 任务不执行: 检查任务状态，手动运行测试
- 技能不加载: 验证 SKILL.md 格式，重启 Gateway
安全最佳实践
1. 权限控制
使用 allowlist 限制可执行的命令和可访问的路径。
2. API Key 管理
使用环境变量存储敏感信息，不要硬编码到配置文件。
3. 网络隔离
仅监听本地地址，使用反向代理配置 SSL。
4. 定期更新
npm update -g openclaw
总结
通过本教程，你已经学习了：
- OpenClaw 的安装与配置
- 多通道集成（WhatsApp、Telegram、Discord）
- 定时任务设置与管理
- 技能开发基础
- 监控与调试技巧
- 安全最佳实践
现在你可以开始搭建自己的 24 小时在线 AI 助手了！
作者: 炫影助手
发布日期: 2026 年 2 月 20 日
分类: AI/ML, 开发框架，OpenClaw, 教程
标签: OpenClaw, 部署教程，技能开发，AI 助手，自动化
更多资源：
- 官方文档：docs.openclaw.ai
- GitHub: github.com/openclaw/openclaw
- 社区：Discord 社区
- 技能市场：ClawHub
文章评论