OpenClaw
·
OpenClaw（曾⽤名 Clawdbot、Moltbot, 昵称"⼩⻰虾"）是⼀款开源的, 本地优先的AI 智能体. 与传统的聊天机器⼈不同, 它不仅能"说", 还能直接操控计算机完成实际操作.
OpenClaw
表格一：OpenClaw 功能场景示例
| 类别 | 示例 |
|---|---|
| 文件管理 | 帮我整理下载文件夹，按日期分类 |
| 信息检索 | 搜索本周关于人工智能的新闻并汇总 |
| 日程安排 | 下周三下午帮我预约会议室并发送邀请 |
| 代码辅助 | 检查这个 Python 脚本的错误并修复 |
| 自动化任务 | 每天早上8点抓取最新文章并推送到飞书 |
表格二：OpenClaw 与主流 AI 工具对比
| 特性 | OpenClaw | DeepSeek/豆包/ChatGPT |
|---|---|---|
| 运行方式 | 本地部署，数据不出电脑 | 云端服务，数据上传服务器 |
| 核心能力 | 自主执行操作 | 对话问答、内容生成 |
| 扩展能力 | Skill 无限扩展 | 功能相对固定 |
| 成本 | 免费开源 + API 调用费 | 免费版或订阅制 |
| 适用人群 | 有一定技术基础的用户 | 普通用户开箱即用 |
系统架构概览
OpenClaw 采⽤分层架构设计, 将复杂的功能模块化, 便于理解和扩展.
用户交互层: 系统⼊⼝. ⽤⼾可以通过WebUI, CLI, Telegram, IMessage等不同渠道发送指令.
Gateway(⽹关): 整个系统的核⼼. 连接各种聊天平台和控制界⾯, 把收到的消息派发给Agent处理
Agent(智能体): Openclaw的⼤脑, 负责理解⽤⼾意图、制定分步计划、判断调⽤哪些⼯具或技能
(反复调⽤, 不是⼀次就完事)
⼯具与技能层: 助理的⼯具箱, 包含操作浏览器、处理⽂件、调⽤ API等功能. 可以通过Skill 来扩展
技能. Skill 是独⽴模块, 遵循标准化接⼝, 可被 Agent 调⽤. Agent 决定做什么, Skills 决定怎么做, 两
者缺⼀不可.
这个过程类似于
1.Gateway 是⻔卫: 只接客、不⼲活, 确保消息不混乱
2.Agent Runtime 是办事员: 有脑⼦（会规划）、没⼿（需⼯具）、要请教（问⼤模型）
3.⼯具系统是⼿: 原⼚带基础⼯具, Skills机制让你⽆限扩展超能⼒
openclaw的安装部署搭建大家可以自己搜索。
这里就不过多讲述，可以私信问我。
常见问题在部署和使⽤OpenClaw的过程中, 你可能会遇到⼀些问题. 以下是常⻅问题及其解决⽅案.Q1: 安装完成后运⾏ openclaw 提示command not foundA: 安装路径未加⼊系统PATHQ2: 云端部署后⽆法通过公⽹IP访问WebUIA: OpenClaw默认只监听 127.0.0.1 , 推荐使⽤SSH隧道的⽅式,Q3: Windows WSL安装后, Windows浏览器⽆法访问 localhost:18789A: WSL2的⽹络与Windows宿主机隔离, 需要修改配置将Gateway绑定到所有接⼝（仅开发环境）Q4: 对话时提⽰ API Key invalid 或 401 UnauthorizedA: 确认Key配置是否正确, 以及是否过期Q5: 配置时⼀不小心点错了, 或者需要修改配置A: 重新运⾏ openclaw config 进⾏配置即可
核心功能介绍
掌握了OpenClaw的安装与配置, 接下来我们将深⼊了解它的核⼼功能. 将介绍⽇常使⽤中最常用的命令, 以及系统内置的⼯具集, 帮助快速上⼿并安全地驾驭这只"⼩⻰虾".
⽹关相关命令
openclaw gateway |
启动网关服务（后台核心进程） |
openclaw gateway stop |
停止网关服务 |
openclaw gateway restart |
重启网关服务（配置修改后常用） |
openclaw gateway status |
查看网关运行状态 |
⽤⼾界⾯命令
OpenClaw 提供两种交互界⾯: TUI（终端界⾯）和 WebUI（⽹⻚界⾯）
openclaw tui |
启动终端用户界面，在命令行中与AI对话 |
openclaw dashboard |
启动Web用户界面，自动打开浏览器访问控制台 |
配置管理命令
openclaw onboard |
重新运行配置向导 |
openclaw configure |
进入配置向导，重新配置模型、渠道等 |
openclaw config get |
查看当前配置，显示合并后的完整配置 |
openclaw config set <key> <value> |
修改特定配置项，例如 openclaw config set gateway.port 19000 |
openclaw doctor |
诊断系统环境，检查配置是否正确 |
openclaw doctor --repair |
诊断并尝试自动修复常见问题 |
Skill 管理命令
Skill 是 OpenClaw 的功能扩展模块, 这些命令⽤于管理 Skill 的安装、启⽤和更新
openclaw skills list |
列出已安装的Skills |
openclaw skills install <name> |
安装指定Skill，例如 openclaw skills install weather |
openclaw skills uninstall <name> |
卸载指定Skill，例如 openclaw skills uninstall weather |
openclaw skills enable <name> |
启用Skill |
openclaw skills disable <name> |
禁用Skill |
openclaw skills search <keyword> |
搜索Skill |
openclaw skills check <name> |
检查Skill状态 |
其他实⽤命令
openclaw models list |
列出当前配置支持的所有模型 |
openclaw version |
显示OpenClaw版本信息 |
openclaw update |
升级OpenClaw，更新到最新版本 |
openclaw uninstall |
卸载OpenClaw（完全移除，会提示是否保留配置） |
快速参考卡片
⽇常使⽤流程: 1. openclaw gateway # 启动服务 2. openclaw tui # 或 dashboard, 开始对话 3. openclaw gateway stop # 使⽤完毕停⽌服务 配置变更流程: 1. openclaw config set # 修改配置 2. openclaw gateway restart # 重启⽣效 3. openclaw doctor # 确认运⾏正常
使⽤提⽰:1.⾸次使⽤推荐先运⾏ openclaw configure 完成基础配置.2.启动Gateway后, 可以通过 openclaw tui 或 openclaw dashboard 与AI交互, 两者可同时使⽤.3.修改配置⽂件后, 通常执⾏ openclaw gateway restart 使更改⽣效
内置⼯具概览
内置⼯具（Built-in Tools）是 OpenClaw 的核⼼能⼒载体. 它们让 AI 从"只能说话"进化为"能够动⼿", 是实现本地优先 AI Agent 的关键.
内置⼯具介绍
内置⼯具是OpenClaw⾃带的⼀组可直接调⽤的功能模块. 它们通过标准化的接⼝暴露给 AI, 使 AI 能够执⾏从⽂件操作到浏览器⾃动化的各类任务. 当智能体需要执⾏具体操作时（如读取⽂件、发送HTTP请求、执⾏系统命令）, 它会调⽤相应的⼯具来完成.
内置⼯具与Skills的关系:• 内置⼯具是基础能⼒, 由OpenClaw核⼼提供, ⽆需安装.• Skill是基于内置⼯具或外部API构建的更⾼层功能模块, 可单独安装和卸载
内置⼯具按功能来分, 主要类别有:
https://docs.openclaw.ai/zh-CN/tools
| 类别 | 工具名 | 功能说明 |
|---|---|---|
| 文件操作 (group: fs) | read |
读取文件内容 |
write |
创建或覆盖写入文件 | |
edit |
精确替换文件中的内容 | |
| 执行工具 (group: runtime) （高危工具，允许AI执行系统命令和进程管理） |
exec |
在工作区中运行 shell 命令 |
process |
管理后台 exec 会话 | |
| 网络工具 (group: web) | web_search |
搜索引擎查询（需配置 Brave API Key） |
web_fetch |
获取网页内容 | |
| 定时任务 | cron |
管理定时任务（添加、更新、删除、立即运行）和唤醒事件 |
内置⼯具使⽤（补充)
安全提醒
⚠️ 特别警告: exec ⼯具是OpenClaw中最强⼤也最危险的组件. 它允许智能体执⾏任意系统命
令, 相当于将系统控制权交给了AI. 如果使⽤不当或被恶意利⽤, 可能导致严重后果
安全使⽤建议:1. 环境隔离: 在隔离环境中运⾏OpenClaw（如虚拟机、Docker容器、WSL2）, 避免直接影响宿主机重要数据.绝对不要在⽣产服务器或个⼈主⼒机上直接运⾏ OpenClaw2. 最⼩权限原则: 不要在OpenClaw中配置具有过⾼权限的API Key或系统账⼾.3. 定期检查: 使⽤ openclaw doctor 检查配置安全状态, 关注官⽅安全公告
OpenClaw 通道(Channels)配置
在完成OpenClaw的基础部署和配置后, 下⼀步是将其与⽇常使⽤的即时通讯(IM)平台集成. 通过通道 (Channels)配置, 你可以在⻜书、钉钉、企业微信等平台上直接与AI助⼿对话, 让AI真正成为团队协作的⼀员.
通道概述
Channel（通道）是OpenClaw与外部IM平台的连接桥梁. 它负责接收来⾃IM平台的消息, 将其转发给OpenClaw处理, 并将AI的回复返回给⽤⼾. 通过Channel机制, 你可以将OpenClaw接⼊到⽇常⼯作沟通的软件中, 实现"在聊天框⾥唤AI"的体验.
⽀持的IM平台
OpenClaw官⽅和社区提供了丰富的Channel⽀持, 覆盖国内外主流IM平台:
• 国内常⽤: ⻜书、钉钉、企业微信
• 国际常⽤: Telegram、Discord、Slack、WhatsApp等
Channel⼯作原理
Channel的⼯作流程可以概括为以下流程步骤:
1. 用户发送消息: 用户在飞书、钉钉等 IM 平台中, @机器⼈或直接发送私聊消息2. 平台转发: IM平台将消息通过Webhook或WebSocket推送到OpenClaw Gateway3. Gateway处理: Gateway接收消息, 验证消息来源的合法性（如检查签名、Token）, 并将不同平台的消息格式统⼀转换成 OpenClaw 内部标准格式。4. Agent处理: Agent（智能体）理解⽤⼾意图, 根据需求规划任务, 并调⽤内置⼯具或已安装的 Skills 来执行。5. 回复返回: Agent 整合⼯具返回的结果, 生成自然语言回复, 将回复交给 Gateway.6. 用户接收: 用户在 IM 平台中看到 AI 的回复, 整个交互完成Channel与Gateway之间通常采⽤Webhook（HTTP回调）或WebSocket（⻓连接）两种通信⽅式
飞书配置
钉钉配置
其他通道
除了⻜书和钉钉, OpenClaw还⽀持多种其他IM平台. 以下为参考⽂档:
• 企业微信: 使⽤插件关联⻓连接智能机器⼈与OpenClaw
• QQ: 快速注册创建QQ机器⼈
• Telegram: Telegram - OpenClaw
• Discord: Discord - OpenClaw
Skill概述与使用
Skill概述与核⼼特点
Skill（技能）是OpenClaw功能扩展的核⼼机制, 也是其最强⼤的特性之⼀, 它以标准化接⼝将特定技能封装成⼀个独⽴的软件包, 赋予AI⽆限的可能性.
如果说OpenClaw是⼀个"数字员⼯", 那么Skill就是这名员⼯的"专业技能证书"——决定了它能帮你做什么具体的事.
与简单的Prompt⼯程不同, Skill是可编程、可复⽤、可组合的功能模块. ⼀个Skill可以:
• 调⽤外部API获取实时数据（如天⽓、股票、新闻）
• 执⾏本地系统命令（如⽂件操作、程序运⾏）
• 与第三⽅服务集成（如⻜书、钉钉、GitHub）
• 封装复杂的业务逻辑（如数据分析、格式转换）
类⽐理解:• Agent（智能体） = ⼤脑, 负责理解意图和决策• Skill（技能） = 双⼿, 负责实际执⾏具体操作• Tools（⼯具） = 原⼚⾃带的基础能⼒（如⽂件读写、浏览器控制）Agent（智能体）通过读取 Skill 的描述信息, 理解其功能和使⽤⽅法, 并在适当时机⾃动调⽤, 下达的任务.简单来说, Skill 就是让 AI 学会做⼀件事的"说明书+⼯具包".
Skill 的核⼼特点• 模块化设计每个 Skill 都是⼀个独⽴的功能单元, 像乐⾼积⽊⼀样可以⾃由组合、拆装. 想添加新功能？直接插上⼀块新积⽊就⾏, 不会影响整体结构, 也便于维护和复⽤.• 标准化接⼝所有 Skill 遵循统⼀的接⼝规范（如输⼊参数格式、输出结构）. Agent ⽆需"认识"每个 Skill 的细节, 只需按照规范对话就能⾃动识别和调⽤, 极⼤降低了扩展成本.• 即插即⽤安装 Skill 后⽴刻⽣效, ⽆需修改 OpenClaw 的核⼼代码, 也⽆需重启整个系统（⼤部分情况）. 你甚至可以在对话中动态加载新技能, 体验"边说边装"的便捷.•⽣态丰富ClawHub 官⽅市场收录了成千上万个 Skill, 覆盖搜索、办公、开发、⽣活、娱乐等多个领域. 社区开发者也可以⾃由发布和分享⾃⼰的 Skill, 共同构建丰富的功能⽣态.例如: 天⽓查询 假如你和OpenClaw聊天:你: 明天去北京出差, 需要带伞吗？OpenClaw: 我查⼀下北京的天⽓……（⾃动调⽤ weather Skill）明天北京⼩⾬, ⽓温 12~18℃, 建议带伞
Skill ⽣态与ClawHub市场OpenClaw 的 Skill ⽣态由 ClawHub 官⽅市场 和 社区贡献 共同构成:• ClawHub 市场ClawHub 是 OpenClaw 的官⽅技能市场, 收录了数千个经过审核的技能. 分类清晰, ⽀持⼀键安装和⾃动更新, 类似 npm 对于 Node.js, pip 对于 Python, 你可以像在应⽤商店⾥⼀样, 浏览、搜索、安装⾃⼰需要的 Skill• 社区分享开发者可以⾃由发布⾃⼰的 Skill, 分享给全球⽤⼾. ⽆论是个⼈⼩⼯具, 还是企业级集成, 都能成为⽣态的⼀部分. 这种开放机制极⼤地激发了创造⼒, 让 Skill 的数量和种类持续增⻓
内置Skill介绍OpenClaw ⾃带了⼀些内置 Skill, 开箱即⽤, ⽆需额外安装即可享受基础能⼒.有以下⼏种查看⽅式1.命令行openclaw skills list2.通过Web UI可以查看内置的Skill3.通过对话来了解OpenClaw内置的Skill 有哪些比如这么说：请帮我列出 OpenClaw 中所有内置的 Skill, 并按以下两类进⾏介绍:1. 可直接使⽤的 Skill: ⽆需额外配置, 安装后即可直接调⽤的功能.2. 需要配置才可使⽤的 Skill: 需要设置环境变量、API 密钥、安装依赖或修改配置⽂件后才能正常使⽤的功能.请为每个 Skill 简要说明其⽤途, 对于需要配置的 Skill, 请说明需要配置哪些内容（如 APIKey、服务地址、环境变量等）
两个常⽤的内置 Skill 及其配置⽅式
weatherweather Skill 允许 Agent 查询全球任意城市的实时天⽓和未来预报, 包括温度、湿度、⻛速、天⽓状况（晴/⾬/雪等）以及降⽔概率, ⽆需配置, 可以直接使⽤.
video-frames功能说明: 从视频中提取帧或短⽚段, ⽀持多种视频格式和提取模式, 依赖 ffmpeg ⼯具. 可⽤于⽣成视频缩略图、预览帧等.需要安装 ffmpeg:#macOS brew install ffmpeg #Linux-Ubuntun apt install ffmpeg #Linux-CentOS yum install ffmpeg #Windows 下载 ffmpeg 并添加到 PATH
Skill 搜索与安装
除了内置 Skill, 你还可以从 ClawHub 市场搜索和安装更多实⽤的第三⽅ Skill. OpenClaw 提供了多种安装⽅式, 满⾜不同场景下的使⽤习惯.
Skill的安装⽅式
命令⾏安装(推荐)
使⽤ clawhub CLI ⼯具是最专业、最⾼效的⽅式, ⽀持版本管理和⾃动更新.
1.安装 ClawHub CLI⼯具
npm i -g clawhub
2.搜索并安装Skill
# 搜索 Skill（⽀持⾃然语⾔）
clawhub search "tavily"
# 安装 Skill
clawhub install openclaw-tavily-search
3.观察Skill 是否安装成功
clawhub list
通过聊天⼯具安装
可以直接通过对话框来安装skill
1. 从 ClawHub 官⽹下载 Skill 的 .zip ⽂件
2. 在聊天窗⼝中将 zip ⽂件发送给 OpenClaw
3. OpenClaw 会⾃动识别并询问是否安装, 回复"确认"即可完成安装.
两个常⽤的第三⽅ SkillTavilyWebSearch - 实时联⽹搜索TavilyWebSearch 是⼀个基于 Tavily API 的联⽹搜索 Skill. 它允许 Agent 实时查询互联⽹信息, 返回结构化的搜索结果（包括标题、摘要、链接等）, 适⽤于需要最新资讯、事实核查或动态数据的场景. 与内置搜索不同, 该 Skill 专为 AI 应⽤优化, 返回结果更⼲净、更易于解析.Playwright - 浏览器⾃动化Playwright 是⼀个基于 Microsoft Playwright 的浏览器⾃动化 Skill. 它赋予 OpenClaw 完整的浏览器控制能⼒, ⽀持动态⽹⻚渲染、表单交互、截图保存、以及绕过 Cloudflare 等反爬机制. 与内置的web_fetch 不同, 该 Skill 可以执⾏ JavaScript、模拟真实⽤⼾⾏为, 并提供 Simple 和 Stealth 两种模式, 适⽤于需要复杂⽹⻚操作或抓取动态内容的场景.
Skill开发入门
Skill格式介绍1.⽬录结构规范Skill 本质上是⼀个⽂件夹, 核⼼是包含⼀个 SKILL.md ⽂件. 这个⽂件包含元数据（ name 和description 是必须的）以及指导 Agent 执⾏特定任务的指令.my-skill/ ├── SKILL.md # 必需: 指令 + 元数据 ├── scripts/ # 可选: 可执⾏代码 ├── references/ # 可选: 参考⽂档 └── assets/ # 可选: 模板、资源⽂件2.SKILL.md⽂件规范这是每个SKill唯⼀必需的⽂件, 必须放在技能⽂件夹的根⽬录下. 它采⽤ YAML 前置元数据 +Markdown 指令 的格式.name: pdf-processing description: Extract PDF text, fill forms, merge files. Use when handling PDFs. --- # PDF Processing ## When to use this skill Use this skill when the user needs to work with PDF files... ## How to extract text 1. Use pdfplumber for text extraction... ## How to fill forms ...必需元数据: ⽂件开头必须包含以下两个字段:◦ name : 技能的简短标识符.◦ description : 描述技能的功能及使⽤场景. Agent 在启动时只加载这个描述, ⽤于判断何时调⽤该技能.指令正⽂:◦ 元数据之后, 使⽤ Markdown 编写详细的步骤、指南或提⽰, 告诉 Agent 如何完成任务. 这部分内容仅在技能被激活时加载.◦ ⽆严格的结构限制, 可以包含任意 Markdown 内容◦ 建议包含清晰的任务分解、步骤说明、代码⽰例等3. 可选⽬录为了保持结构清晰, 扩展资源应放在以下⼦⽬录中:• scripts/ : 存放可执⾏的脚本（如 Python、Bash ⽂件）. Agent 可在执⾏任务时运⾏它们.• references/ : 存放参考⽂档或额外信息（如 API ⽂档、详细说明）, 供 Agent 按需读取.• assets/ : 存放模板、图⽚、样式⽂件等静态资源, ⽤于⽣成输出或辅助⼯作流.4. 设计原则这个规范遵循渐进式披露机制, 以⾼效管理上下⽂:1. 发现阶段: 启动时, Agent 只加载所有 Skill 的 name 和 description , ⽤于判断是否可能相关2. 激活阶段: 当任务匹配某个技能描述时, Agent 加载完整的 SKILL.md 指令.3. 执⾏阶段: Agent 按照指令执⾏任务, 按需引⽤其他⽂件或执⾏打包的代码.这种⽬录结构的优势:• ⽂档化: 直接阅读 SKILL.md 就能理解 Skill 的功能• 可扩展性: 从简单的⽂本指令到复杂的可执⾏代码都能⽀持• 可移植性: 纯⽂件形式, 易于编辑、版本控制和分享
skill理解为 给AI写的一份 岗位操作手册+配套工具箱
开发语⾔与⼯具
开发⼀个 Skill，本质上就是写⼀个说明书（SKILL.md）+ 准备⼀套⼯具(scripts, 可选脚本), 所以对编程语⾔没有硬性限制.
⽬前最常⽤的开发语⾔有三类：
| 语言 | 适用场景 | 典型 Skill 示例 | 开发工具推荐 |
|---|---|---|---|
| Python | 数据处理、AI 模型调用、文件处理、自动化脚本 | PDF 处理、数据分析、图像识别 | VS Code / PyCharm |
| JavaScript / Node.js | 网页操作、浏览器自动化、Web API 调用 | Playwright 网页抓取、API 集成 | VS Code / WebStorm |
| Bash / Shell | 系统命令、文件操作、环境配置 | 系统管理、批量处理、部署脚本 | Terminal / iTerm2 |
开发步骤
1. 写 SKILL.md：⽤ VS Code 打开⽂件夹，新建 SKILL.md ，填写元数据和指令
2. 写脚本：在 scripts/ 下写 compress.py ，实现压缩逻辑
3. 本地测试：在终端运⾏ python scripts/XXX.py 确保脚本没问题
4. 安装到 OpenClaw： clawhub install ./XXX 或复制到 skills ⽬录
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
3
0- 0
已为社区贡献3条内容
所有评论(0)