OpenClaw 新手指南:从零开始的 AI 机器人搭建完全攻略
想随时随地通过微信、飞书、Telegram 等平台与 AI 助手对话?OpenClaw 帮你实现。
为什么选择 OpenClaw?
OpenClaw 是一个开源的自托管 AI 网关,让你可以在自己服务器上运行一个 central hub,连接所有聊天平台到强大的 AI 模型(如 Claude、GPT、Pi、Kimi 等)。
核心优势:
- ✅ 数据完全掌控(自托管,隐私安全)
- ✅ 多平台统一管理(一个网关服务所有渠道)
OpenClaw 新手指南:从零开始的 AI 机器人搭建完全攻略 > 想随时随地通过微信、飞书、Telegram 等平台与 AI 助手对话?OpenClaw 帮你实现。 为什么选择 OpenClaw? OpenClaw 是一个开源的自托管 AI 网关,让你可以在自己服务器上运行一个 central hub,连接所有聊天平台到强大的 AI 模型(如 Claude、GPT、Pi、Kimi 等)。 **…
想随时随地通过微信、飞书、Telegram 等平台与 AI 助手对话?OpenClaw 帮你实现。
OpenClaw 是一个开源的自托管 AI 网关,让你可以在自己服务器上运行一个 central hub,连接所有聊天平台到强大的 AI 模型(如 Claude、GPT、Pi、Kimi 等)。
核心优势:
适用场景: 第一次使用,5分钟内启动
# 1. 安装 Node.js 22+ nvm install22 nvm use 22# 2. 快速安装npminstall -g openclaw # 3. 启动向导(首次运行) openclaw onboard
向导会问:
5分钟后,你的第一个 AI 机器人就上线了。
适用场景: 同时运营多个社群
配置示例 ~/.openclaw/openclaw.json:
{"channels":{"telegram":{"accounts":{"default":{"token":"YOUR_TELEGRAM_BOT_TOKEN"},"alerts":{"token":"YOUR_ALERT_BOT_TOKEN","name":"Alert Bot"}}},"discord":{"accounts":{"work":{"token":"YOUR_DISCORD_BOT_TOKEN"}}},"feishu":{"accounts":{"default":{"app_id":"cli_xxxxx","app_secret":"xxxxx","encrypt_key":"xxxxx","verification_token":"xxxxx"}}}}}
实用技巧:
channels list 命令查看所有已配置渠道适用场景: 定时提醒、自动生成报告
# 1. 添加早晨提醒任务 openclaw cronadd\ --name "晨间提醒"\ --cron "0 9 * * *"\ --system-event "早安!今天有哪些重要任务?"# 2. 添加每周总结任务 openclaw cronadd\ --name "每周总结"\ --cron "0 17 * * 5"\ --agent-turn "汇总本周任务完成情况,生成报告"
高级选项:
--at 1735689600:绝对时间(Unix 时间戳)--every 1h:每小时执行一次--deliver:通知到指定渠道适用场景: AI 记住用户偏好、项目信息
记忆文件结构:
~/.openclaw/workspace/ ├── MEMORY.md # 长期记忆 └── memory/ ├── 2026-02-17.md # 每日日志 └── 2026-02-18.md
MEMORY.md 示例:
# 用户信息 **姓名:** 小纯 **时区:** GMT+8 **联系方式:** 飞书 ### 偏好 - 喜欢详细的说明和可视化例子 - 注重美学和流畅的动画 - 偏好科技/科幻风格
使用方法:
# 搜索记忆 openclaw memory search "项目进度"# 重建索引 openclaw memory index
价值: AI 能根据记忆了解用户,提供更个性化的回复。
适用场景: 文件操作、数据抓取自动处理
# 在对话中直接命令 AI: 你:帮我监控这个网站的价格变化,如果低于 100 元通知我 AI:我来设置监控脚本... # AI 会创建这样的脚本:# ~workspace/price-monitor.shcd ~workspace &&cat> price-monitor.sh <<'EOF' #!/bin/bash PRICE=$(curl -s https://example.com/product | grep -oP 'price: \K[0-9]+') if [ $PRICE -lt 100 ]; then openclaw message send \ --channel feishu \ --message "价格已降至 $PRICE!" fi EOFchmod +x price-monitor.sh # 然后添加到 Cron openclaw cronadd\ --name "价格监控"\ --cron "0 */6 * * *"\ --agent-turn "运行价格监控脚本"
适用场景: 智能家居、车载系统
当前支持:
配置示例:
{"voice":{"enabled":true,"provider":"elevenlabs","apiKey":"YOUR_API_KEY","voiceId":"your-voice-id"}}
唤醒词设置:
在对话中 AI 会等待特定短语:
适用场景: 自动化网页操作、数据抓取
# 启动浏览器(命令行或对话中) openclaw browser start # 在对话中: 你:帮我打开 GitHub,搜索 OpenClaw,统计 Star 数 AI:正在操作浏览器... (自动点击、搜索、读取数据) 你:GitHub 上 OpenClaw 的 Star 数是 8,732
场景举例:
适用场景: 集成企业内部系统
插件结构:
~workspace/skills/my-plugin/ ├── SKILL.md ├── index.ts └── package.json
SKILL.md 示例:
--- name: "my-company-integration" description: "公司内部系统集成" --- # 使用场景 - 自动化 HR 工作流 - 工单系统自动化 # 如何使用 直接在对话中:帮我创建一个 Jira 工单
插件自动激活:
当对话匹配描述时,AI 会自动启用插件功能和对应工具(可调用外部 API 等)。
适用场景: 24/7 部署,确保服务稳定
# 检查网关状态 openclaw status # 检查渠道健康 openclaw channels status --probe # 检查日志 openclaw logs --follow
关键指标:
✓ 网关是否运行
✓ 渠道是否连接
✓ Token 余额
✓ 内存/CPU 使用
自动化监控:
openclaw cronadd\ --name "健康检查"\ --cron "0 */4 * * *"\ --agent-turn "检查服务健康状态,若有异常通知我"
适用场景: 企业部署,多人共用
{"channels":{"discord":{"accounts":{"default":{"token":"YOUR_TOKEN","allowFrom":["user:123","user:456"],"groups":{"work-team":{"allowFrom":["role:admin"]}}}}}}}
权限类型:
1. 快速配置备份
#!/bin/bashDATE=$(date +%Y%m%d)cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.$DATEecho"配置已备份到 openclaw.json.backup.$DATE"
2. 日志清理
#!/bin/bash# 清理 7 天前的日志find ~/.openclaw/logs -name "*.log" -mtime +7 -delete echo"已清理 7 天前的日志"
3. 快速重启
#!/bin/bash openclaw gateway stop sleep3 openclaw gateway start echo"网关已重启"
4. 网站价格监控
#!/bin/bashcheck_product_price(){URL=$1THRESHOLD=$2PRODUCT_NAME=$3PRICE=$(curl -s $URL |grep -oP 'price: \K[0-9.]+')if(( $(awk "BEGIN {print $PRICE <= $THRESHOLD}")));then openclaw message send \ --channel feishu \ --target "@your_alert_group"\ --message "$PRODUCT_NAME 价格已降至 $PRICE"fi}# 使用:$0 "https://example.com/product" 100 "iPhone 15"
5. 天气监控
#!/bin/bashCITY=$1WEATHER=$(curl -s "https://getweather.com/$CITY"| jq '.weather') openclaw message send \ --channel feishu \ --message "$CITY 今日天气:$WEATHER"
6. 股票价格监控
#!/bin/bashSYMBOL=$1PRICE=$(curl -s "https://api.stocks.com/$SYMBOL"| jq '.price') openclaw message send \ --channel feishu \ --message "$SYMBOL 的最新价格是 $PRICE"
7. 自动发送日报(邮件或飞书)
#!/bin/bashTODAY=$(date +%Y-%m-%d)# 从数据库或文件读取工作记录REPORT=$(cat ~workspace/tasks.log |grep $TODAY) openclaw message send \ --channel feishu \ --message "📊 今日工作报告\n$REPORT"
8. 服务器资源监控
#!/bin/bashCPU=$(top -bn1 |grep"Cpu(s)"|awk'{print $2}'|cut -d'%' -f1)MEM=$(free|grep Mem |awk'{printf "%.1f%%", $3/$2 * 100.0}')DISK=$(df -h |awk'$NF=="/"{printf "%s", $5}')if(( $(awk "BEGIN {print $CPU >80}")));then openclaw message send \ --channel feishu \ --message "⚠️ CPU 使用率过高:$CPU%"fiif[[$DISK== *9?%* ]];then openclaw message send \ --channel feishu \ --message "⚠️ 磁盘使用率过高:$DISK"fi
9. 备份脚本(完整备份)
#!/bin/bashBACKUP_DIR=~/.openclaw/backups DATE=$(date +%Y%m%d_%H%M%S)mkdir -p $BACKUP_DIR# 备份配置、数据、日志cp -r ~/.openclaw/openclaw.json $BACKUP_DIR/ cp -r ~/.openclaw/workspace $BACKUP_DIR/workspace_$DATE# 删除 30 天前的备份find$BACKUP_DIR -mtime +30 -delete
10. 数据库备份(如果使用数据库)
#!/bin/bashBACKUP_FILE=~workspace/db_backup_$(date +%Y%m%d).sql if[ -f "~workspace/database.db"];then sqlite3 ~workspace/database.db .dump >$BACKUP_FILEfi
11. 网站连通性检查
#!/bin/bashURL=$1STATUS=$(curl -s -o /dev/null -w "%{http_code}" $URL)if[$STATUS -ne 200];then openclaw message send \ --channel feishu \ --message "❌ 网站异常:$URL (状态码: $STATUS)"fi
12. 监控 HTTPS 证书过期
#!/bin/bashDOMAIN=$1EXPIRY=$(echo| openssl s_client -servername $DOMAIN -connect $DOMAIN:443 2>/dev/null | openssl x509 -noout -dates |grep notAfter |cut -d= -f2)DAYS=$(echo$(($(date -d "$EXPIRY" +%s) - $(date +%s))) / 86400)if[$DAYS -lt 30];then openclaw message send \ --channel feishu \ --message "⚠️ $DOMAIN 证书将在 $DITS 天后过期!"fi
13. 扫描指定 IP 端口
#!/bin/bashIP=$1PORT=$2ifnc -z -w5 $IP$PORT;then openclaw message send \ --channel feishu \ --message "$IP:$PORT 端口正常"else openclaw message send \ --channel feishu \ --message "❌ $IP:$PORT 端口不可达"fi
14. 文件去重
#!/bin/bashDIR=$1 fdupes -r $DIR|whileread -r file;doif["$file"!="$PREV"];thenPREV=$fileelserm"$file"echo"已删除重复文件:$file"fidone
15. 定时清理过期文件
#!/bin/bashDIR=$1DAYS=$2find$DIR -type f -mtime +$DAYS -delete echo"已删除 $DIR 中 $DAYS 天前的文件"
16. 生成代码摘要
#!/bin/bashFILE=$1# 使用 AI 分析代码(需要配置) openclaw agent --message "请分析这个文件:$(cat $FILE)" --to feishu
17. 自动总结日志
#!/bin/bashLOG_FILE=$1 openclaw agent --message "总结这个日志文件的核心错误:$(tail -100 $LOG_FILE)" --to feishu
18. 自动翻译文本
#!/bin/bashTEXT=$1 openclaw agent --message "翻译成英文:$TEXT"
19. 生成测试数据
#!/bashTYPE=$1 openclaw agent --message "生成 $TYPE 的测试数据(10个样本)"
20. 代码审查
#!/bin/bashFILE=$1 openclaw agent --message "审查这段代码的安全性:$(cat $FILE)"
Q1:OpenClaw 支持哪些平台?
A:支持:
Q2:最低系统要求是什么?
A:
Q3:是否需要显卡?
A:不需要,OpenClaw 主要是路由和管理工作流,不进行本地模型推理。
Q4:OpenClaw 是否支持多模型?
A:支持!可同时使用多个 AI 模型,并设置优先级和回退。配置示例如下:
{"agents":{"defaults":{"model":{"primary":"anthropic/claude-sonnet-4-6","fallbacks":["kimi-code","deepseek-chat"]}}}}
Q5:如何获取 API Key?
A:
Q6:如何让 AI 用专业口吻回复?
A:在 MEMORY.md 中设置:
# 系统提示 请用专业、技术性强的语气回复,使用 emoji 和结构化格式,避免无关的客套话。
Q7:如何禁用某个渠道?
A:在 openclaw.json 中:
{"channels":{"telegram":{"enabled":false}}}
或在 CLI 中执行:
openclaw channels remove --channel telegram --delete
Q8:如何让 AI 只在特定时间回复?
A:使用 Cron 设置:
openclaw cronadd\ --name "工作时间"\ --cron "* 9-18 * * 1-5"\ --system-event "已进入工作时间" openclaw cronadd\ --name "下班时间"\ --cron "0 0 20 * * 1-5"\ --system-event "已下班,工作消息转入离线模式"
Q9:如何防止 AI 泄露敏感信息?
A:
Q10:如何让 AI 记住对话?
A:OpenClaw 默认会在会话内记住对话,但跨会话持久记忆需手动构建和写入到记忆文件中。可以:
MEMORY.md 或 memory/YYYY-MM-DD.mdopenclaw memory index 重建索引,之后检索生效Q11:启动失败,提示端口被占用怎么办?
A:检查并终止占用进程或更换端口:
# 检查哪个进程占用 18789 端口lsof -i :18789 # 终止进程kill -9 <PID># 或更换端口启动 openclaw gateway --port 18790
Q12:渠道连接失败怎么办?
A:诊断步骤:
# 1. 检查 Token 是否有效 openclaw channels status --probe # 2. 重新添加渠道 openclaw channels remove --channel telegram openclaw channels add --channel telegram --token YOUR_NEW_TOKEN # 3. 查看日志 openclaw logs --lines 100
Q13:Token 余额不足怎么办?
A:
openclaw models status --probeQ14:AI 回复很慢怎么办?
A:可能原因与解决方案:
openclaw memory index 减少上下文压缩压力agents.defaults.timeoutSecondsQ15:如何查看详细错误日志?
A:实时查看错误:
openclaw logs --follow
过滤错误日志:
openclaw logs --follow |grep -i error
Q16:如何使用多个工作空间?
A:创建单独的配置文件:
openclaw --profile work gateway start openclaw --profile personal gateway start
Q17:如何让 AI 执行复杂工作流?
A:编写插件(skills)并在对话中使用。插件会自动注册工具,AI 可调用这些工具完成步骤。
Q18:如何备份所有数据?
A:
# 完整备份cp -r ~/.openclaw ~/.openclaw.backup.$(date +%Y%m%d)# 仅备份配置和记忆tar -czf backup.tar.gz ~/.openclaw/openclaw.json ~/.openclaw/workspace
Q19:如何迁移到新机器?
A:
~/.openclaw/ 目录Q20:如何升级到最新版本?
A:执行命令:
openclaw update # 重启网关 openclaw gateway restart
Q21:为什么 AI 会重复回复?
A:可能原因:
# 检查日志 openclaw logs |grep"duplicate"# 调整重试策略(或禁用不必要的重复检测)
Q22:为什么 AI 无法理解我的意图?
A:优化建议:
Q23:为什么在某些群组中 AI 不响应?
A:检查群组权限设置(需要 @ 提及、白名单等):
{"channels":{"discord":{"groups":{"*":{"requireMention":true,"allowedFrom":["server:123"]}}}}}
Q24:如何限制 AI 的回复长度?
A:在系统提示中设置限制:
# 系统提示 请将回复控制在 300 字以内,使用结构化格式(列表、分段)提升可读性。
Q25:如何让 AI 自动过滤垃圾信息?
A:在系统提示中添加垃圾信号词;或编写插件进行预处理过滤。
Q26:如何监控 OpenClaw 的资源使用?
A:查看系统健康状态(不含命令历史):
openclaw status --all
也可查看 Gateway 的运行时指标,或通过 systemctl status openclaw-gateway 查看 GPU 占用(若使用本地模型)。
Q27:为什么 Cron 任务没有执行?
A:
openclaw cron statusopenclaw cron list --allopenclaw cron runs --id <job-id> --limit 20Q28:如何优化内存使用?
A:
Q29:如何让 AI 持续记住我的偏好?
A:写入 MEMORY.md/文件;可启用记忆与索引并设置索引路径:
openclaw memory status openclaw memory index --verbose
Q30:如何联系技术支持?
A:
| 症状 | 可能原因 | 解决方案 |
|---|---|---|
| 无法启动网关 | Node 版本过低 | 升级到 Node 22+ |
| 无法启动网关 | 端口冲突 | 更换端口或终止占用进程 |
| Token 验证失败 | API Key 错误 | 检查 API Key 是否有效 |
| 配置文件解析失败 | JSON 格式错误 | 用 openclaw config get 验证 |
| 症状 | 可能原因 | 解决方案 |
|---|---|---|
| 渠道断连 | 网络问题 / Token 过期 | 检查网络并更新 Token |
| AI 不响应 | 模型服务宕机 | 切换到备用模型 |
| 回复变慢 | 上下文过大 | 减少历史记录或提升环境上限 |
| 内存溢出 | 超出系统资源 | 结束其他进程或升级硬件 |
| 症状 | 可能原因 | 解决方案 |
|---|---|---|
| 插件加载失败 | 依赖缺失 | 进入 plugin 目录执行 npm install |
| Cron 任务失败 | 路径错误 | 检查任务脚本路径和执行权限 |
| 浏览器无法启动 | Chrome 路径错误 | 配置浏览器可执行文件路径 |
如果这篇文章对你有帮助,点赞、收藏、分享给其他开发者!
本文由【OpenClaw 技术分享】原创,转载请注明来源。
如果你想快速搭建 AI 机器人,加我微信,免费配置指导。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online