OpenClaw完整部署教程：完全零基础小白都能学会

OpenClaw 第零章OpenClaw是什么？为什么要用它？0.1和普通AI聊天机器人有什么区别？40.2需要准备什么？4 第一章Windows本机安装（新手推荐）1.1安装Node.js（必须先装这个）61.2安装OpenClaw61.3Windows特殊问题：npm执行报错修复7 2.1阿里云一键部署（最简单）92.2腾讯云一键部署10 3.1连接到服务器113.2更新系统并安装基础依赖113.3安装Node.js22+123.4安装OpenClaw123.5开放防火墙端口13 4.1启动配置向导144.2逐步解读向导界面144.3验证安装健康状态15 5.1方案一：智谱GLM（推荐新手）165.2方案二：阿里云百炼165.3方案三：通过修改配置文件17 6.1接入飞书（国内用户推荐）196.2接入Telegram20 7.1本机访问WebUI227.2远程访问云服务器WebUI227.3给设备配对授权23 9.1基础命令269.2更新与维护命令269.3故障排查命令27对话示例：你能让OpenClaw做什么28告诉AI你是谁——USER.md设置28安全建议28有用的学习资源29OpenClaw（曾用名Clawdbot、Moltbot）是2026年最火爆的开源AI个人助手回答问题✅可以✅可以操作文件×只能说不能做✅直接读写文件执行代码×不行收发邮件×不行管理日历×不行✅自动创建会议24小时运行×需要你盯着✅后台自动跑接入聊天软件×不行✅飞书/微信/TelegramOpenClaw本身完全免费！费用主要来自AI模型的API调用，国内模型每天几毛钱就够用操作系统Windows10/macOS12+Ubuntu22.04云服务器4GBRAM8GBRAMNode.js版本v22.0+v22.14.0LTS能访问外网稳定宽带（VPS更佳）AIAPIKey任意一个国内模型智谱GLM/阿里百炼•方案A（推荐新手）：Windows本机安装——不需要买服务器，最简单•方案B（推荐进阶）：云服务器部署（阿里云/腾）：分分本章适合：使用Windows10或Windows11的电脑用户。不需要购买服务器，直接在自己电脑上安装。步骤步骤打开Node.js官网1打开浏览器，访问步骤步骤下载LTS版本2点击绿色的「LTS」按钮下载（不要选Current，LTS更稳定）步骤步骤安装Node.js3双击下载好的.msi安装文件，一路点「Next」，全部保持默认，最后点「Finish」步骤步骤验证安装成功4按Win+R键，输入cmd，回车。在弹出的黑色窗口里输入以下命令：nodenode--version如果看到类似v22.14.0的版本号，说明安装成功v⚠⚠注意：版本号必须是v22或以上！如果显示v18、v20等低版本，需要重新下载安装最新LTS版本。步骤步骤用管理员身份打开命令提示符1按Win键，搜索「cmd」，右键点击「命令提示符」，选择「以管理员身份运行」步骤步骤输入安装命令2在黑色窗口里，复制粘贴以下命令，按回车执行：npmnpminstall-gopenclaw等待2-5分钟，看到安装成功提示即可。步骤步骤验证安装3输入以下命令检查是否安装成功：openclawopenclaw--version显示版本号说明安装成功v「openclaw「openclaw不是内部或外部命令」，请关闭并重新打开命令提示符（必须用管理再试一次。员身份），步骤步骤找到文件路径1在命令窗口输入以下命令，找到exec.js文件位置：wherewhereopenclawversions\v22.x.x\installation\node_modules\openclaw\dist\process\exe步骤步骤编辑文件2用记事本打开上面找到的exec.js文件，找到这段代码： constchild=spawn(argv[0],argv.slice(1),{stdio,cwd,env:resolvedEnv,windowsVerbatimArguments,}); letcommand=argv[0]; letuseShell=false; if(process.platform==='win32'&&path.basename(command)==='npm'){ useShell=true; constchild=spawn(command,argv.slice(1),{stdio,cwd,env:resolvedEnv,shell:useShell});这是OpenClaw在Windows上的已知Bug，修复后即可正常运行。如果官方版本更新，此步骤可能不再需要。分本章适合：想让OpenClaw24小时全天候运行，随时用手机控制AI助手的用户。需要购买云服务器（费用约¥9.9/月起）。分步骤步骤进入活动页面1浏览器访问：/activity/ecs/clawdbot步骤步骤选择配置2页面上已预设好配置（1核2GB），新用户可抢¥9.9/月的特惠。点击「立即购买」。步骤步骤选择地域3建议选「香港」或「新加坡」地域，网速更快，且支持联网搜索功能。步骤步骤设置密码4设置服务器登录密码（记住这个密码！后面要用）。步骤步骤确认购买5完成付款，等待1-2分钟服务器启动。步骤步骤进入控制台6回到阿里云控制台→轻量应用服务器→找到购买的服务器→点击实例ID步骤步骤打开应用详情7点击「应用详情」标签，可以看到OpenClaw的访问地址和控制入口。8开启公网访问在「基础配置」→「公网访问」中，开启访问权限，就能从浏览器访问OpenClaw界面多多恭喜！阿里云一键部署完成！直接跳到第三章配置AI模型APIKey。步骤步骤进入活动页面1访问：/developer/article/2624973步骤步骤选择轻量级服务器2选择「轻量应用服务器」，选择OpenClaw应用模板。步骤步骤登录服务器3购买后，在服务器管理界面找到「登录」按钮，进入命令终端。步骤步骤运行配置向导4在终端中输入：openclawopenclawonboard--install-daemon分分本章适合：已有Ubuntu22.04或24.04服务器，想手动安装的用户。步骤步骤Windows用户：打开PowerShell或CMD1按Win+R，输入powershell，回车步骤步骤输入连接命令2将your_server_ip替换成你的服务器IP地址：sshsshroot@your_server_ip然后输入服务器密码（输入时不显示字符，直登录成功后，依次执行以下命令（每条命令步骤步骤更新系统1##更新软件包列表sudoaptupdate&&sudoaptupgrade-y步骤步骤安装基础依赖2##安装必要工具（避免后续报错） sudoaptinstall-ycurlwgetgitpython3build-essentiallibssl-devufw步骤步骤安装nvm（Node版本管理器）1curlcurl-o-/nvm-sh/nvm/v0.39.7/install.sh|bash2sourcesource~/.bashrc步骤步骤安装Node.js223nvmnvminstall22nvmuse22步骤步骤验证版本4node--versionnpmnode--versionnpm--version#应显示10.x.x△如果curl下载nvm脚本失败（网络问题），可在VPS控制台使用镜像源，或者直接用阿里云/腾讯云的一键部署方案。△步骤步骤用npm全局安装1npmnpminstall-gopenclaw步骤步骤验证安装成功2openclawopenclaw--version安装过程中出现大量warn警告是正常的，只要最后看到成功安装版本号，就没有问题。##开放18789端口sudoufwallow18789/tcp#重启防火墙sudoufwreload#验证端口已放行sudoufwstatus|grep18789#显示ALLOW即成功⚠⚠如果使用阿里云/腾讯云，还需要在「安全组」规则里添加18789端口的入站规则，否则外网仍无法访问！分分无论用哪种方式安装，都需要进行首次配置。这一章是最关键的章节，请仔细阅读每一步！openclawopenclawonboard--install-daemon加--install-daemon参数的1风险提示第一屏会显示风险提示（OpenClaw可以操作你的电脑）。按【左方向键←】选择Yes，按Enter确认。用键盘操作：↑↓上下选择，←→左右选择，空格键多选，Enter确认，Ctrl+C退出。步骤步骤选择部署模式2选择QuickStart（快速开始）模式，适合新手，可跳过非必要配置。配置AI模型3Key。如果还没有，先选择Skipfor3Key。如果还没有，先选择Skipfornow跳过，后面单独分分推荐国内用户：智谱GLM（免费额度大）或阿里百炼（接入方便）。具体申请方法见第五步骤步骤选择默认模型4随便选一个作为临时占位（后面可以改），按Enter确认。5配置通讯渠道（Channel）这里选择用哪个聊天软件控制OpenClaw。国内用户推荐选飞书或Telegram。新手可先选Skipfornow。步骤步骤安装技能（Skills）6按空格键勾选想要安装的技能插件，可以多选。建议先全选，后面可以再修改。步骤步骤选择管理界面模式7选择TUI（文字界面）即可，如果只在本机用可以选WebUI浏览器界面。步骤步骤等待安装完成8配置向导会自动安装依赖，大概需要3-10分钟，耐心等待。✓✓OpenClawinstalledsuccessfully✓Gatewayservicestarted✓DaemonregisteredRun'openclawdoctor'tocheckhealthopenclawopenclawdoctoropenclawopenclawdashboard分分APIKey是连接AI大脑的钥匙。没有它，OpenClaw只是个空壳。这一步非常重要，请按照步骤仔细操作。步骤步骤注册账号1浏览器打开：，点击右上角「注册」，用手机号注册账号。步骤步骤实名认证2注册后进行实名认证（需要身份证），认证后才能使用完整免费额度。步骤步骤创建APIKey3登录后进入「控制台」→「APIKeys」→「新建APIKey」，输入名称，点击确认。步骤步骤复制保存Key4生成的Key形如xxxxxxx.xxxxxxxxxxxxxxxx，复制保存（只显示一次。步骤步骤配置到OpenClaw5在命令行输入以下命令（替换YOUR_KEY_HERE为你的Key）：openclawopenclawconfigsetviders.zhipu.apiKeyYOUR_KEY_HERE1开通百炼浏览器访问：，用阿里云账号登录，点击「开通」按钮（免费）。步骤步骤创建APIKey2进入「API-KEY管理」→「创建APIKey」，输入名称，创建。步骤步骤开启「免费额度用完即停」3强烈建议在「计费设置」里开启此功能，避免超出免费额度产生意外扣费。步骤步骤配置到OpenClaw4 openclawconfigsetviders.alibaba-cloud.apiKeyYOUR_BAILIAN_KEY如果想接入多个模型，可以直接编辑配置文件。配置文件位置：~/.openclaw/步骤步骤打开配置文件1##Linux/macOSnano~/.openclaw/openclaw.json##Windows（用记事本打开）notepad%USERPROFILE%\.openclaw\openclaw.json步骤步骤添加模型配置2在文件中添加以下内容（替换YOUR_KEY为实际Key）：{"agents":{"defaults":{"model":{"primary":"zhipu/glm-4"},"maxConcurrent":4}"models":{"mode":"merge","providers":{"zhipu":{"baseUrl":"/api/paas/v4","apiKey":"YOUR_ZHIPU_KEY","api":"openai-completions","models":[{"id":"glm-4-flash","name":"GLM-4Flash"}]}}步骤步骤保存并重启OpenClaw3openclawopenclawgatewayrestart配置好AI模型后，就可以把OpenClaw接入你常用的聊天软件，随分分飞书支持个人版免费使用，配置好后可以在飞书里直接和AI对话，让它帮你干活！步骤步骤登录飞书开放平台1访问：，用飞书账号登录。2创建企业自建应用点击「创建应用」→「企业自建应用」，填写应用名称（随便起，如「我的AI助手」），上传图标（可选）。步骤步骤获取AppID和AppSecret3进入应用详情页，在「凭证与基础信息」里找到AppID和AppSecret，复制保存。添加权限4-im:message:send_as_bot（发送消息）-im:chat4-步骤步骤发布应用5点击「版本管理与发布」→「创建版本」→「申请发布」（个人账号直接审核通过）。##安装飞书渠道插件openclawpluginsinstall@openclaw-china/channels#配置飞书参数（替换为你的AppID和Secret）openclawconfigsetchannels.feishu.appIdcli_你的AppIDopenclawconfigsetchannels.feishu.appSecret你的AppSecretopenclawopenclawconfigsetchannels.feishu.enabledtrue6设置事件订阅（长连接）回到飞书开放平台应用页面→「事件与回调」→「订阅方式」→点击笔形图标→选择「长连接」→保存。步骤步骤重启OpenClaw7openclawopenclawgatewayrestart8测试在飞书里搜索你刚创建的机器人，发送消息「你好，你是谁？」，如果AI回复了就说明配置成功分分Telegram是OpenClaw官方最推荐的接入方式，延迟低、稳定，需要科学上网。1创建TelegramBot打开Telegram，搜索@BotFather，发送/newbot，按提示设置机器人名称和用户名（用户名必须以bot结尾）。步骤步骤获取BotToken2BotFather会给你一串Token，格式如123456789:ABCdef...，复制保存。步骤步骤配置到OpenClaw3openclawopenclawchannelsadd--channeltelegram--token你的BOT_TOKEN步骤步骤授权你的账号4OpenClaw的TelegramBot默认需要配对授权，运行以下命令查看配对状态：openclawopenclawchannelsstatus--probe5在Telegram里找到你的机器人，发送/start或「你好」，AI应该会回复。OpenClaw提供了一个好看的浏览器界面，不需要），:18789/chat步骤步骤修改配置文件1编辑~/.openclaw/openclaw.json，找到或添加以下配置：{{"gateway":{"mode":"remote","bind":"lan"}}步骤步骤重启服务2openclawopenclawgatewayrestart步骤步骤访问地址3在浏览器输入：http://你的服务器IP:18789△安全警告：直接将WebUI暴露到公网有安全风险！建议只在开发测试时使用，正式使用请通过Telegram/飞书等安全渠道控制OpenClaw。##查看待授权设备列表openclawpairinglist#授权指定设备（替换DEVICE_ID为设备ID）openclawpairingapproveDEVICE_ID•Windows用户：关闭命令提示符，重新用管理员身份打开，再试一次。##切换为淘宝镜像npmconfigsetregistry#再次安装OpenClawnpminstall-gopenclaw症状：运行openclawgatewaysta##查看日志文件tail-f~/.openclaw/logs/*.log#或使用PM2日志（如果用了PM2）pm2logsopenclaw•检查飞书应用是否已经「发布」，未发布的应用不能使用。•检查是否在飞书开放平台设置了「长连接」事件订阅。•检查OpenClaw服务是否正在运行：openclawgatewa401UnauthorizedAPIKey无效，检查是否复制正确，有无多余空格403ForbiddenAPIKey权限不足，去平台检查是否完成实名认证429TooManyRequests免费额度用完，等明天重置或充值连接超时/timeout网络问题，检查服务器能否访问API地址，或切换模型openclawonboard首次配置向导（安装后第一次运行）openclawdoctor检查OpenClaw健康状态（排查问题）openc