OpenClaw 完全指南：从部署到实战，一文搞懂 2026 最火开源 AI Agent

OpenClaw 完全指南从部署到实战一文搞懂 2026 最火开源 AI Agent原创| 已更新2026-05-18 | 阅读约 25 分钟前言2026 年初一个开源项目在 60 天内狂揽 35.5 万 GitHub Stars——这个速度React 用了十多年才达成。它就是OpenClaw。OpenClaw原名 Clawdbot → Moltbot → OpenClaw由 Peter Steinberger 于 2025 年末创建2026 年 2 月 Steinberger 加入 OpenAI 后项目移交开源基金会彻底走向社区驱动。它凭什么火三个字能干活。它不是聊天机器人而是一个 7×24 小时自主运行的个人 AI Agent——浏览网页、读写文件、执行代码、发送消息、管理日程你在 Telegram/微信/飞书/钉钉里跟它说话它就在后台把事办了。这篇文章我会从部署 → 配置 → 应用 → 实战案例四个维度手把手带你玩转 OpenClaw。一、OpenClaw 是什么核心架构拆解1.1 本质定义OpenClaw 是一个开源MIT 协议、可自托管的 AI Agent 框架它赋予大语言模型LLM以下能力能力说明本地文件系统访问读写你机器上的任意文件浏览器自动化Chrome DevTools Protocol支持已登录态操作代码执行在沙箱中运行 Shell 命令、脚本定时调度Cron Job 30 分钟 Heartbeat真正 7×24多平台消息Telegram / WhatsApp / Slack / Discord / 飞书 / 钉钉 / 微信 / QQ1.2 与其他 AI 工具对比工具运行方式7×24 后台本地文件访问技能市场开源OpenClawIM 消息交互✅ Heartbeat✅ 完整读写✅ ClawHub 5400✅ MITChatGPT浏览器/App❌❌插件有限❌Claude Code终端/IDE❌✅通过 MCP❌GitHub CopilotIDE❌受限❌❌Manus浏览器❌沙箱受限❌❌1.3 核心架构┌─────────────────────────────────────────────┐ │ 用户消息渠道 (IM) │ │ Telegram / WhatsApp / 飞书 / 钉钉 / 微信 │ └──────────────────┬──────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────┐ │ OpenClaw Gateway │ │ 消息网关 协议转换 │ └──────────────────┬───────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────┐ │ Agent 核心引擎 (LLM) │ │ ┌─────────┐ ┌──────────┐ ┌──────────────┐ │ │ │agents.md│ │ soul.md │ │ identity.md │ │ │ └─────────┘ └──────────┘ └──────────────┘ │ │ ┌─────────┐ ┌──────────┐ ┌──────────────┐ │ │ │ user.md │ │heartbeat │ │ memory.md │ │ │ └─────────┘ └──────────┘ └──────────────┘ │ └──────────────────┬───────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────┐ │ 工具层 (Tools) │ │ web_search │ shell │ browser │ database │ │ http_client │ file_io │ code_executor │ └──────────────────┬───────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────┐ │ Skills 生态 (ClawHub) │ │ 5400 社区技能插件按需安装 │ └──────────────────────────────────────────────┘1.4 五大核心特性① 全渠道消息集成OpenClaw 连接到你已经在用的通讯 App——Telegram、WhatsApp、Slack、Discord、iMessage、Google Chat国内还支持飞书、钉钉、企业微信、QQ。你用聊天的方式给 Agent 下达任务它用聊天的方式反馈结果。② Heartbeat Cron 定时任务每 30 分钟Heartbeat 自动唤醒 OpenClaw将会话摘要保存到memory.md实现长期记忆执行配置的 Cron 定时任务后台维护与自我检查典型 Cron 用例# 每天早上 7:30 发送 AI 新闻简报07:30 * * *抓取 Top 5 AI 新闻生成摘要发到 Telegram# 每晚 22:00 代码审查022:00 * * *审查今天 main 分支的所有 commit标记缺少错误处理的函数# 每周一 8:00 竞品分析08:00 * *1检查竞品定价页面的变化报告差异③ Chrome DevTools MCP —— 带登录态的浏览器自动化这是 OpenClaw 的杀手锏。通过 Chrome DevTools Protocol (CDP)OpenClaw 可以接管你已登录的 Chrome 浏览器——发社交媒体、操作后台系统、填写表单——无需重新登录无需处理两步验证。④ Skills 技能市场ClawHubSkills 是基于 Markdown 的插件系统定义 Agent 的新能力# 从 ClawHub 安装技能openclaw pluginsinstallclawhub:larry-marketing# 查看已安装技能openclaw plugins list内置技能1Password、Apple Notes、Notion、OpenAI Whisper、Nano PDF 等。ClawHub 官方精选 80 技能社区 awesome-openclaw-skills 仓库收录超过 5400 个贡献。⑤ 多 Agent 协作一个 OpenClaw 实例可以派生子 Agent并行处理任务用户(Telegram) ──→ 主 Agent ├── 子 Agent A网页调研 ├── 子 Agent B代码生成 └── 子 Agent C邮件撰写 │ ▼ memory.md长期上下文二、部署篇三种方式从零到运行2.1 方式一本地一键安装推荐新手系统要求macOS / Linux / Windows (WSL2)16 GB RAM 512 GB SSD多 Agent 场景建议Node.js 18安装脚本自动处理安装步骤# Step 1: 安装/升级 Node.js推荐用 nvmcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh|bashsource~/.bashrc nvminstall22nvm use22nvmaliasdefault22# 验证node-v# v22.xnpm-v# 10.9# Step 2: 一键安装 OpenClawcurl-fsSLhttps://openclaw.ai/install.sh|bash# Step 3: 跟随 Onboard 向导配置 LLM 和消息渠道安装完成后进入交互式配置向导配置项说明建议AI 模型支持各大厂商模型国内推荐 Qwen 系列消息渠道Telegram / WhatsApp 等国内可先跳过后续配飞书Skills按需选择可跳过对话中也可安装Hooksboot-md / command-logger / session-memory三个都装三个必装 Hooks 解释boot-md启动时加载 Markdown 文本作为默认引导内容把你的规则、偏好、项目背景注入每次会话command-logger记录 OpenClaw 执行过的命令和关键操作方便排查和复盘session-memory保存会话状态和记忆下次启动延续上下文2.2 方式二云服务器部署7×24 运行适合场景不想本地一直开机需要 Agent 全天候在线。以阿里云/腾讯云为例# Step 1: 购买云服务器2核4G 起步# Step 2: SSH 登录sshroot你的服务器公网IP# Step 3: 安装 Node.js OpenClaw同上curl-fsSLhttps://openclaw.ai/install.sh|bash# Step 4: 启动 Gatewayopenclaw gateway--verbose# Step 5: 检查运行状态openclaw health# 查看是否在后台运行openclaw models list# 查看模型状态# Step 6: 端口转发访问 Web 界面本地执行ssh-L18789:127.0.0.1:18789 root你的服务器公网IP# Step 7: 获取 Tokenopenclaw dashboard# 浏览器打开 127.0.0.1:18789/?tokenxxxxxx生产环境安全建议措施说明防火墙只开放必要端口关闭公网 SSH 密码登录Token 管理Gateway Token 存密码管理器1Password/Bitwarden敏感信息不要在对话中直接粘贴 API Key / 数据库密码进程管理使用 systemd 或 supervisor 管理 Gateway 进程日志监控开启详细日志 Prometheus Grafana 监控2.3 方式三Docker 一键部署最省心适合场景团队协作、多平台消息分发、快速扩容。# docker-compose.ymlversion:3.8services:openclaw:image:openclaw/openclaw:latestcontainer_name:openclawrestart:alwaysports:-18789:18789volumes:-./workspace:/root/.openclaw/workspaceenvironment:-OPENCLAW_LLM_API_KEY${API_KEY}-OPENCLAW_GATEWAY_TOKEN${GATEWAY_TOKEN}# 启动docker-composeup-d# 查看日志docker-composelogs-fopenclaw# 停止docker-composedown三、配置篇打造你的专属 Agent3.1 工作空间文件详解OpenClaw 安装后会在~/.openclaw/workspace/生成配置文件文件用途示例agents.md定义 Agent 行为和角色“你是一个专业的技术助手”soul.md性格与语气“友好简洁用中文回复”identity.mdAgent 名字和自我介绍“我叫小虾是你的 AI 助手”user.md关于你的信息“我是后端开发者主要用 Python”heartbeat.md每 30 分钟执行的定时任务“检查邮箱新邮件”memory.md长期记忆自动填充Agent 自动积累的上下文3.2 模型配置OpenClaw 支持多种 LLM国内用户推荐配置{model:{provider:dashscope,name:qwen3.5-plus,max_tokens:2048,temperature:0.7}}模型厂商推荐模型适用场景阿里通义qwen3.5-plus国内首选性价比高DeepSeekdeepseek-v4复杂推理任务Anthropicclaude-sonnet-4代码生成、长文本OpenAIgpt-5.5综合能力最强Googlegemini-2.5-pro多模态任务本地模型llama3 / qwen2.5隐私敏感场景3.3 国内 IM 接入配置飞书接入# 1. 在飞书开放平台创建机器人应用# 2. 获取 App ID 和 App Secret# 3. 配置事件订阅回调地址openclaw channels login feishu# 输入 App ID / App Secret / Verification Tokenopenclaw channelstestfeishu钉钉接入# 1. 在钉钉开发者后台创建机器人# 2. 获取 Client ID / Client Secretopenclaw channels login dingtalk# 输入凭证openclaw channelstestdingtalk企业微信接入# 1. 在企业微信管理后台创建自建应用# 2. 获取 CorpID / Secret / Token / EncodingAESKeyopenclaw channels login wecom# 输入凭证openclaw channelstestwecom四、应用篇OpenClaw 能干什么4.1 个人效率场景场景描述涉及能力每日简报每早自动抓取新闻→摘要→推送Cron web_search LLM 摘要邮件助手自动检查邮箱→分类→草拟回复Heartbeat IMAP LLM文件管理自动整理下载文件夹→按类型归档文件系统 Shell日程管理读取日历→提前提醒→冲突检测Calendar API Cron代码审查提交 PR 自动审查→标记问题Git Shell LLM4.2 团队协作场景场景描述涉及能力社群机器人自动回答问题、欢迎新成员、通知Discord/Telegram 知识库客服系统7×24 自动响应→意图识别→复杂转人工IM LLM API数据采集定时爬取竞品信息→入库→通知Cron browser Database营销自动化识别意向客户→记录线索→同步 CRMIM LLM HTTP Client4.3 开发者场景场景描述涉及能力运维助手检查磁盘/CPU→自动备份→告警Shell Cron IMCI/CD 通知构建结果推送→失败自动排查HTTP Shell LLM文档生成扫描代码→自动生成 API 文档文件系统 LLM依赖升级检测过时依赖→自动提 PRShell Git LLM五、实战篇三大案例手把手5.1 实战一构建 24 小时 AI 客服助手需求在 Telegram 上搭建一个 7×24 自动响应的技术客服响应时间 3 秒支持多轮对话和问题升级。架构设计用户 (Telegram) │ ▼ OpenClaw Gateway (消息网关) │ ▼ Assistant Agent (LLM 核心) │ ├── web_search搜索知识库 ├── shell执行诊断脚本 └── http_client调用内部 APIStep 1创建 Agentopenclaw agents create assistantStep 2编辑配置~/.openclaw/agents/assistant/config.json{name:技术客服助手,description:7×24 小时自动响应助手,model:{provider:dashscope,name:qwen3.5-plus,max_tokens:2048,temperature:0.7},tools:[web_search,shell,database,http_client],context:{max_history:10,timeout_seconds:300}}Step 3自定义命令处理器handlers.jsmodule.exports{// 天气查询/weather:async(context,location){try{constdataawaitcontext.tools.fetch(https://api.wttr.in/${location}?formatj1);constweatherdata.current_condition[0];return️${location}天气\n温度${weather.temp_C}°C\n湿度${weather.humidity}%\n天气${weather.desc_zh};}catch(error){return⚠️ 查询失败${error.message};}},// 搜索/search:async(context,query){constresultsawaitcontext.tools.web_search(query,{count:5,freshness:week});returnresults.slice(0,5).map((r,i)${i1}.${r.title}\n${r.snippet}).join(\n\n);},// 帮助/help:(){return 可用命令\n\n/weather 城市 - 查询天气\n/search 关键词 - 搜索\n/help - 帮助;}};Step 4接入 Telegram# 登录 Telegramopenclaw channels login telegram# 输入 Bot Token通过 BotFather 获取# 验证连接openclaw channelstesttelegramStep 5运行效果用户/weather Shanghai 助手️ 上海天气 温度25°C 湿度60% 天气晴 用户搜索 OpenClaw 最新功能 助手 找到 5 条结果 1. OpenClaw 发布浏览器自动化功能 2. OpenClaw 社区技能库突破 5400 个 ...生产建议用systemd管理 Gateway 进程开启详细日志 Prometheus 监控配置 API 速率限制避免被限流复杂问题设置升级机制转人工处理5.2 实战二自动化数据采集 每日简报需求每 6 小时自动采集 AI 领域新闻去重后生成摘要早上 8 点推送简报到 Telegram。架构设计定时调度器 (Cron) │ ▼ 采集 Agent (Collector) │ ├── browser浏览目标网站 └── web_fetch抓取页面内容 │ ▼ 处理 Agent (Processor) │ └── LLM提取标题/摘要/日期去重过滤 │ ▼ 通知服务 (Notifier) │ └── Telegram / EmailStep 1创建采集任务配置collector.yamltask:name:AI 新闻采集schedule:0 */6 * * *# 每 6 小时enabled:truesources:-url:https://techcrunch.com/category/ai/selector:title:.post-titlesummary:.post-content-url:https://www.theverge.com/aiselector:title:.entry-titleprocessing:extract:[title,summary,date]filter:keywords:[AI,LLM,OpenAI,大模型]deduplicate:trueoutput:database:mysql://localhost/ai_newsnotify:channel:telegramcondition:new_count 5Step 2配置每日简报 Cron# 在 heartbeat.md 中添加08:00 * * *汇总今天的 AI 新闻生成简报发到 TelegramStep 3运行效果 AI 新闻简报 (2026-05-18) 【头条新闻】 1. OpenAI 发布 GPT-5.5 技术报告 来源TechCrunch | 2 小时前 2. DeepSeek V4 开源发布 来源官方博客 | 4 小时前 【技术动态】 3. OpenClaw 社区技能库突破 5400 个 4. Anthropic 企业客户首超 OpenAI 【行业数据】 5. AI 自动化工具市场 Q1 增长 45%注意事项遵守目标网站robots.txt协议控制采集频率避免给目标站造成压力处理反爬机制配置 User-Agent、代理等数据合规确保采集符合法律法规5.3 实战三多 Agent 协作 —— AI 自动化运维系统需求服务器磁盘告警 → Agent 自动排查 → 尝试修复 → 失败则升级通知。架构设计Cron (每 30 分钟检查) │ ▼ 监控 Agent (Monitor) ├── 检查磁盘使用率 ├── 检查 CPU 负载 └── 检查服务存活 │ ▼ (异常时触发) 修复 Agent (Healer) ├── 清理日志文件 ├── 重启异常服务 └── 释放磁盘空间 │ ▼ (修复失败) 通知 Agent (Notifier) └── 发送告警到飞书/钉钉Step 1编辑agents.md定义多 Agent 协作# Monitor Agent 角色服务器监控 触发每 30 分钟 Heartbeat 工具shell 任务执行 df -h / top -bn1 / systemctl status 检查系统状态 # Healer Agent 角色自动修复 触发Monitor 发现异常时 工具shell 任务清理 /tmp、轮转日志、重启服务 # Notifier Agent 角色告警通知 触发Healer 修复失败时 工具feishu / dingtalk 任务发送包含错误详情的告警消息Step 2配置 Heartbeat# heartbeat.md ## 系统巡检 每 30 分钟执行以下检查 1. 磁盘使用率 85% → 触发 Healer 清理 2. CPU 负载 80% 持续 5 分钟 → 发送告警 3. 关键服务 down → 尝试重启失败则告警Step 3运行效果[Monitor] 14:30 系统巡检 磁盘 /dev/vda1: 58% ✅ 磁盘 /dev/vdb1: 88% ⚠️ 超阈值 CPU 负载: 0.72 ✅ Nginx: running ✅ [Healer] 14:30 自动修复 清理 /var/log 旧日志: 释放 12GB 轮转应用日志: 释放 3GB 磁盘 /dev/vdb1: 62% ✅ 已恢复 [Monitor] 15:00 系统巡检 所有指标正常 ✅生产建议设置操作白名单只允许安全的修复动作所有操作记录日志方便审计修复动作设置超时防止卡死关键操作前先做快照/备份六、Skills 生态5400 插件怎么选6.1 必装 Skills 推荐Skill功能安装命令boot-md启动时加载引导内容内置command-logger操作日志记录内置session-memory会话记忆持久化内置1password密码管理器集成openclaw plugins install clawhub:1passwordnotionNotion 读写openclaw plugins install clawhub:notionwhisper语音转文字openclaw plugins install clawhub:openai-whispernano-pdfPDF 处理openclaw plugins install clawhub:nano-pdf6.2 安装与管理# 搜索技能openclaw plugins search关键词# 安装技能openclaw pluginsinstallclawhub:skill-name# 查看已安装openclaw plugins list# 更新技能openclaw plugins updateskill-name# 卸载技能openclaw plugins uninstallskill-name6.3 自定义 Skill 开发Skills 本质是 Markdown 文件定义 Agent 的新能力--- name: my-custom-skill version: 1.0.0 description: 自定义技能示例 tools: - shell - web_fetch --- # My Custom Skill 当用户要求 XXX 时执行以下步骤 1. 使用 web_fetch 获取数据 2. 使用 LLM 分析内容 3. 返回结构化结果将文件放到~/.openclaw/workspace/skills/目录即可生效。七、安全与最佳实践7.1 安全红线风险点防护措施API Key 泄露存密码管理器不粘贴到对话中未授权访问设置防火墙关闭不必要端口命令注入限制 Shell 工具权限设置白名单数据泄露敏感数据用本地模型不走云端权限过大最小权限原则只开放必要工具7.2 本地 vs 云端安全对比维度本地部署云端部署攻击面小OS 级保护大公网暴露数据隐私高数据不出本机中需额外加密可用性取决于本机运行时间7×24 有保障运维成本低中建议安全敏感场景优先本地部署需要全天候在线场景用云端但务必做好安全加固。7.3 日常运维清单定期更新 OpenClaw 版本openclaw update检查 Skills 更新openclaw plugins update --all审查memory.md清理过时信息检查日志异常openclaw logs --tail 100备份工作空间tar -czf openclaw-backup.tar.gz ~/.openclaw/workspace/八、总结与展望8.1 OpenClaw 的核心价值OpenClaw 之所以能在 60 天内收获 35.5 万 Stars根本原因是它第一次把 AI Agent 从概念变成了人人可用的生产力工具低门槛一条命令安装消息 App 即交互界面高能力浏览器、文件系统、Shell、定时任务真正能干活强生态5400 Skills覆盖你能想到的大部分场景真开源MIT 协议社区驱动不被任何公司绑定8.2 适合谁用人群推荐用法个人开发者本地部署自动化日常开发任务技术团队云端部署 多 Agent 协作提效运维/客服创业公司快速搭建 AI 客服/营销自动化AI 爱好者探索 Agent 能力边界开发自定义 Skills8.3 学习路径建议第一步本地安装 → 接入 Telegram → 体验基础对话 ↓ 第二步配置 Heartbeat/Cron → 体验自动化 ↓ 第三步安装 Skills → 扩展能力边界 ↓ 第四步多 Agent 协作 → 构建复杂自动化系统 ↓ 第五步开发自定义 Skill → 贡献社区参考资源资源链接官网https://openclaw.aiGitHubhttps://github.com/openclawSkills 市场https://clawhub.devawesome-openclaw-skills社区 Skills 合集awesome-openclaw-usecases-zh中文用例大全awesome-openclaw-agents205 个 Agent 模板OpenClaw 代表的不仅是又一个 AI 工具而是 AI Agent 从玩具走向生产力的关键拐点。它的开源属性和社区生态意味着每个开发者都能参与塑造 AI 自动化的未来。如果这篇文章对你有帮助欢迎点赞 收藏 关注我会持续分享 AI Agent 领域的深度实战内容。有问题欢迎评论区交流