大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



openclaw onboard

openclaw config

openclaw status

openclaw gateway/ openclaw  gateway install/ start(后台）openclaw gateway stop/restrart/ 

openclaw dashboard

openclaw logs --follow

openclaw update

https://zhuanlan.zhihu.com/p/

补充： 安装git 

参考：

https://vor2345.blog.csdn.net/article/details/

#安装 Clawdbot npm i -g openclaw #配置 Clawdbot openclaw onboard

权限：

https://blog.csdn.net/u0/article/details/

路径：C:Usersjusti.openclaw

http://127.0.0.1:18789/#token=abc1234

备用：

https://developer.aliyun.com/article/

------------------

openclaw gateway run

---------------------

清理残留进程与端口（默认 18789）

表格

简介： OpenClaw（前身为MoltBot、Clawbot）作为一款功能全面的开源智能体AI助手，打破了传统AI“只对话不行动”的局限——它既具备自然语言交互能力，又能像“数字员工”一样动手执行任务：可读写本地文件、运行代码、操控命令行，还能联网搜索分析网页内容，同时支持对接Qwen、OpenAI等云端大模型，或利用本地GPU运行模型，兼顾数据隐私与功能灵活性。

OpenClaw（前身为MoltBot、Clawbot）作为一款功能全面的开源智能体AI助手，打破了传统AI“只对话不行动”的局限——它既具备自然语言交互能力，又能像“数字员工”一样动手执行任务：可读写本地文件、运行代码、操控命令行，还能联网搜索分析网页内容，同时支持对接Qwen、OpenAI等云端大模型，或利用本地GPU运行模型，兼顾数据隐私与功能灵活性。

本文专为零基础用户打造，聚焦Windows系统本地部署全流程，从环境准备、主程序安装到问题排查，每一步均提供详细操作指引与截图级说明，同时补充关键注意事项与避坑技巧，确保无技术基础的用户也能顺利搭建专属本地AI助手。

在启动部署前，需明确OpenClaw的运行依赖与必备工具，避免因环境不达标或工具缺失导致流程中断，为后续操作奠定基础。

（一）核心功能与适用场景

OpenClaw的核心价值在于“本地化运行+实操能力”，具体可实现三类关键功能：

1. 文件与命令操作：读取/修改本地文档（如分析F盘的项目报告）、执行代码（用Python生成数据图表）、调用系统命令（查看磁盘占用、批量重命名文件）；
2. 自动化任务：监控文件夹（新增文件自动备份至云端）、定时执行任务（每天早7点生成前日邮件摘要）、跨平台同步（钉钉日程与本地日历联动）；
3. 多渠道交互：支持Telegram、WhatsApp、钉钉等常用聊天工具，无需打开专用界面，在熟悉的渠道中即可发送指令（如@钉钉机器人“整理今日待办”）。

适用人群覆盖广泛：开发者可用于自动化测试与代码生成，职场人可解放邮件筛选、文档整理等重复工作，学生群体则能借助其实现知识点总结（如提取B站视频核心内容）。

（二）环境与工具要求

1. 系统与硬件：仅支持Windows（需Windows 10及以上，推荐Windows 11），硬件需满足内存≥4GiB（运行更流畅）、磁盘预留≥10GiB（存储依赖与运行日志），无GPU强制要求（本地运行大模型需额外配置）；
2. 核心依赖：Node.js（版本≥22，OpenClaw运行的基础环境）、npm（Node.js自带，用于安装扩展技能）；
3. 必备工具：
   • 终端工具：Windows自带PowerShell（无需额外安装）；
   • 文本编辑器：系统记事本或Notepad++（用于修改配置文件）；
   • 浏览器：Chrome、Edge等主流浏览器（访问OpenClaw Web管理界面）；
4. 可选准备：目标大模型API Key（如阿里云百炼、Qwen账号，用于启用智能交互能力）、常用聊天工具账号（如Telegram、钉钉，后续对接交互渠道）。

OpenClaw完全依赖Node.js运行，且对版本有严格要求（≥22），需优先完成Node.js的安装或升级，这是部署成功的关键前提。

（一）全新安装Node.js（未安装过的用户）

1. 下载适配安装包

1. 打开Node.js官方网站（https://nodejs.org/），网站会自动识别Windows系统，无需手动选择；
2. 点击“Windows Installer (64-bit)”下载.msi格式安装包（64位是当前Windows主流架构，无需选择32位）；
3. 建议将安装包保存到桌面或“下载”文件夹，避免后续找不到文件（如保存路径“C:Users你的用户名Downloads”）。

2. 分步完成安装（新手全程默认下一步）

1. 双击安装包启动向导，点击“Next”；
2. 勾选“我接受许可协议（I accept the terms in the License Agreement）”，继续“Next”；
3. 关键步骤1：确认安装路径：默认路径为“C:Program Files odejs”，新手切勿修改——自定义路径可能导致后续环境变量配置失败，直接点击“Next”；
4. 关键步骤2：配置环境变量：进入“Custom Setup”页面，确保“Add Node.js to PATH”选项已勾选（该选项会自动将Node.js添加到系统环境变量，无需手动配置），其他选项保持默认，点击“Next”；
5. 后续页面无需修改高级选项（如“Tools for Native Modules”保持默认），连续点击“Next”，最后点击“Install”开始安装；
6. 等待10-30秒（安装速度取决于电脑配置），出现“Completed”提示后，点击“Finish”关闭向导。

3. 验证安装效果（必须重启终端）

1. 重启终端：关闭所有已打开的PowerShell/CMD窗口（不重启会导致系统无法识别新安装的Node.js）；
2. 按下“Win+R”，输入“PowerShell”，打开普通权限的PowerShell窗口；
3. 输入命令，若输出“v22.x.x”或“v24.x.x”（如v22.10.0、v24.4.0），说明安装成功且版本符合要求；
4. 可选验证：输入，若能正常输出版本号（如10.8.1），代表npm与环境变量配置无误。

（二）升级旧版Node.js（已安装但版本过低）

若此前安装过Node.js，执行显示版本低于22（如v18.19.0），需手动卸载旧版并安装新版，避免版本冲突：

1. 卸载旧版：
   • 按下“Win+R”，输入“control”打开控制面板，进入“程序和功能”；
   • 在程序列表中找到“Node.js”，右键选择“卸载”，按提示完成操作；
   • 手动删除残留文件：打开“C:Program Files odejs”文件夹，删除所有内容（若提示“文件正在使用”，重启电脑后再删除）；
2. 清理环境变量（可选但推荐）：
   • 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”；
   • 在“系统变量”的“Path”中，删除包含“nodejs”的旧路径（如“C:Program Files odejs”）；
3. 安装新版：按“全新安装”步骤下载v22或v24稳定版，完成安装后重启终端验证版本。

（三）解锁PowerShell脚本执行权限

Windows默认禁止运行脚本，会导致后续OpenClaw安装指令失效，需手动开启权限：

1. 以管理员身份运行PowerShell：按下“Win”键，搜索“PowerShell”，右键选择“以管理员身份运行”；
2. 输入命令：；
3. 出现“是否要更改执行策略”提示时，输入“Y”并回车，权限即刻生效（该设置仅对当前用户生效，不影响系统安全）。

环境准备完成后，通过一键安装脚本部署主程序，并通过初始化向导完成基础配置，让AI助手初步运行。

（一）执行一键安装命令

1. 打开普通权限的PowerShell（无需管理员权限）；
2. 输入以下命令，该命令会自动从官方服务器下载OpenClaw主程序并配置环境变量：

3. 安装过程说明：
   • 若长时间无进展（超过5分钟），可按回车键刷新终端，避免因PowerShell休眠导致误判；
   • 出现“Clawdbot installed successfully”提示时，代表主程序安装完成（部分用户可能显示“Moltbot installed”，因更名历史导致，功能无差异）。

（二）运行初始化向导（Onboarding）

安装完成后，需通过向导配置基础参数（如模型选择、技能启用），新手按推荐选项操作即可，无需手动修改复杂设置：

1. 在PowerShell中输入命令，启动配置向导；
2. 按以下步骤选择选项（括号内为推荐选择）：
   • Mode（运行模式）：按上下键选择“QuickStart”（快速启动，跳过复杂配置），回车确认；
   • Provider（模型提供商）：推荐选择“Qwen”（通义千问，无需额外API Key，适合新手），此时会自动弹出浏览器，登录或注册Qwen账号完成授权（授权后获取临时“大脑”，支持基础对话）；
   • Default model（默认模型）：保持当前选项“qwen-portal/coder-model”，直接回车（无需手动输入）；
   • Channels（交互渠道）：选择“Skip for now”（暂不配置远程渠道，先实现本地运行，后续可补充）；
   • Skills（基础技能）：选择“Yes”（启用文件操作、命令执行等核心技能，推荐新手启用）；
   • Skill install（技能安装工具）：选择“npm”（系统已预装，无需额外安装pnpm/bun）；
   • Skill Dependencies（技能扩展依赖）：选择“Skip for now”（暂不安装扩展依赖，避免配置复杂，后续可按需添加）；
   • 其他配置（如GOOGLE_PLACES_API_KEY、Hooks）：均选择“No”或“Skip for now”，留待后续按需配置；
3. 完成标志：向导执行结束后，终端显示“Gateway service installed”，表示网关服务已部署，主程序安装与初始化全部完成。

（三）验证服务启动状态

1. 输入命令，若输出“Gateway is running”，说明服务正常启动；
2. 若显示“Gateway is stopped”，输入手动启动服务，等待10秒后再次验证。

部署后可能遇到“命令失效”“网关未授权”等问题，需针对性排查，确保OpenClaw正常使用。

（一）“moltbot”命令失效（提示“无法识别”）

1. 现象

输入时，终端提示“无法将‘moltbot’项识别为cmdlet、函数、脚本文件或可运行程序的名称”。

2. 原因

安装后环境变量未及时刷新，系统无法找到moltbot命令路径。

3. 解决方案

• 方案1：重启PowerShell：关闭当前窗口，重新打开后输入，多数情况下可解决；
• 方案2：使用npx临时执行：若重启后仍失效，输入，该命令会直接调用本地安装的程序，无需依赖环境变量；
• 方案3：手动配置环境变量（适用于极端情况）：
  1. 找到OpenClaw安装路径（默认“C:Users你的用户名AppDataRoaming pm”）；
  2. 按“升级旧版Node.js”中的步骤，将该路径添加到系统变量“Path”中；
  3. 重启终端后验证命令。

（二）网关未授权（令牌缺失）

1. 现象

打开浏览器访问“http://localhost:18789”（OpenClaw Web管理界面），页面显示“未授权：网关令牌缺失”，无法进入对话界面。

2. 原因

OpenClaw通过令牌（Token）验证访问权限，首次访问需手动输入配置文件中的令牌。

3. 解决方案

1. 找到配置文件：
   • 打开文件夹“C:Users你的用户名.clawdbot”（“你的用户名”替换为当前Windows登录账号名称，如“ZhangSan”）；
   • 找到“clawdbot.json”文件（JSON格式，大小约3-5KB），右键选择“记事本”打开；
2. 提取令牌：
   • 在文件中按“Ctrl+F”搜索“token”，找到类似的行；
   • 复制引号内的长字符串（如“c25bbh909c7xxxxxxxxxx”），注意不要复制引号或逗号；
3. 完成授权：
   • 回到浏览器的“未授权”页面，点击右上角红色“未授权”提示框，粘贴复制的令牌；
   • 点击“确认”，页面状态变为绿色“已授权”，自动跳转至对话界面，AI助手正式上线。

（三）Web界面无法访问（localhost:18789打不开）

1. 现象

输入“http://localhost:18789”后，浏览器提示“无法访问此网站”或“连接超时”。

2. 排查步骤

1. 检查网关服务状态：在PowerShell中输入，若显示“stopped”，执行启动服务；
2. 验证端口是否被占用：
   • 以管理员身份运行PowerShell，输入；
   • 若输出结果包含“LISTENING”，说明端口被其他程序占用，需修改OpenClaw端口：
     1. 打开“C:Users你的用户名.clawdbotclawdbot.json”；
     2. 搜索“gateway”，找到，将18789改为未占用端口（如18790）；
     3. 重启网关服务：，用新端口（如http://localhost:18790）访问；
3. 关闭防火墙干扰（临时测试）：
   • 按下“Win+R”，输入“control firewall.cpl”打开防火墙；
   • 点击“关闭Windows Defender防火墙”，测试是否能访问（访问成功后重新开启防火墙，无需长期关闭）。

授权成功后，需通过简单指令测试核心功能，确保服务正常，同时可按需配置扩展能力，提升AI助手实用性。

（一）核心功能验证（必做）

登录OpenClaw Web界面（http://localhost:18789），在对话输入框发送以下指令，验证功能是否正常：

1. 基础对话：输入“介绍一下你自己”，若返回包含“本地AI助手”“文件操作”等关键词的响应，说明模型调用正常；
2. 文件读取：输入“读取C:Users你的用户名Desktop est.txt文件内容”（需提前在桌面创建test.txt并写入内容），若能正确返回文件内容，代表文件操作权限正常；
3. 命令执行：输入“查看当前磁盘C的占用情况”，若返回类似“已用空间：40GB，剩余空间：100GB”的结果，说明系统命令调用正常。

若某功能无响应，参考第三阶段“问题排查”修复，确保基础功能可用后再进行拓展。

（二）拓展配置（可选，新手可后续探索）

1. 对接云端大模型（如阿里云百炼）

若需更强的推理能力（如复杂文档总结、代码生成），可对接阿里云百炼等平台的模型：

1. 登录阿里云百炼控制台（https://bailian.console.aliyun.com），创建API-Key；
2. 打开OpenClaw Web界面，左侧点击“Config > Models”；
3. 选择“Add Provider”，填写百炼API-Key与baseUrl（https://dashscope.aliyuncs.com/compatible-mode/v1）；
4. 保存后在对话时输入“使用百炼模型回答”，即可切换模型。

2. 绑定钉钉/Telegram交互渠道

以钉钉为例，实现“在钉钉@机器人发送指令”：

1. 登录钉钉开放平台，创建企业内部机器人，获取Bot Token；
2. 打开OpenClaw Web界面，左侧点击“Channels > 钉钉”；
3. 粘贴Bot Token，设置“交互模式”为“群聊@响应”，保存后重启网关；
4. 在钉钉群添加该机器人，@机器人发送“帮我整理今日待办”，测试响应。

3. 启用本地大模型（无网络也能用）

若需离线使用，可通过Ollama桥接本地模型（如Llama 3）：

1. 下载Ollama（https://ollama.com/），安装后执行`ollama pull llama3:8b`拉取模型；
2. 打开OpenClaw配置文件，添加Ollama模型地址（http://localhost:11434）；
3. 在Web界面选择“本地模型”，即可离线发送指令（如“生成一篇关于AI的短文”）。

1. 安全防护：
   • 令牌（Token）是访问OpenClaw的关键凭证，切勿分享给他人，定期在“Config > Security”中刷新令牌；
   • 限制文件操作权限：在“Config > Permissions”中，仅开放必要文件夹（如桌面、文档），禁止“全盘访问”；
2. 性能优化：
   • 关闭不必要的技能：在“Skills”页面，取消勾选无需使用的技能（如“语音识别”），减少内存占用；
   • 清理日志：定期删除“C:Users你的用户名.clawdbotlogs”中的旧日志文件，释放磁盘空间；
3. 版本更新：
   • 执行可升级OpenClaw至最新版本，修复已知漏洞；
   • 更新前备份配置文件（clawdbot.json），避免配置丢失。

六、阿里云一键部署Openclaw（原Clawdbot）教程

阿里云上线了轻量应用服务器 OpenClaw（原Clawdbot）一键部署功能，开箱即用更方便快捷！

第二步：购买阿里云轻量应用服务器，配置参考如下：

• 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
• 实例：内存必须2GiB及以上。
• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
• 时长：根据自己的需求及预算选择。

第三步：前往阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。

• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
• 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
• 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
• 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

通过以上步骤，Windows系统用户可零门槛完成OpenClaw本地部署，拥有一款“能动手、会跑腿”的专属AI助手。核心流程可概括为：搭建Node.js环境→安装主程序→初始化配置→解决常见故障→验证功能。

部署过程中，最易踩坑的点是“Node.js版本不足”“脚本权限未解锁”“令牌缺失”，按本文步骤逐一排查即可解决。新手无需追求一步到位配置所有功能，可先使用基础能力，后续逐步探索模型切换、多渠道对接等拓展功能，让AI助手随需求逐步进化。

若遇到未覆盖的问题，可访问OpenClaw官方文档或阿里云开发者社区，获取更多技术支持。