openclaw安装教程保姆级教学,从零开始摸索(小龙虾agent)

学习这件事不在乎有没有人教你，最重要的是在于你自己有没有觉悟和恒心。——法布尔

图：取自网络或个人制作
领取方式在本文末尾

当你突然想配置一个在国内能用的中文版小龙虾agent，应该注意哪些方面呢？

首先得表明我的“实力”：纯小白一个，仅仅将自己安装的全流程记录下，踩过的雷和安全方面的顾虑也一并记录，希望对各位能有一定的帮助。

网传外面请人安装，一次600-1000，根本没必要，教程一搜一大把，更别说问deepseek和豆包此类AI都可以从零教你一步一步安装。

这次我就将用AI辅助教我安装，利用官方提供的openclaw开源代码，进行本地部署，安装时间为2026-3-8，请各位在搜索教程时也注意他们的发布时间

（举个我踩雷的例子：有些让你装的openclaw中文包会弹出：This package is no longer supported.即这个安装包已经不再支持/更新，跟着这种教程走第一步不就卡住了？）

首先需要明确，安装openclaw有两种方式：本地部署和云端虚拟机

本地部署优点：零成本、低延迟、功能完整（可直接控制本地应用 / 文件 / 剪贴板）、数据完全本地缺点：电脑关机 / 睡眠 / 断网就停、占用主系统资源、安全风险高（OpenClaw 有系统级权限，裸跑易泄露敏感数据）适合：临时测试、快速体验、个人轻量使用
云虚拟机 + Token优点：7×24 稳定运行、环境完全隔离（不影响主系统）、可远程访问、快照备份、资源可控缺点：有月费、配置稍复杂、性能有损耗、部分本地交互功能受限适合：长期自动化、团队协作、跨端访问、安全优先的场景

总结：反正无论哪种都需要花钱的（本地买token，云要买服务器+token），本地部署如果用的不是官方原版openclaw，可能会被插个后门，有安全隐患，云端如果是公司，则需要租赁独立服务器，否则也有可能泄露资料

我选择的是本地部署，系统为Windows 11，你也选择本地部署就往下看，如果想要云端虚拟机，那搜索（阿里or藤子）已经提供了一键部署，不过多阐述。

第一步：直接问AI“搜索并了解openclaw，我的系统是XX系统（填win/mac/linux），帮我在本地安装它，拉取远程项目到本地部署，不要沙盒”

因为同样是官方包的话，大体上不会有太大变化，看看它提供你的最新方法，再对照我接下来的内容做对比，这样你可以相应的做些新版本的调整或者避雷

可提前准备：

【非必要】ai代码编程工具，官网自行下载（我用的cursor,国内有字节的trae,阿里的Qoder）建议用国内的，我是看了别人的教程下的cursor，在下载和登录、切换中文上踩了些小雷

【非必要】去Github网站搜索关键词：openclaw

还有国内汉化版本（有一定风险）搜索openclaw-cn，连不上github多刷新几次或等待一段时间

有AI编程工具那么可以让它更快捷操作电脑，一步步进行本地部署即可，如果没有那么用电脑自带的 PowerShell（Win+X → 终端管理员）

需要注意：PowerShell 默认禁止运行未签名的脚本（比如 npm.ps1）

第二步可以在PowerShell输入执行以下命令，设置允许本地脚本运行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

这样在AI编程工具的终端就可以正常使用npm 命令

【必要】安装node.js(部署所需环境，可官网自行下载)
也可以在cursor（AI编程工具都行）上图左上角的对话框输入：帮我配置node.js环境，版本需在22以上
【必要】安装GIT(依赖 Git 拉取代码，可官网自行下载)

要是实在懒得去官网，以上这两个我也打包放在文末了。

接下来就是正式安装咯~

开始执行后，一遇到问题或报错，将代码直接复制给AI即可解答。

第三步:从 GitHub 拉取 OpenClaw 源码到本地

在 PowerShell 切到你想放代码的位置（比如用户目录）：

cd C:\Users\Administrator

根据你的硬盘空间更改！我是改到了E盘

克隆仓库：

git clone https://github.com/openclaw/openclaw.gitcd openclaw

此时 C:\Users\Administrator\openclaw 就是本地源码目录。（我踩过的雷：克隆期间可能会出现GitHub网络中断，问AI可提供多个方法）

第四步：安装 pnpm 和依赖

安装 pnpm（推荐，使用 corepack，Node 16+ 自带）：

corepack enablecorepack prepare pnpm@latest --activate

确认是否安装成功：

pnpm -v

安装项目依赖在源码目录 C:\Users\Administrator\openclaw 中执行：

cd C:\Users\Administrator\openclawpnpm install这一步会比较久，取决于你的网络（需要能访问 npm registry）

第五步：构建 UI 和主项目依然在 openclaw 目录：

构建 Web UI（首次运行会顺便装 UI 的依赖）pnpm ui:build# 构建主项目（生成 dist/）pnpm build如果出现报错（比如 Node 版本不对、内存不足、网络问题），把报错信息发给AI，帮助具体排查。（我踩过的雷：windows无法调用bash）

第六步：从源码运行 Onboard 向导并部署1. 运行 Onboard 向导（源码方式）cd C:\Users\Administrator\openclawpnpm openclaw onboard --install-daemon如果 --install-daemon 在你的 Windows 环境下不支持，可以改为：

pnpm openclaw onboard

向导过程里一般会让你配置：引导模式选择：快速引导模式

配置处理：使用现有值

使用的模型提供商（OpenAI / Anthropic / 本地 Ollama 等）：

DeepSeek可通过在向导中选择 Custom Provider,

豆包在向导里对应的是 Volcano Engine（火山引擎）

我选择用deepseek(先跑起来再说，模型后续可改)

（我踩的雷：记得提前在你选择的模型里充一点token,否则无法调用API）

API Key如何填写：

打开deepseek官网-点击开放平台-点击左侧API keys

创建后复制到PowerShell即可

默认模型选择：保持当前

选择通道（沟通方式）：飞书

安装飞书插件？：使用本地插件路径

此时，搜索飞书开放平台，登录后点击右上角开发者后台-创建企业自建应用

（懒得放图了，需要操作的划重点了，其他都不用在意）

随意输入应用名称和描述（因为是必填，建议输入：龙虾openclaw）

创建好后，点击左侧添加应用能力-添加机器人

添加好后，点击左侧权限管理-批量导入权限

这时能看到JSON文档，点击并全选里面的代码（CTRL+A）

将其替换为以下代码：

{"scopes": {"tenant": ["aily:file:read","aily:file:write","application:application.app_message_stats.overview:readonly","application:application:self_manage","application:bot.menu:write","cardkit:card:write","contact:user.employee_id:readonly","corehr:file:download","docs:document.content:read","event:ip_list","im:chat","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","im:message","im:message.group_at_msg:readonly","im:message.group_msg","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource","sheets:spreadsheet","wiki:wiki:readonly"],"user": ["aily:file:read","aily:file:write","im:chat.access_event.bot_p2p_chat:read"]}}