OpenClaw完全使用手册-2026.2-45页

Version 1.0 [ OpenClaw ] OpenClaw 完全使⽤⼿册 海量玩法攻略 · 国内⽹络使⽤ · 本地部署指南 2026年2⽉版 ⽬ 录 第⼀章 OpenClaw 简介 1.1 什么是 OpenClaw 1.2 核⼼特性与优势 1.3 发展历程与现状 1.4 适⽤场景与⽤⼾群体 第⼆章 海量全玩法攻略 2.1 基础功能使⽤ 2.2 ⽂件与⽂档处理 2.3 浏览器⾃动化 2.4 系统命令执⾏ 2.5 通讯平台集成 2.6 技能插件系统 2.7 ⾼级应⽤场景 第三章 国内⽹络使⽤ 3.1 国内部署环境准备 3.2 模型选择与配置 3.3 通讯平台接⼊ 3.4 常⻅问题与解决 第四章 本地部署指南 4.1 系统要求与环境准备 4.2 Windows 部署 4.3 macOS 部署 4.4 Linux 部署 4.5 Docker 部署 4.6 云服务器部署 4.7 配置与优化 第五章 安全与最佳实践 5.1 安全⻛险分析 5.2 安全加固措施 5.3 权限管理 5.4 监控与审计 附录 A. 常⽤命令速查 B. 配置⽂件参考 C. 故障排除指南 D. 资源与社区 4 第⼀章 OpenClaw 简介 1.1 什么是 OpenClaw OpenClaw（曾⽤名 Clawdbot、Moltbot）是⼀款开源的个⼈ AI 助⼿平台，于 2026 年初在 GitHub 上迅速⾛红，成为近年来增⻓最快的开源项⽬之⼀。它能够在⽤⼾⾃⼰的设备上本地运 ⾏，通过 WhatsApp、Telegram、Discord、⻜书、钉钉等多种通讯平台与⽤⼾交互，实现从简单的 对话问答到复杂的⾃动化任务执⾏。 与传统的聊天机器⼈不同，OpenClaw 的核⼼价值在于其执⾏能⼒。它不仅能够理解⾃然语⾔ 指令，还能直接操作⽤⼾的电脑系统，包括读写⽂件、执⾏终端命令、控制浏览器、管理邮件和 ⽇历等。这种"从建议到⾏动"的能⼒跃迁，标志着 AI 助⼿从"顾问"⻆⾊向"数字员⼯"⻆⾊的转 变。 核⼼定位 OpenClaw 的定位是"Your own personal AI assistant"——⼀个真正属于⽤⼾的、可深度定制的 AI 助⼿，⽽⾮依赖云服务的第三⽅产品。 1.2 核⼼特性与优势 1.2.1 本地优先架构 OpenClaw 采⽤本地优先的设计理念，所有核⼼功能都在⽤⼾设备上运⾏，数据存储在本地⽽ ⾮云端。这种架构带来了以下优势： 数据隐私：敏感信息不会离开⽤⼾设备，避免了数据泄露⻛险 离线可⽤：配合本地模型（如 Ollama），即使断⽹也能使⽤ 完全控制：⽤⼾拥有对 AI 助⼿的完全控制权，可⾃由定制 零订阅费⽤：除模型 API 调⽤费⽤外，⽆其他持续成本 5 1.2.2 多平台通讯集成 OpenClaw ⽀持通过多种即时通讯平台与⽤⼾交互，让⽤⼾可以使⽤最熟悉的⼯具与 AI 助⼿ 对话： 表 1-1 OpenClaw ⽀持的通讯平台 平台 类型 特点 Telegram 国际 稳定可靠，推荐新⼿使⽤ WhatsApp 国际 ⽤⼾基数⼤，全球通⽤ Discord 国际 适合团队协作场景 Slack 国际 企业办公场景 ⻜书 国内 字节跳动出品，功能丰富 钉钉 国内 阿⾥巴巴出品，企业⽤⼾多 企业微信 国内 微信⽣态，易于推⼴ 1.2.3 技能插件系统 OpenClaw 的核⼼扩展机制是 Skills（技能）系统。每个 Skill 是⼀个包含 SKILL.md ⽂件的⽬ 录，⽤⾃然语⾔描述 AI 助⼿如何完成特定任务。这种设计具有以下特点： 零代码开发：⽆需编程，⽤⾃然语⾔描述即可创建新技能 热重载：修改后⽴即⽣效，⽆需重启服务 ⽣态丰富：ClawHub 上已有 3000+ 社区贡献技能 跨平台兼容：遵循 AgentSkills 标准，可在多个平台使⽤ 1.2.4 持久化记忆 OpenClaw 具备持久化记忆能⼒，能够记住⽤⼾的偏好、历史对话和上下⽂信息。记忆系统采 ⽤ Markdown ⽂件存储，便于⽤⼾查看和管理。这种设计使得 AI 助⼿能够： 记住⽤⼾的⻓期偏好和⼯作习惯 6 在多次对话中保持上下⽂连贯 主动提醒待办事项和⽇程安排 基于历史数据提供个性化建议 1.3 发展历程与现状 1.3.1 快速崛起 OpenClaw 于 2026 年 1 ⽉在 GitHub 上发布，迅速引发全球开发者社区的关注。以下是其发展 历程中的关键节点： 表 1-2 OpenClaw 发展历程 时间 ⾥程碑 GitHub Stars 2026年1⽉初 项⽬⾸次发布 0 2026年1⽉中旬 获得⼴泛关注 10万+ 2026年1⽉下旬 更名为 OpenClaw 13万+ 2026年2⽉初 持续迭代更新 16万+ 2026年2⽉中旬 ⽣态快速发展 18万+ 1.3.2 社区⽣态 OpenClaw 的快速发展得益于活跃的社区⽣态： 开发者社区：Discord 服务器拥有数万名活跃开发者 技能市场：ClawHub 托管超过 3000 个技能插件 云⼚商⽀持：阿⾥云、腾讯云等推出⼀键部署⽅案 中⽂社区：OpenClaw CN 提供本地化⽀持和⽂档 1.4 适⽤场景与⽤⼾群体 7 1.4.1 个⼈⽤⼾场景 对于个⼈⽤⼾，OpenClaw 可以作为全能的数字助⼿，帮助处理⽇常事务： 个⼈知识管理：整理笔记、归档⽂档、构建知识库 ⽇程与任务：管理⽇历、设置提醒、跟踪待办 信息聚合：⾃动抓取新闻、⽣成⽇报、监控感兴趣的话题 ⽂件处理：批量重命名、格式转换、内容提取 开发辅助：代码审查、⽂档⽣成、⾃动化测试 1.4.2 团队协作场景 在团队环境中，OpenClaw 可以承担更多协作型任务： 智能客服：7×24 ⼩时⾃动回复常⻅问题 数据报表：定时⽣成业务报表并推送到群聊 运维监控：监控服务器状态，异常时⾃动告警 内容创作：辅助撰写⽂案、⽣成图表、排版⽂档 流程⾃动化：串联多个系统，实现⼯作流⾃动化 1.4.3 开发者场景 对于开发者，OpenClaw 提供了丰富的扩展能⼒： 技能开发：创建⾃定义技能，封装业务逻辑 插件开发：开发系统级插件，扩展核⼼功能 集成测试：⾃动化测试、持续集成、部署流⽔线 原型验证：快速验证 AI 应⽤想法 8 第⼆章 海量全玩法攻略 2.1 基础功能使⽤ 2.1.1 ⾸次启动与配置 安装完成后，⾸次使⽤ OpenClaw 需要运⾏配置向导： $ openclaw onboard --install-daemon 配置向导会引导⽤⼾完成以下设置： [1] 1 ⾝份认证：使⽤ GitHub 账号登录，获取 OAuth 凭证 [2] 2 AI 模型配置：选择模型提供商（OpenAI、Anthropic、本地模型等）并设置 API Key [3] 3 通讯平台选择：选择要接⼊的聊天平台（可后续再配置） [4] 4 守护进程安装：将 Gateway 注册为系统服务，实现开机⾃启 2.1.2 基本交互⽅式 配置完成后，⽤⼾可以通过以下⽅式与 OpenClaw 交互： Web 控制台：打开浏览器访问 http://127.0.0.1:18789/ ，或通过命令启动： $ openclaw dashboard 即时通讯：在配置的聊天平台（Telegram、⻜书等）中直接与机器⼈对话 命令⾏：通过 CLI 发送指令： $ openclaw message send --target [⽤⼾ID] --message "你好" 2.1.3 常⽤命令 表 2-1 OpenClaw 常⽤命令 9 命令 功能 ⽰例 openclaw --version 查看版本 检查当前安装版本 openclaw status 查看状态 显⽰整体运⾏状态 openclaw doctor 诊断修复 ⾃动检测并修复问题 openclaw gateway status ⽹关状态 查看 Gateway 运⾏状态 openclaw gateway start 启动⽹关 ⼿动启动 Gateway openclaw gateway restart 重启⽹关 重启 Gateway 服务 openclaw logs --follow 查看⽇志 实时查看运⾏⽇志 openclaw models list 模型列表 显⽰可⽤模型 openclaw channels status 通道状态 查看通讯平台连接状态 2.2 ⽂件与⽂档处理 2.2.1 ⽂件操作 OpenClaw 具备强⼤的⽂件操作能⼒，可以通过⾃然语⾔指令完成各种⽂件管理任务： 创建⽂件： "在桌⾯上创建⼀个名为 project-ideas.md 的⽂件，内容包含三个 AI 创业项⽬想法" 批量处理： "把 Downloads ⽂件夹⾥所有的 PDF ⽂件移动到 Documents/PDF ⽬录，并按⽇期重命 名" 内容提取： 10 "读取 report.pdf 的内容，提取其中的关键数据并⽣成摘要" 2.2.2 ⽂档处理技能 OpenClaw 内置了多种⽂档处理技能： 表 2-2 ⽂档处理技能 技能 功能 典型⽤法 docx Word ⽂档处理 创建、编辑、格式转换 pdf PDF 操作 读取、合并、拆分、填写表单 pptx 演⽰⽂稿 制作 PPT、添加图表 xlsx 电⼦表格 数据处理、图表⽣成 markdown Markdown 处理 ⽂档编写、格式转换 2.2.3 实际案例 案例 1：批量⽣成报告 需求：每周⼀⽣成上周销售数据报告 "每周⼀上午 9 点，读取 sales-data.xlsx 中的上周数据，⽣成⼀份包含图表的销售报 告，保存为 Weekly-Report-YYYY-MM-DD.docx，并发送到销售群" 案例 2：⽂档归档 需求：⾃动整理下载⽂件夹 "每天凌晨 2 点，检查 Downloads ⽂件夹，按⽂件类型⾃动分类到 Documents 下的对应 ⼦⽂件夹，删除超过 30 天的临时⽂件" 11 2.3 浏览器⾃动化 2.3.1 浏览器控制 OpenClaw 可以控制浏览器执⾏各种⾃动化操作： ⽹⻚访问与截图： "打开 https://example.com，截取⾸⻚截图保存到 screenshots ⽂件夹" 数据抓取： "访问竞争对⼿的产品⻚⾯，提取产品价格、规格和⽤⼾评价，⽣成对⽐表格" 表单填写： "打开登录⻚⾯，输⼊⽤⼾名和密码，点击登录按钮" 2.3.2 浏览器技能配置 要使⽤浏览器功能，需要安装浏览器⼯具： $ openclaw skills install browser 配置⽆头浏览器（服务器环境）： { "browser": { "headless": true, "noSandbox": true, "executablePath": "/usr/bin/google-chrome" } } 12 2.3.3 监控与定时任务 价格监控： "每⼩时检查⼀次某电商⽹站的产品价格，如果价格低于 500 元，⽴即发送通知" ⽹站监控： "每 5 分钟检查公司官⽹是否正常访问，如果⽆法访问或响应时间超过 3 秒，发送告 警" 2.4 系统命令执⾏ 2.4.1 终端命令 OpenClaw 可以执⾏系统终端命令，实现更深度的系统集成： 系统信息查询： "查看当前系统的 CPU 和内存使⽤情况" 软件安装： "安装 Node.js 18 版本" Git 操作： "克隆 https://github.com/user/repo.git 到 workspace ⽬录，切换到 dev 分⽀" 2.4.2 开发⼯作流 ⾃动化部署： 13 "拉取最新代码，运⾏测试，如果测试通过则构建并部署到⽣产环境" 代码审查： "检查最近的 Git 提交，分析代码变更，⽣成审查报告" 安全提醒 系统命令执⾏功能具有⾼⻛险，建议在沙箱环境中使⽤，或严格限制可执⾏的命令范围。 2.5 通讯平台集成 2.5.1 Telegram 集成 Telegram 是 OpenClaw 官⽅推荐的通讯平台，配置简单且稳定： 配置步骤： 1. 在 Telegram 中搜索 @BotFather，创建新机器⼈ 2. 获取 Bot Token 3. 运⾏配置命令： $ openclaw configure 选择 Telegram 渠道，输⼊ Bot Token 完成配置。 2.5.2 ⻜书集成 ⻜书是国内⽤⼾常⽤的办公平台，OpenClaw 提供了完整的⻜书⽀持： 创建⻜书应⽤： 1. 访问⻜书开放平台（open.feishu.cn） 2. 创建企业⾃建应⽤，选择机器⼈类型 14 3. 在"凭证与基础信息"中获取 App ID 和 App Secret 4. 在"权限管理"中开启所需权限 5. 在"事件与回调"中添加事件订阅 配置权限： { "scopes": { "tenant": [ "im:message", "im:message:send_as_bot", "im:chat:readonly", "contact:user.employee_id:readonly" ] } } 2.5.3 钉钉集成 钉钉集成需要创建企业内部应⽤： 1. 访问钉钉开放平台（open.dingtalk.com） 2. 创建企业内部应⽤ 3. 获取 AppKey 和 AppSecret 4. 配置机器⼈回调地址 2.6 技能插件系统 2.6.1 技能概述 Skills 是 OpenClaw 的能⼒扩展层，让 AI 助⼿能够执⾏特定任务。每个 Skill 包含： SKILL.md ：技能描述⽂档 tools/ ：⼯具脚本（可选） prompts/ ：提⽰词模板（可选） 15 2.6.2 技能来源 表 2-3 技能来源优先级 来源 路径 优先级 ⼯作区技能 workspace/skills/ 最⾼ 本地技能 ~/.openclaw/skills/ 中 内置技能 系统内置 最低 2.6.3 常⽤技能推荐 表 2-4 推荐技能列表 技能 功能 适⽤场景 serpapi 联⽹搜索 获取实时信息 github GitHub 操作 代码管理 obsidian 笔记管理 知识库构建 notion Notion 集成 团队协作 spotify-player ⾳乐控制 娱乐场景 summarize 内容摘要 信息处理 2.6.4 技能安装与管理 从 ClawHub 安装： $ clawhub search "关键词" $ clawhub install 技能名称 16 查看已安装技能： $ openclaw skills list 更新技能： $ clawhub update 技能名称 2.7 ⾼级应⽤场景 2.7.1 个⼈知识库构建 利⽤ OpenClaw 构建个⼈知识管理系统： "把我发给你的所有⽂章链接、PDF 和笔记都保存到知识库，⾃动分类打标签，当我提 问时能够基于知识库内容回答" 实现⽅案： 1. 安装 obsidian 或 notion 技能 2. 配置知识库存储路径 3. 设置⾃动归档规则 4. 启⽤ RAG（检索增强⽣成）功能 2.7.2 ⾃动化⼯作流 内容创作流⽔线： "每天早上 8 点，抓取科技新闻⽹站的头条，⽣成⼀份中⽂摘要，保存到⽂档并发送到 我的邮箱" 数据监控告警： 17 "每 10 分钟检查数据库的连接数和慢查询数量，如果超过阈值⽴即在运维群发送告警" 2.7.3 多智能体协作 部署多个 OpenClaw 实例，各⾃负责不同任务，通过共享记忆协同⼯作： 研究助⼿：负责信息搜集和整理 写作助⼿：负责内容创作和润⾊ 审核助⼿：负责质量检查和校对 2.7.4 智能家居控制 结合智能家居 API，实现语⾳控制： "我要睡觉了" → ⾃动调暗灯光、关闭窗帘、降低空调温度 需要安装对应的智能家居技能，如 Philips Hue、Sonos 等。 18 第三章 国内⽹络使⽤ 3.1 国内部署环境准备 3.1.1 ⽹络环境说明 在国内使⽤ OpenClaw，最⼤的优势是⽆需梯⼦即可完成部署和使⽤。这得益于以下设计： OpenClaw 本体代码托管在国内可访问的镜像源 ⽀持国内⼤模型 API（阿⾥云百炼、智谱 AI 等） 通讯平台⽀持国内应⽤（⻜书、钉钉、企业微信） 纯国内⽹络⽅案 通过使⽤阿⾥云百炼、智谱 GLM 等国内模型，配合⻜书/钉钉等国内通讯平台，可以实现完 全在国内⽹络环境下的 OpenClaw 部署和使⽤。 3.1.2 安装源配置 为了加快下载速度，建议使⽤国内 npm 镜像源： $ npm config set registry https://registry.npmmirror.com 或者使⽤ nrm 管理镜像源： $ npm install -g nrm $ nrm use taobao 3.1.3 中⽂社区版本 国内社区提供了汉化版本的 OpenClaw，包含以下优化： 19 全中⽂界⾯（CLI 和 Dashboard） 预装国内常⽤技能 针对国内⽹络优化的安装脚本 中⽂⽂档和社区⽀持 安装命令： $ curl -fsSL https://clawd.org.cn/install.sh | bash 3.2 模型选择与配置 3.2.1 国内模型推荐 表 3-1 国内可⽤模型对⽐ 模型 提供商 特点 适⽤场景 GLM-4.7 智谱 AI 中⽂能⼒强，代码能⼒优秀 通⽤任务、编程 Qwen-Max 阿⾥云 ⻓⽂本⽀持好 ⽂档处理、分析 DeepSeek-V3 DeepSeek 性价⽐⾼ 成本敏感场景 ERNIE-Bot 百度 中⽂理解深⼊ 中⽂内容创作 3.2.2 阿⾥云百炼配置 阿⾥云百炼是国内使⽤最⼴泛的模型平台之⼀，配置步骤如下： 获取 API Key： 1. 登录阿⾥云控制台（www.aliyun.com） 2. 进⼊"百炼⼤模型"服务 3. 在"密钥管理"中创建 API Key 4. 复制 Access Key ID 和 Access Key Secret 配置 OpenClaw： 20 运⾏配置向导时选择阿⾥云百炼，或在配置⽂件中⼿动添加： { "agents": { "defaults": { "model": "qwen-max" } }, "models": { "providers": { "aliyun": { "apiKey": "your-api-key", "baseUrl": "https://dashscope.aliyuncs.com/api/v1" } } } } 3.2.3 智谱 AI 配置 智谱 AI 的 GLM 系列模型在国内表现优秀，配置⽅法：