一、安装前准备1. 系统与硬件要求配置项最低要求推荐配置操作系统macOS 12/Ubuntu 20.04/Windows 10需WSL2macOS 14/Ubuntu 22.04/Windows 11内存4GB8GB磁盘空间2GB可用10GB SSD核心依赖Node.js 18.0Node.js v22 LTS最新版2. 必备前置资源AI模型API KeyClaude、GPT-4/5、阿里云百炼、Kimi等兼容OpenAI API的模型密钥需前往对应平台官网注册获取网络环境建议配置国内npm镜像加速依赖下载Windows用户需提前安装Git解决依赖拉取问题。二、分系统快速安装方案1macOS/Linux系统官方推荐一键安装打开终端执行官方一键安装脚本自动安装Node.js及所有依赖curl -fsSL https://openclaw.ai/install.sh | bash也可通过npm全局安装备用方式# 配置国内npm镜像可选加速下载 npm config set registry https://registry.npmmirror.com # 全局安装OpenClaw npm install -g openclawlatest验证安装成功openclaw --version显示版本号即安装完成。方案2Windows系统原生适配避坑版Windows原生对OpenClaw支持较弱需先配置Node.js环境全程用管理员权限打开PowerShell操作安装Node.js v22# 安装nvmNode版本管理工具推荐 iwr -useb https://raw.githubusercontent.com/coreybutler/nvm-windows/master/nvm-setup.exe | iex # 安装并使用Node.js 22 nvm install 22 nvm use 22.22.0执行Windows专属安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex若遇执行策略报错先执行以下命令再重新安装Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser验证安装openclaw --version方案3开发者进阶安装Git克隆源码适合需要自定义开发、修改源码的用户macOS/Linux/WindowsWSL2均可使用# 克隆仓库 git clone https://github.com/openclaw/openclaw.git # 进入目录并安装依赖 cd openclaw pnpm install pnpm run build # 初始化 pnpm run openclaw onboard三、初始化配置核心步骤安装完成后执行初始化命令进入交互式配置向导配置AI模型和基础参数# 通用初始化命令 openclaw onboard # Windows新手推荐快速配置 openclaw onboard --flow quickstart1. 风险确认首次配置会出现风险提示I understand this is powerful and inherently risky. Continue?选择Yes继续。2. 选择AI模型并配置API Key按方向键选择常用AI模型推荐Claude/GPT-4/阿里云百炼国内用户优先选阿里云百炼/Kimi访问更稳定粘贴提前获取的API Key格式为sk-xxxxxxxx回车确认部分模型需浏览器打开链接完成账号授权按提示操作即可。3. 基础功能配置技能包Skill新手直接选No跳过后续按需安装记忆功能Hooks选中session-memory启用多轮对话记忆避免重复说明需求其他默认配置完成后系统会自动启动Gateway网关服务默认端口18789。4. 打开管理控制台配置完成后浏览器会自动打开本地控制台手动访问地址http://127.0.0.1:18789首次进入需输入初始化生成的配置Token妥善保存丢失需重新初始化。四、对接聊天软件以飞书为例国内常用OpenClaw支持WhatsApp、Telegram、飞书、钉钉、微信等平台飞书配置难度低、稳定性高以下为详细对接步骤其他平台操作逻辑类似。1. 安装飞书插件在终端/PowerShell执行插件安装命令openclaw plugins install m1heng-clawd/feishu # 进入插件目录完成依赖安装 cd /root/.openclaw/extensions/feishu/ npm install --verbose2. 飞书开放平台创建应用访问飞书开放平台https://open.feishu.cn/app/登录后点击创建企业自建应用填写应用名称如「大龙虾AI助手」选择图标点击创建进入应用管理页点击添加应用能力→ 选择机器人→ 点击添加。3. 配置飞书应用权限与事件1批量导入权限进入应用管理页权限管理→ 点击批量导入权限粘贴以下JSON代码点击导入核心权限确保机器人能收发消息{ scopes: { tenant: [ contact:user.base:readonly, im:chat, im:message, im:message:send_as_bot, im:resource ], user: [] } }2事件订阅配置进入事件与回调→ 事件配置选择长连接点击保存点击添加事件→ 选择消息与群组→ 勾选im.message.receive_v1接收消息事件必选订阅方式选择使用长连接无需填写回调地址自动生效。3发布应用进入版本管理与发布→ 点击新建版本填写版本号和描述点击保存并发布飞书应用配置完成未发布则配置不生效。4. OpenClaw绑定飞书应用在终端执行命令添加飞书通信渠道openclaw channels add按提示输入飞书应用的App ID和App Secret在飞书开放平台「凭证基础信息」中复制重启网关服务使配置生效openclaw gateway restart验证状态openclaw status显示Gateway running即绑定成功。5. 飞书端测试使用打开飞书APP进入工作台→ 找到创建的「大龙虾AI助手」点击进入私聊窗口发送任意消息如「你好」「整理我的今日日程」收到机器人回复即对接完成。五、基础使用与常用命令1. 核心使用方式在绑定的聊天软件中直接发送自然语言指令机器人即可执行操作例如邮件处理「帮我整理上周的未读邮件提取会议纪要」文件管理「将桌面PDF文件按日期归档到文档文件夹」系统操作「执行shell命令查看电脑CPU使用率」定时任务「每天早上9点给我发送今日待办事项」。2. 常用终端命令汇总功能命令查看版本openclaw --version查看运行状态openclaw status启动/停止/重启机器人openclaw start/stop/restart重新初始化配置openclaw onboard重启网关服务openclaw gateway restart查看已安装插件openclaw plugins list安装插件openclaw plugins install 插件名卸载插件openclaw plugins uninstall 插件名查看帮助openclaw --help六、常见问题与避坑指南1. 安装时卡在node-gyp rebuild原因缺少Python和C编译工具解决Windows安装Visual Studio Build Tools和CMakemacOS执行xcode-select --install安装Xcode命令行工具Linux执行sudo apt install build-essential python3。2. Windows提示「系统找不到指定的路径」原因系统组件被精简、WSL未启用或Git环境未配置解决安装Git官网https://git-scm.com/download/win安装后重启电脑启用WSL2在PowerShell执行wsl --install清理npm缓存并重装npm cache clean --force npm install -g openclawlatest3. 飞书配置提示「未建立长连接」解决检查App ID和App Secret是否输入正确等待1-2分钟再重新保存长连接配置网络延迟导致执行openclaw gateway restart重启网关再重新配置。4. 聊天软件发送消息无回复排查步骤执行openclaw status确认网关服务正常运行检查聊天软件应用的事件订阅是否添加im.message.receive_v1确认应用已在飞书开放平台发布未发布无法收发消息查看网关日志openclaw gateway --verbose定位错误原因。5. 国内网络下载依赖卡顿/失败解决配置国内npm镜像npm config set registry https://registry.npmmirror.com使用代理工具或手动下载离线安装包进行安装。七、进阶优化可选汉化适配国内用户建议安装社区汉化版优化微信/企业微信支持npm install -g openclaw-cnlatestDocker部署适合需要7×24小时运行的用户容器化部署更稳定git clone https://github.com/openclaw/openclaw.git cd openclaw docker compose up -d openclaw-gateway本地模型部署修改.env文件中的MODEL_PROVIDER和API_KEY支持本地运行Llama、Qwen等模型完全脱离外网。权限限制在config.json中设置allowed_commands和denied_commands禁止机器人执行危险shell命令提升安全性。八、注意事项隐私安全OpenClaw默认本地部署数据不上传但建议不要在装有重要商业/隐私数据的电脑上运行可使用闲置设备或云端虚拟机VPS版本兼容避免使用最新版官方频繁更新易出问题新手建议安装稳定版npm install -g openclaw1.0.0替换为实际稳定版本号
OpenClaw大龙虾机器人完整安装教程
发布时间：2026/5/27 17:43:51
一、安装前准备1. 系统与硬件要求配置项最低要求推荐配置操作系统macOS 12/Ubuntu 20.04/Windows 10需WSL2macOS 14/Ubuntu 22.04/Windows 11内存4GB8GB磁盘空间2GB可用10GB SSD核心依赖Node.js 18.0Node.js v22 LTS最新版2. 必备前置资源AI模型API KeyClaude、GPT-4/5、阿里云百炼、Kimi等兼容OpenAI API的模型密钥需前往对应平台官网注册获取网络环境建议配置国内npm镜像加速依赖下载Windows用户需提前安装Git解决依赖拉取问题。二、分系统快速安装方案1macOS/Linux系统官方推荐一键安装打开终端执行官方一键安装脚本自动安装Node.js及所有依赖curl -fsSL https://openclaw.ai/install.sh | bash也可通过npm全局安装备用方式# 配置国内npm镜像可选加速下载 npm config set registry https://registry.npmmirror.com # 全局安装OpenClaw npm install -g openclawlatest验证安装成功openclaw --version显示版本号即安装完成。方案2Windows系统原生适配避坑版Windows原生对OpenClaw支持较弱需先配置Node.js环境全程用管理员权限打开PowerShell操作安装Node.js v22# 安装nvmNode版本管理工具推荐 iwr -useb https://raw.githubusercontent.com/coreybutler/nvm-windows/master/nvm-setup.exe | iex # 安装并使用Node.js 22 nvm install 22 nvm use 22.22.0执行Windows专属安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex若遇执行策略报错先执行以下命令再重新安装Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser验证安装openclaw --version方案3开发者进阶安装Git克隆源码适合需要自定义开发、修改源码的用户macOS/Linux/WindowsWSL2均可使用# 克隆仓库 git clone https://github.com/openclaw/openclaw.git # 进入目录并安装依赖 cd openclaw pnpm install pnpm run build # 初始化 pnpm run openclaw onboard三、初始化配置核心步骤安装完成后执行初始化命令进入交互式配置向导配置AI模型和基础参数# 通用初始化命令 openclaw onboard # Windows新手推荐快速配置 openclaw onboard --flow quickstart1. 风险确认首次配置会出现风险提示I understand this is powerful and inherently risky. Continue?选择Yes继续。2. 选择AI模型并配置API Key按方向键选择常用AI模型推荐Claude/GPT-4/阿里云百炼国内用户优先选阿里云百炼/Kimi访问更稳定粘贴提前获取的API Key格式为sk-xxxxxxxx回车确认部分模型需浏览器打开链接完成账号授权按提示操作即可。3. 基础功能配置技能包Skill新手直接选No跳过后续按需安装记忆功能Hooks选中session-memory启用多轮对话记忆避免重复说明需求其他默认配置完成后系统会自动启动Gateway网关服务默认端口18789。4. 打开管理控制台配置完成后浏览器会自动打开本地控制台手动访问地址http://127.0.0.1:18789首次进入需输入初始化生成的配置Token妥善保存丢失需重新初始化。四、对接聊天软件以飞书为例国内常用OpenClaw支持WhatsApp、Telegram、飞书、钉钉、微信等平台飞书配置难度低、稳定性高以下为详细对接步骤其他平台操作逻辑类似。1. 安装飞书插件在终端/PowerShell执行插件安装命令openclaw plugins install m1heng-clawd/feishu # 进入插件目录完成依赖安装 cd /root/.openclaw/extensions/feishu/ npm install --verbose2. 飞书开放平台创建应用访问飞书开放平台https://open.feishu.cn/app/登录后点击创建企业自建应用填写应用名称如「大龙虾AI助手」选择图标点击创建进入应用管理页点击添加应用能力→ 选择机器人→ 点击添加。3. 配置飞书应用权限与事件1批量导入权限进入应用管理页权限管理→ 点击批量导入权限粘贴以下JSON代码点击导入核心权限确保机器人能收发消息{ scopes: { tenant: [ contact:user.base:readonly, im:chat, im:message, im:message:send_as_bot, im:resource ], user: [] } }2事件订阅配置进入事件与回调→ 事件配置选择长连接点击保存点击添加事件→ 选择消息与群组→ 勾选im.message.receive_v1接收消息事件必选订阅方式选择使用长连接无需填写回调地址自动生效。3发布应用进入版本管理与发布→ 点击新建版本填写版本号和描述点击保存并发布飞书应用配置完成未发布则配置不生效。4. OpenClaw绑定飞书应用在终端执行命令添加飞书通信渠道openclaw channels add按提示输入飞书应用的App ID和App Secret在飞书开放平台「凭证基础信息」中复制重启网关服务使配置生效openclaw gateway restart验证状态openclaw status显示Gateway running即绑定成功。5. 飞书端测试使用打开飞书APP进入工作台→ 找到创建的「大龙虾AI助手」点击进入私聊窗口发送任意消息如「你好」「整理我的今日日程」收到机器人回复即对接完成。五、基础使用与常用命令1. 核心使用方式在绑定的聊天软件中直接发送自然语言指令机器人即可执行操作例如邮件处理「帮我整理上周的未读邮件提取会议纪要」文件管理「将桌面PDF文件按日期归档到文档文件夹」系统操作「执行shell命令查看电脑CPU使用率」定时任务「每天早上9点给我发送今日待办事项」。2. 常用终端命令汇总功能命令查看版本openclaw --version查看运行状态openclaw status启动/停止/重启机器人openclaw start/stop/restart重新初始化配置openclaw onboard重启网关服务openclaw gateway restart查看已安装插件openclaw plugins list安装插件openclaw plugins install 插件名卸载插件openclaw plugins uninstall 插件名查看帮助openclaw --help六、常见问题与避坑指南1. 安装时卡在node-gyp rebuild原因缺少Python和C编译工具解决Windows安装Visual Studio Build Tools和CMakemacOS执行xcode-select --install安装Xcode命令行工具Linux执行sudo apt install build-essential python3。2. Windows提示「系统找不到指定的路径」原因系统组件被精简、WSL未启用或Git环境未配置解决安装Git官网https://git-scm.com/download/win安装后重启电脑启用WSL2在PowerShell执行wsl --install清理npm缓存并重装npm cache clean --force npm install -g openclawlatest3. 飞书配置提示「未建立长连接」解决检查App ID和App Secret是否输入正确等待1-2分钟再重新保存长连接配置网络延迟导致执行openclaw gateway restart重启网关再重新配置。4. 聊天软件发送消息无回复排查步骤执行openclaw status确认网关服务正常运行检查聊天软件应用的事件订阅是否添加im.message.receive_v1确认应用已在飞书开放平台发布未发布无法收发消息查看网关日志openclaw gateway --verbose定位错误原因。5. 国内网络下载依赖卡顿/失败解决配置国内npm镜像npm config set registry https://registry.npmmirror.com使用代理工具或手动下载离线安装包进行安装。七、进阶优化可选汉化适配国内用户建议安装社区汉化版优化微信/企业微信支持npm install -g openclaw-cnlatestDocker部署适合需要7×24小时运行的用户容器化部署更稳定git clone https://github.com/openclaw/openclaw.git cd openclaw docker compose up -d openclaw-gateway本地模型部署修改.env文件中的MODEL_PROVIDER和API_KEY支持本地运行Llama、Qwen等模型完全脱离外网。权限限制在config.json中设置allowed_commands和denied_commands禁止机器人执行危险shell命令提升安全性。八、注意事项隐私安全OpenClaw默认本地部署数据不上传但建议不要在装有重要商业/隐私数据的电脑上运行可使用闲置设备或云端虚拟机VPS版本兼容避免使用最新版官方频繁更新易出问题新手建议安装稳定版npm install -g openclaw1.0.0替换为实际稳定版本号
相关文章
DeOldify在游戏开发中的应用：Unity引擎集成与复古游戏素材重生
DeOldify在游戏开发中的应用：Unity引擎集成与复古游戏素材重生 最近和几个做独立游戏的朋友聊天，他们都在为一个问题头疼：美术资源不够用。尤其是那些想做复古风格游戏的团队，手头可能只有一些从老杂志扫描的黑白像素画ÿ…
可以理解为肽键里面含有两个官能团一个羰基，一个氨基可以这么理解吗
这是一个很常见的误解，但答案是：不能这样理解。 虽然在结构式上，肽键（–CO–NH–）确实写出了一个羰基（CO）和一个亚氨基（–NH–）（如果是肽链末端自由氨基则是–…
轻量级CI/CD实践：Drone与Gogs的完美结合（附详细配置指南）
1. 为什么选择DroneGogs组合 如果你正在为团队寻找一套轻量高效的CI/CD方案，Drone和Gogs的组合绝对值得考虑。我去年给一个5人开发团队部署这套系统时，整个环境只用了512MB内存就跑得飞起，相比传统方案节省了90%的资源消耗。 核心优势在于两者…
FLUX.2-small-decoder源码解析：AutoencoderKLFlux2架构与实现细节
FLUX.2-small-decoder源码解析：AutoencoderKLFlux2架构与实现细节 【免费下载链接】FLUX.2-small-decoder 项目地址: https://ai.gitcode.com/hf_mirrors/black-forest-labs/FLUX.2-small-decoder FLUX.2-small-decoder是一个经过蒸馏的VAE解码器࿰…
PCL实战指南（一）-- 从零到一：在Windows上搭建PCL开发环境并运行首个点云程序
1. 环境准备：从零开始搭建PCL开发环境 第一次接触点云处理时，我被那些三维数据可视化效果深深吸引，但搭建开发环境的过程却让我踩了不少坑。为了让后来者少走弯路，我决定分享这份详细的Windows平台PCL环境搭建指南。PCL࿰…
学Agent应该先学什么？这几个底层硬技能才是通关密码
看着 AI Agent（智能体）成为当下最具含金量的黄金赛道，很多技术人和职场新人都按捺不住，想要立刻进场。然而，面对扑面而来的“多智能体协同、知识库检索、工具调用”等高大上概念，许多人一上来就迷失在了复杂…
2. 文本预处理_2
4. 文本语料的数据分析 4.1 标签数量分布 4.2 句子长度分布 4.3 词频统计与关键词词云 5. 文本特征处理 5.1 添加n-gram特征 5.2 文本长度规范6. 文本数据增强 6.1 回译数据增强法 1️⃣ 概念：一般基于google/百度/获取其他翻译接口，将句子先翻译成另外 …
当AI开始“行动“而非“回答“，我们该如何评判它的表现？
这项由德克萨斯大学奥斯汀分校、卡内基梅隆大学、加州理工学院、斯坦福大学、伊利诺伊大学厄巴纳-香槟分校、微软研究院、西北大学和剑桥大学联合完成的研究，以预印本形式于2026年5月发表在arXiv平台，编号为arXiv:2605.17829。这是一篇立场声明性质的学术…
Hotkey Detective：Windows热键冲突终极解决方案，3分钟快速修复快捷键失效问题
Hotkey Detective：Windows热键冲突终极解决方案，3分钟快速修复快捷键失效问题 【免费下载链接】hotkey-detective A small program for investigating stolen key combinations under Windows 7 and later. 项目地址: https://gitcode.com/gh_mirrors/…
LVGL绘制平滑曲线避坑指南：为什么你的贝塞尔函数有毛刺？
LVGL绘制平滑曲线避坑指南：为什么你的贝塞尔函数有毛刺？ 在嵌入式GUI开发中，贝塞尔曲线是实现流畅动画和优雅界面的核心工具。但许多开发者在使用LVGL绘制曲线时，总会遇到令人头疼的锯齿和毛刺问题。这背后隐藏着嵌入式设备特有的…
告别手动输入！用Burpsuite插件captcha-killer-modified+ddddocr，5分钟搞定登录爆破验证码
自动化验证码识别实战：Burpsuite与ddddocr的高效联动方案验证码机制作为现代Web应用的基础安全防线，其对抗自动化攻击的能力直接影响系统安全性。但在安全测试领域，验证码往往成为效率瓶颈——传统手工识别方式让渗透测试人员每天浪费数小时在…
中国AI岗位暴涨12倍，13种你没听过的AI岗位
2026年，中国AI岗位数量同比增长12倍，AI科学家月薪高达13.7万，高性能计算工程师出现“7个岗位抢1个人”的荒诞场面。与此同时，数据录入、基础财务分析、一线客服等岗位大幅下降。全球范围内，AI/ML岗位招聘量同比增长88%…
施工现场安全事故预警准确率达94.6%？——解密某央企AI Agent边缘计算部署架构与3个月落地实录
更多请点击： https://codechina.net 第一章：施工现场安全事故预警准确率达94.6%？——解密某央企AI Agent边缘计算部署架构与3个月落地实录 在华北某大型地铁盾构施工现场，一套轻量化AI Agent系统于2024年Q2完成全栈部署ÿ…
附录 B：术语表
本术语表面向“从 MM 到 HMM”专栏阅读过程中的快速查阅。它不是内核 API 手册，而是把文章中反复出现的概念放到同一张地图上：先给出直观含义，再说明它在 Linux MM/HMM 语境里的作用。建议阅读方式： 初读专栏时，把它当…
Midjourney渐变美学的神经渲染原理（附RGB-HSV-LCH三空间渐变映射对照表·行业首曝）
更多请点击： https://kaifayun.com 第一章：Midjourney渐变美学的神经渲染原理（附RGB-HSV-LCH三空间渐变映射对照表行业首曝） Midjourney 的渐变美学并非传统插值实现，而是由其隐式神经渲染器（Implicit Neu…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…