OpenClaw 简介
OpenClaw 是 Moltbot/Clawdbot 的最新正式名称。核心定位是通过自然语言指令，替代人工完成流程化、重复性工作，无需用户掌握编程技能，适配多场景自动化需求。
OpenClaw 是一个开源的个人 AI 助手平台。简单来说，它是一个可以将你自己的 AI 助手接入你已经在用的即时通讯工具（Telegram、WhatsApp、飞书等）的系统。你可以自己挑选 AI 模型进行连接，添加各种工具和技能，构建专属工作流。
注意：OpenClaw 需要访问不少本地权限和文件。建议找一台没有数据的 Mac 来试水，避免自己的隐私数据泄露。
准备工作
在开始之前，请确认你的 Mac 满足以下条件：
- macOS Sonoma 或更新版本（推荐使用 Apple Silicon M1 及以上芯片，性能会更好）。
- 流畅的网络环境，必要时可能需要配置网络代理（部分依赖库需要从 GitHub 下载）。
官方网站：https://openclaw.ai/
安装方式选择
官网提供四种安装方式：
- **One-liner：**一键脚本安装，最简单、官方推荐。适合个人用户快速体验。缺点是侵入性较强，不方便后期维护。
- **npm：**全局安装方式，需要依赖 Node.js 包管理器。适合前端开发者或熟悉 Node.js 的用户。版本控制方便，更新更容易，本文选用此安装方式。
- **Hackable：**源码安装方式，可任意魔改。适合想要修改核心逻辑的人。
- **macOS：**GUI 界面应用，提供原生体验，但通常配合 CLI 使用。
如果想长期稳定使用，建议选择 npm 安装。
环境配置（npm 安装）
OpenClaw 依赖于 Node.js 环境。
- 复制官网链接到浏览器打开，下载安装包：https://nodejs.org/zh-cn/download
- 按照安装包提示正常安装即可。
- 打开「终端」。
- 在终端内输入以下命令安装 OpenClaw：
sudo npm i -g openclaw
然后回车，输入开机密码后再回车。
- 如果出现 Git 下载协议错误，修改 Git 下载协议（强制使用 HTTPS），执行以下代码：
git config --global url."https://github.com/".insteadOf ssh://[email protected]/
- 重新输入安装命令，出现成功界面表示安装完成。
- 启动 OpenClaw 的初始化向导：
openclaw onboard
- 按向左方向键 ←，选择
Yes，按 Enter 回车确认风险提示。 - 选择 QuickStart（快速开始模式），回车。
- 配置 AI 模型 API Key。OpenClaw 需要连接到大语言模型才能工作。新版本支持 Kimi K2.5 等模型。
- 如果没有 API Key，可前往官方地址注册账号获取：https://platform.moonshot.cn/console/api-keys
- 复制 API key，在终端对应位置粘贴并回车。
- 选择 Kimi API key (.cn)，回车。
- 输入你的 API Key，回车。
- 选择保持当前（moonshot/kimi-k2.5），回车。
- 聊天工具选项建议先「暂时跳过」，先在终端里把 OpenClaw 跑起来，确认 AI 大脑、文件读写权限都正常工作。
- 选择是否配置备用 API，不想配置选「No」。
- 等待服务配置完成，选择「Open the web UI」，打开可视化页面。
把 OpenClaw 接入飞书机器人
- 进入飞书开放平台。登录成功后，点击创建企业自建应用。
- 填写应用名称、描述，选择图标，点击「创建应用」。
- 在添加应用能力中选择「机器人」→ 点击「添加」。
- 在开发配置中点击「权限管理」→「开通权限」。
- 搜索「im:」勾选全部相关权限名称，点击「确认开通权限」。
- 点击左侧「云文档」勾选全部相关权限名称，点击「确认开通权限」。
- 点击顶部「创建版本」按钮，填写相关内容后保存。
- 点击「确认发布」。
- 为了防止与自带的飞书文件夹冲突，删除之前的扩展：
sudo rm -rf ~/.openclaw/extensions/feishu
- 下载飞书插件：
openclaw plugins install @m1heng-clawd/feishu
- 配置 OpenClaw：
openclaw config
- 依次选择「Local (this machine)」→「Channels（渠道）」→「Configure/link（配置链接）」→「Feishu/Lark（飞书）」。
- 打开飞书开放平台，在「应用凭证」里，复制 AppID 和 AppSecret。
- 在终端对应位置分别输入飞书的 AppID 和 AppSecret。
- 选择「Feishu（feishu.cn）- China」。
- 选择「Open - respond in all groups（requires mention）」。
- 选择「Finished」，回车。
- 选择「Yes」，回车。
- 选择「Open...」，回车。
- 选择「Continue」，回车。
- 配置完成后关闭终端。
- 重启配置：
openclaw gateway
- 打开飞书开放平台，选择「事件与回调」→「订阅方式」→「使用长连接接收事件」→「保存」。
- 点击同一页面内的「添加事件」，搜索并添加「接收消息」、「消息已读」、「机器人进群」、「机器人被移出群」。
- 点击「权限管理」→搜索「通讯录」→选中「获取通讯录基本信息」→「确认开通权限」。
- 配置完成后重新发布新版本。
- 打开手机端「飞书」，搜索机器人的名字，给机器人发消息，如果机器人以 AI 的方式进行回复，则配置成功。
OpenClaw 常用命令
openclaw onboard # 重新进入配置向导
openclaw status # 查看运行状态
openclaw health # 健康检查
openclaw gateway start # 启动服务
openclaw gateway stop # 停止服务
openclaw update # 更新到最新版本
openclaw doctor # 诊断问题
openclaw uninstall # 卸载 OpenClaw
OpenClaw 技能库
OpenClaw 技能库是给 AI 装上「技能插件」，让它从'动嘴皮子'变成'真能干活'。
- 宝藏仓库地址 GitHub 地址： https://github.com/VoltAgent/awesome-openclaw-skills 里面包含内容众多，可根据自身需求进行安装。
- ClawHub，精英特工的技能平台。 官方网站：https://clawhub.ai/
