OpenClaw完全使用手册

OpenClaw⽬录1.2核心特性与优势1.3发展历程与现状1.4适用场景与用户群体2.1基础功能使用2.2文件与文档处理2.3浏览器自动化2.5通讯平台集成2.6技能插件系统2.7高级应用场景3.1国内部署环境准备3.2模型选择与配置3.3通讯平台接入3.4常见问题与解决4.1系统要求与环境准备4.6云服务器部署4.7配置与优化5.3权限管理5.4监控与审计A.常用命令速查B.配置文件参考C.故障排除指南D.资源与社区4OpenClaw（曾用名Clawdbot、Moltbot）是一款开源的个人AI助手平台，于2026年初在GitHub上迅速走红，成为近年来增长最快的开源项目之一。它能够在用户自己的设备上本地运行，通过WhatsApp、Telegram、Discord、飞书、钉钉等多种通讯平台与用户交互，实现从简单的对话问答到复杂的自动化任务执行。与传统的聊天机器人不同，OpenClaw的核心价值在于其执行能力。它不仅能够理解自然语言指令，还能直接操作用户的电脑系统，包括读写文件、执行终端命令、控制浏览器、管理邮件和日历等。这种"从建议到行动"的能力跃迁，标志着AI助手从"顾问"角色向"数字员工"角色的转核心定位核心定位OpenClaw的定位是"YourownpersonalAIassistant"——一个真正属于用户的、可深度定制的AI助手，而非依赖云服务的第三方产品。OpenClaw采用本地优先的设计理念，所有核心功能都在用户设备上运行，数据存储在本地而非云端。这种架构带来了以下优势：.数据隐私：敏感信息不会离开用户设备，避免了数据泄露风险·离线可用：配合本地模型（如Ollama即使断网也能使用·完全控制：用户拥有对AI助手的完全控制权，可自由定制·零订阅费用：除模型API调用费用外，无其他持续成本5OpenClaw支持通过多种即时通讯平台与用户交互，让用户可以使用最熟悉的工具与AI助手表1-1OpenClaw支持的通讯平台WhatsAppOpenClaw的核心扩展机制是Skills（技能）系统。每个Skill是一个包含SKILL.md文件的目录，用自然语言描述AI助手如何完成特定任务。这种设计具有以下特点：.零代码开发：无需编程，用自然语言描述即可创建新技能.热重载：修改后立即生效，无需重启服务·生态丰富：ClawHub上已有3000+社区贡献技能·跨平台兼容：遵循AgentSkills标准，可在多个平台使用OpenClaw具备持久化记忆能力，能够记住用户的偏好、历史对话和上下文信息。记忆系统采用Markdown文件存储，便于用户查看和管理。这种设计使得AI助手能够：.记住用户的长期偏好和工作习惯6.在多次对话中保持上下文连贯.主动提醒待办事项和日程安排.基于历史数据提供个性化建议OpenClaw于2026年1月在GitHub上发布，迅速引发全球开发者社区的关注。以下是其发展历程中的关键节点：表1-2OpenClaw发展历程0OpenClaw的快速发展得益于活跃的社区生态：·开发者社区：Discord服务器拥有数万名活跃开发者·技能市场：ClawHub托管超过3000个技能插件.云厂商支持：阿里云、腾讯云等推出一键部署方案·中文社区：OpenClawCN提供本地化支持和文档7对于个人用户，OpenClaw可以作为全能的数字助手，帮助处理日常事务：.个人知识管理：整理笔记、归档文档、构建知识库.日程与任务：管理日历、设置提醒、跟踪待办.信息聚合：自动抓取新闻、生成日报、监控感兴趣的话题.文件处理：批量重命名、格式转换、内容提取.开发辅助：代码审查、文档生成、自动化测试在团队环境中，OpenClaw可以承担更多协作型任务：·智能客服：7×24小时自动回复常见问题.数据报表：定时生成业务报表并推送到群聊.运维监控：监控服务器状态，异常时自动告警.内容创作：辅助撰写文案、生成图表、排版文档.流程自动化：串联多个系统，实现工作流自动化对于开发者，OpenClaw提供了丰富的扩展能力：.技能开发：创建自定义技能，封装业务逻辑.插件开发：开发系统级插件，扩展核心功能.集成测试：自动化测试、持续集成、部署流水线·原型验证：快速验证AI应用想法8配置向导会引导用户完成以下设置：[2]AI模型配置：选择模型提供商（OpenAI、Anthropic、本地模型等）并设置APIKey[3]通讯平台选择：选择要接入的聊天平台（可后续再配置）[4]守护进程安装：将Gateway注册为系统服务，实现开机自启配置完成后，用户可以通过以下方式与OpenClaw交互：Web控制台：打开浏览器访问:18789/，或通过命令启动：即时通讯：在配置的聊天平台（Telegram、飞书等）中直接与机器人对话命令行：通过CLI发送指令：9OpenClaw具备强大的文件操作能力，可以通过自然语言指令完成各种文件管理任务：创建文件："在桌面上创建一个名为project-ideas.md的文件，内容包含三个AI创业项目想法"批量处理："把Downloads文件夹里所有的PDF文件移动到Documents/PDF目录，并按日期重命"读取report.pdf的内容，提取其中的关键数据并生成摘要"OpenClaw内置了多种文档处理技能：案例1：批量生成报告需求：每周一生成上周销售数据报告"每周一上午9点，读取sales-data.xlsx中的上周数据，生成一份包含图表的销售报案例2：文档归档"每天凌晨2点，检查Downloads文件夹，按文件类型自动分类到Documents下的对应子文件夹，删除超过30天的临时文件"OpenClaw可以控制浏览器执行各种自动化操作：网页访问与截图："打开，截取首页截图保存到screenshots文件夹"数据抓取："访问竞争对手的产品页面，提取产品价格、规格和用户评价，生成对比表格"表单填写："打开登录页面，输入用户名和密码，点击登录按钮"要使用浏览器功能，需要安装浏览器工具：配置无头浏览器（服务器环境{"executablePath":"/usr}}价格监控："每小时检查一次某电商网站的产品价格，如果价格低于500元，立即发送通知"网站监控："每5分钟检查公司官网是否正常访问，如果无法访问或响应时间超过3秒，发送告OpenClaw可以执行系统终端命令，实现更深度的系统集成：系统信息查询："查看当前系统的CPU和内存使用情况"软件安装："拉取最新代码，运行测试，如果测试通过则构建并部署到生产环境"代码审查："检查最近的Git提交，分析代码变更，生成审查报告"安全提醒安全提醒系统命令执行功能具有高风险，建议在沙箱环境中使用，或严格限制可执行的命令范围。Telegram是OpenClaw官方推荐的通讯平台，配置简单且稳定：配置步骤：3.运行配置命令：飞书是国内用户常用的办公平台，OpenClaw提供了完整的飞书支持：创建飞书应用：1.访问飞书开放平台（）2.创建企业自建应用，选择机器人类型3.在"凭证与基础信息"中获取AppID和AppSecret4.在"权限管理"中开启所需权限5.在"事件与回调"中添加事件订阅配置权限：{]}}钉钉集成需要创建企业内部应用：1.访问钉钉开放平台（）2.创建企业内部应用4.配置机器人回调地址Skills是OpenClaw的能力扩展层，让AI助手能够执行特定任务。每个Skill包含：workspace/skills/中查看已安装技能：更新技能：利用OpenClaw构建个人知识管理系统："把我发给你的所有文章链接、PDF和笔记都保存到知识库，自动分类打标签，当我提问时能够基于知识库内容回答"实现方案：2.配置知识库存储路径3.设置自动归档规则内容创作流水线："每天早上8点，抓取科技新闻网站的头条，生成一份中文摘要，保存到文档并发送到我的邮箱"数据监控告警："每10分钟检查数据库的连接数和慢查询数量，如果超过阈值立即在运维群发送告警"部署多个OpenClaw实例，各自负责不同任务，通过共享记.研究助手：负责信息搜集和整理.写作助手：负责内容创作和润色.审核助手：负责质量检查和校对结合智能家居API，实现语音控制：需要安装对应的智能家居技能，如PhilipsHue、Sonos等。在国内使用OpenClaw，最大的优势是无需梯子即可完成部署和使用。这得益于以下设计：·OpenClaw本体代码托管在国内可访问的镜像源.通讯平台支持国内应用（飞书、钉钉、企业微信）纯国内网络方案纯国内网络方案通过使用阿里云百炼、智谱GLM等国内模型，配合飞书/钉钉等国内通讯平台，可以实现完全在国内网络环境下的OpenClaw部署和使用。为了加快下载速度，建议使用国内npm镜像源：国内社区提供了汉化版本的OpenClaw，包含以下优化：.预装国内常用技能.针对国内网络优化的安装脚本.中文文档和社区支持安装命令：阿里云百炼是国内使用最广泛的模型平台之一，配置步骤如下：1.登录阿里云控制台（）2.进入"百炼大模型"服务3.在"密钥管理"中创建APIKey运行配置向导时选择阿里云百炼，或在配置文件中手动添加：{}"baseUrl":"/api/v1"}}}}智谱AI的GLM系列模型在国内表现优秀，配置方1.访问智谱AI开放平台（）2.注册并创建应用3.在"API密钥"页面获取Key{}"baseUrl":"/api/paas/v4"}}}}对于追求完全离线使用的用户，可以部署本地模型：{}"baseUrl":"http://localhost:11434/v1"}}}}硬件要求硬件要求本地模型对硬件要求较高。7B参数模型建议16GB内存，14B参数模型建议32GB内存，飞书是国内企业使用最广泛的协作平台之一，以下是详细接入步骤：步骤1：创建飞书应用1.访问飞书开放平台（）2.点击"创建企业自建应用"3.选择"机器人"类型4.填写应用名称和描述步骤2：配置权限在"权限管理"中添加以下权限：·im:message-接收和发送消息·im:message:send_as_bot-以机器人身份发送消息·im:chat:readonly-读取群聊信息·contact:user.employee_i步骤3：配置事件订阅在"事件与回调"中：1.选择"长连接订阅方式"2.添加事件：im.message.receive_v13.保存配置步骤4：获取凭证在"凭证与基础信息"中复制：步骤5：OpenClaw配置钉钉接入流程：步骤1：创建钉钉应用1.访问钉钉开放平台（）2.创建"企业内部应用"3.选择"机器人"类型步骤2：配置机器人1.在"机器人"菜单中开启"机器人"功能2.设置机器人名称和图标3.配置消息推送方式（Webhook或Stream）步骤3：获取凭证步骤4：配置回调地址http://your-server:8000/dingt企业微信接入相对复杂，需要：1.在企业微信管理后台创建应用4.设置接收消息的回调URL问题：安装脚本下载失败解决方案：.使用国内镜像源安装.手动下载脚本后本地执行.使用代理（如果需要）问题：模型API调用超时解决方案：.检查网络连接.检查账户余额和配额.尝试切换其他模型问题：飞书机器人不回复排查步骤：1.检查事件订阅是否为"长连接模式"2.确认已添加im.message.receive_v1事件4.检查OpenClaw网关是否正常运行问题：钉钉回调验证失败解决方案：.确认回调URL可公网访问.检查端口是否开放.验证签名计算正确模型响应慢：.选择响应更快的模型·优化提⽰词，减少token消耗.使用流式输出.限制并发任务数.定期清理日志和缓存OpenClaw需要以下软件环境：·npm：Node.js包管理器在安装前，检查系统是否满足要求：方法一：官方安装包打开PowerShell（推荐以管理员身份运行执行：国内用户可以使用镜像源：安装完成后，运行配置向导：按照提⽰完成配置：3.选择通讯平台4.安装系统服务然后按照Linux部署步骤操作。Homebrew是macOS上最流行的包管理器，推荐优先使用：安装Homebrew（如果尚未安装/Homebrew/install/HEAD/install.sh)"MacMini是运行OpenClaw的理想设禁用睡眠：保持运行：配置本地模型（可选对于M1/M2/M3/M4芯片的Mac，本地模型运行效率更高：M3Max/M4Max64GB+运行配置向导：创建Swap空间（内存不足时配置防火墙：Docker部署是最干净、最隔离的方案，适合生产环境：拉取镜像：$$dockerpullopenclaw/op运行容器：image:openclaw/opencl启动服务：国内用户可以使用镜像加速：$$dockerpull/openclaw/openclaw:latest或者使用社区维护的汉化版镜像：$$dockerpulljustlikemaki/openclaw-docker-cn-im:latest阿里云提供了一键部署方案，最为便捷：方法一：轻量应用服务器1.访问阿里云OpenClaw专题页面2.选择"轻量应用服务器"3.镜像选择"OpenClaw专属镜像"4.完成购买后，系统自动完成部署方法二：ECS手动部署1.创建ECS实例（推荐2核4G及以上配置）3.按照Linux部署步骤安装腾讯云Lighthouse同样提供预装镜像：1.进入腾讯云Lighthouse控制台2.创建实例时选择"应用镜像"3.选择"OpenClaw"镜像4.等待自动部署完成{}"baseUrl":"/api/v1"}}]}}模型路由：配置模型故障转移{}}}}·定期清理日志：openclawlogs--clear.限制记忆保留时长.关闭不必要的技能备份配置：恢复配置：建议定期备份~/.openclaw/目录，特别是credentials和workspace文件夹。可以设置定时任务自动备份到云存储。OpenClaw的强大能力也带来了相应的安全风险，用户需要充分了解这些风险：⾼⾼⾼中中场景1：公网暴露许多用户将OpenClaw部署在公网服务器上且未设置认证，导致任何人都可以访问控制面板，执行任意命令。高危警告高危警告研究发现，超过42,000个OpenClaw实例暴露在互联网上，其中93%存在严重身份验证绕过漏洞。场景2：间接提⽰词注入攻击者在PDF、网页中嵌入隐藏指令，当OpenClaw读取这些内容时，可能执行恶意操作：场景3：恶意技能ClawHub上存在恶意技能，声称提供正常功能，实则窃取用户凭证或执行恶意代码。限制端口访问：.配置防火墙规则修改默认端口：{}}切勿使用root或管理员账户运行OpenClaw，应创建专用用户：Docker部署提供了天然的隔离环境，限制容器权限：及时更新：审查技能：.只安装可信来源的技能.审查技能代码后再安装.定期检查已安装技能的更新为OpenClaw授予完成任务所需的最小权限：.文件系统：限制可访问的目录.网络：限制可访问的域名.命令：限制可执行的命令默认情况下，OpenClaw会对未知用户生成配对码，需要手动批准：配置允许列表，只允许特定用户访问：{]}}启用详细日志记录：配置日志轮转，防止磁盘占