《OpenClaw新手入门宝典》是由九章云极智能研究院于2026年3月发布的系统化教程,旨在帮助零基础用户多面了解、安装并熟练使用OpenClaw。OpenClaw是一个本地优先的AI智能体平台,其核心价值在于为大型语言模型赋予“动手执行”的能力,使其从聊天助手升J为能操作文件、浏览器、终端等系统的“数字员工”。文档内容结构清晰,循序渐进,涵盖了从概念认知、环境准备、安装部署、接入常用办公软件(飞书/微信),到深入理解其核心组件Skill的原理与实战的完整路径,Z终目标是让用户能够部署属于自己的AI全能助手,并利用其自动化处理各类重复性任务。
本部分详细说明了部署OpenClaw所需满足的软硬件及网络环境。官方支持的操作系统包括Linux、macOS、Windows以及云容器实例,其中Windows用户被强烈建议使用WSL2以避免兼容性问题。核心软件依赖包括需要安装Node.js 22.x或更高版本、Git以及一个模型后端,模型后端可选择云端API或本地服务。网络方面,使用云端模型需能稳定访问相应API,使用本地模型则可离线运行。系统默认开放18789端口用于WebSocket通信。安全上要求本地部署需管理员权限,并建议启用官方权限过滤策略。文档为新手提供了快速部署建议,即使用官方提供的一键安装脚本。同时,也给出了免部署的替代方案,即直接使用九章智算云提供的OpenClaw托管服务。
本部分以图文并茂的形式,一步步引导用户完成OpenClaw的安装与初步使用。先指导用户检查并确保安装正确版本的Node.js。随后,通过一行命令npm install -g openclaw@latest进行全局安装。安装成功后,运行openclaw onboard --install-daemon命令启动初始化向导。向导会交互式地引导用户完成核心配置:包括选择快速启动模式、配置模型提供商(文档示例为MiniMax)并输入API Key、跳过或配置聊天渠道、选择安装必要的Hooks钩子。关键一步是选择访问方式,文档示例选择了“Open the Web UI”,以便通过浏览器访问OpenClaw的控制面板。配置完成后,在Web UI或终端中即可与OpenClaw进行次对话测试。文档Z后还列出了Gateway启动失败、发送消息无回复、Web UI打不开等常见问题的排查思路与解决方法。
本部分详细讲解了如何将OpenClaw机器人接入飞书,实现通过飞书对话操控AI执行任务。整个流程分为四个明确步骤。D一步,在飞书开放平台创建企业自建应用,获取App ID和App Secret,并为应用添加机器人能力、配置消息接收权限,Z后发布应用。第二步,在OpenClaw侧启用feishu插件,并通过openclaw channels add命令交互式地添加飞书渠道,输入从飞书平台获取的凭证。第三步,回到飞书开放平台,在应用的事件与回调中启用“长连接”事件订阅,并确保已订阅“接收消息”事件。文档特别强调了操作顺序的重要性,需要在OpenClaw网关启动且配置好渠道后,才能在飞书平台开启长连接。第四步,在飞书客户端中找到该应用,次交互时会收到一个配对码,需在OpenClaw命令行中完成配对验证,之后即可在飞书中正常@机器人或私聊发送指令。
本部分介绍了通过企业微信间接实现微信接入OpenClaw的方案。由于微信官方接口限制,此方案需先注册一个企业微信,并在其中创建自建应用。核心步骤包括:在企业微信后台创建应用并记录AgentId和Secret;在应用内配置API接收地址,该地址需为公网可访问的URL,并设置Token和EncodingAESKey;在OpenClaw中安装专门的@openclaw-china/wecom-app插件,并在配置文件中填入企业微信的相关凭证和API接收配置;重启OpenClaw网关后,回到企业微信完成API地址的保存。Z后,在企业微信后台开启“微信插件”并扫码关注,即可在个人微信中收到一个企业微信消息入口,通过此入口即可与背后的OpenClaw机器人对话。文档指出,此方案需要公网IP,因此本地部署可能无法满足,并推荐使用其云容器实例产品。
本部分深入剖析了OpenClaw扩展能力的核心——Skill。Skill被定义为一个包含指令的文件夹,用于教AI如何处理特定任务,其价值在于“一次编写,永久复用”,能标准化工作流并降低使用门槛。一个Skill文件夹的核心是SKILL.md文件,其中包含YAML元数据和自然语言编写的详细指令。文档用厨房比喻区分了Skill和MCP:MCP像是提供工具和食材的厨房,负责连接外部服务;而Skill则是食谱,指导AI如何有效使用这些工具。Skill的设计遵循三大核心原则:渐进式披露以优化Token消耗、可组合性以支持多技能协同、可移植性以跨平台使用。常见的Skill用例分为文档与资源创建、工作流自动化、MCP增强三类。技术规范部分详细规定了Skill的文件结构、命名规则,并重点说明了SKILL.md中YAML前置元数据的必需字段和格式。
本部分通过具体示例演示了Skill的创建、安装与使用。先,通过一个“字幕转markdown”的简单Skill示例,展示了从创建文件夹、编写SKILL.md到在Claude中加载并成功调用的全过程。接着,介绍了如何从ClawHub、skill4agent等资源站点搜索和安装现有的社区Skill。文档还说明了如何使用openclaw skills list等命令检查和管理已安装的Skill。重点展示了如何利用“skill-creator”这个Skill,通过自然语言对话来创建新的Skill。之后,以“daily-report”Skill为例,说明了在OpenClaw中调用Skill的几种方式。Z后,文档提供了一份详尽的推荐Skill清单,分为核心必备、效率工具、内容创作、社媒运营和设备联动五大类,并列举了如文件处理、浏览器自动化、日程管理、知识库同步等大量实用技能。
文档在Z后部分汇总了与OpenClaw相关的大量官方与社区资源链接,为用户提供了延伸学习和问题解决的入口。其中包括OpenClaw的官方文档、GitHub仓库、技能市场,以及Discord、Reddit、Hacker News等社区讨论区。此外,还列出了多家科技媒体对OpenClaw及其创始人动态的新闻报道,以及项目版本更新日志的追踪地址,帮助用户保持对项目Z新进展和安全更新的关注。

![]() |
| 机器人底盘 Disinfection Robot 消毒机器人 讲解机器人 迎宾机器人 移动机器人底盘 商用机器人 智能垃圾站 智能服务机器人 大屏机器人 雾化消毒机器人 展厅机器人 服务机器人底盘 具身智能教育机器人 智能配送机器人 导览机器人 |