乐于分享
好东西不私藏

30张截图教你从0在本地电脑完整安装 OpenClaw 保姆级指南

30张截图教你从0在本地电脑完整安装 OpenClaw 保姆级指南

大家好,我是玄姐。

PS:

OpenClaw 火了,你搞懂 OpenClaw 架构、技术、部署、场景、使用技巧了吗?周五会开场直播详细讲解,欢迎点击预约,直播见

第一部分:从0完整按照 OpenClaw

在你本地 Windows 操作系统上基于官方 Quick Setup 从0开始完整安装 OpenClaw,官方本地 Windows 上安装指南如下:
https://docs.openclaw.ai/start/getting-started#windows-powershell
第一步:以管理员身份打开 PowerShell 命令行,并执行安装 OpenClaw 命令:
 iwr -useb https://openclaw.ai/install.ps1 | iex 
安装过程中会自动下载安装 Node.js 和 Git
在执行过程中会出现以下问题:
安装失败的原因是Windows PowerShell 的执行策略(Execution Policy)限制了脚本的运行
解决步骤
  • 以管理员身份打开 PowerShell
    • 点击 Windows 任务栏的开始菜单。

    • 搜索 PowerShell

    • 右键点击“Windows PowerShell”,选择“以管理员身份运行”。

  • 修改当前用户的执行策略 在弹出的 PowerShell 窗口中,复制并运行以下命令:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

注意: 运行该命令后,系统可能会提示你是否要更改执行策略。输入 Y(或 A)并按回车键确认。RemoteSigned 是 Windows 开发者常用的安全策略,它允许运行本地脚本,同时要求从互联网下载的脚本必须具有签名。

  • 重新运行 OpenClaw 安装命令 策略修改成功后,你可以直接在当前的 PowerShell 窗口中,再次运行 OpenClaw 的官方安装命令:
iwr -useb https://openclaw.ai/install.ps1 | iex
按照上述步骤操作后,安装应该就能顺利进行并自动调用 npm 完成 OpenClaw 的下载了。
第二步:在 PowerShell 命令行中,继续执行 OpenClaw 工具的初始化向导安装命令,
#一键完成 OpenClaw 初始化 + 后台服务安装openclaw onboard --install-daemon 
初始化向导会让你选择 Channel 渠道,我这里选择了飞书,会提示让你输入飞书应用(Feishu App)的 App Secret(应用密钥)和 App ID (应用 ID),输入对应的应用密钥和应用 ID 即可(如何创建飞书应用下一部分会详细讲)。
接收下来输入允许哪些群组可以使用 OpenClaw,安全建议:先设置允许一个群组可以使用 OpenClaw,输入此群组的 chat_id
飞书客户端直接查看 chat_id(推荐,7.60+ 版本)方法如下:
  • 打开飞书,进入目标群组
  • 点击右上角···(更多)→ 进入群设置
  • 拉到页面最底部,找到群 ID,点击即可复制
接下来安装默认会选择 openai-codex 模型,这步先使用默认(后续我会通过修改配置文件直接替换成国内模型,比如:DeepSeek),建议使用 Google 账号直接登录。
登录成功后,出出现以下提示:
接下来选择 OpenClaw 启动方式,默认选择 TUI(文本用户界面)
到这里,OpenClaw 就在本地 Windows 上安装成功,并已启动,启动的进程为:node.exe
第三步:检查 OpenClaw Gateway 网关状态,执行命令:
openclaw gateway status
以上为 OpenClaw 网关(Gateway)的运行状态报告。
简单来说,它的意思是:恭喜你,OpenClaw 的核心后台服务已经成功启动,并且目前运行状态非常健康!
第四步:启动 UI 控制台,执行命令:
openclaw dashboard
你可以通过 Web 页面和 OpenClaw 进行沟通协作了。
第五步:OpenClaw 在按照过程中默认使用 openai-codex 模型,这个模型对大家来说门槛有些高,可以通过编辑~/.openclaw/openclaw.json 里的内容直接替换,比如:替换为国内 DeepSeek 模型。
原配置内容为
{  "meta": {    "lastTouchedVersion""2026.3.8",    "lastTouchedAt""2026-03-11T08:28:20.623Z"  },  "wizard": {    "lastRunAt""2026-03-11T05:42:05.206Z",    "lastRunVersion""2026.3.8",    "lastRunCommand""onboard",    "lastRunMode""local"  },  "agents": {    "defaults": {      "model": {        "primary""openai-codex/deepseek-chat"      },      "models": {        "openai-codex/deepseek-chat": {}      },      "workspace""C:\\XXX\\.openclaw\\workspace",      "compaction": {        "mode""safeguard"      },      "maxConcurrent"4,      "subagents": {        "maxConcurrent"8      }    }  },  "tools": {    "profile""coding",    "web": {      "search": {        "provider""kimi"      }    }  },  "messages": {    "ackReactionScope""group-mentions"  },  "commands": {    "native""auto",    "nativeSkills""auto",    "restart"true,    "ownerDisplay""raw"  },  "session": {    "dmScope""per-channel-peer"  },  "channels": {    "feishu": {      "enabled"true,      "appId""cli_XXXX",      "appSecret""XXXX",      "connectionMode""websocket",      "domain""feishu",      "groupPolicy""allowlist",      "groupAllowFrom": [        "oc_XXXX"      ]    }  },  "gateway": {    "port"18789,    "mode""local",    "bind""loopback",    "auth": {      "mode""token",      "token""XXX"    },    "tailscale": {      "mode""off",      "resetOnExit"false    },    "nodes": {      "denyCommands": [        "camera.snap",        "camera.clip",        "screen.record",        "contacts.add",        "calendar.add",        "reminders.add",        "sms.send"      ]    }  },  "plugins": {    "load": {      "paths": [        "C:\\XXXX\\Roaming\\npm\\node_modules\\openclaw\\extensions\\feishu"      ]    },    "entries": {      "feishu": {        "enabled"true      }    }  }}
修改后配置内容为:

配置变更点说明:

  • ✅ 已切换到 DeepSeek 模型(deepseek/deepseek-chat

  • ✅ 配置了 2 个 DeepSeek 模型:标准版 Chat 和推理版 Reasoner

  • ✅ 上下文窗口 64K,最大 Token 8K

{  "meta": {    "lastTouchedVersion""2026.3.8",    "lastTouchedAt""2026-03-11T08:28:20.623Z"  },  "wizard": {    "lastRunAt""2026-03-11T05:42:05.206Z",    "lastRunVersion""2026.3.8",    "lastRunCommand""onboard",    "lastRunMode""local"  },  "models": {    "mode""merge",    "providers": {      "deepseek": {        "baseUrl""https://api.deepseek.com",        "apiKey""sk-XXXX",        "api""openai-completions",        "models": [          {            "id""deepseek-chat",            "name""DeepSeek Chat",            "contextWindow"64000,            "maxTokens"8000          },          {            "id""deepseek-reasoner",            "name""DeepSeek Reasoner",            "contextWindow"64000,            "maxTokens"8000          }        ]      }    }  },  "agents": {    "defaults": {      "model": {        "primary""deepseek/deepseek-chat"      },      "models": {        "deepseek/deepseek-chat": {}      },      "workspace""C:\\XXX\\XXX\\.openclaw\\workspace",      "compaction": {        "mode""safeguard"      },      "maxConcurrent"4,      "subagents": {        "maxConcurrent"8      }    }  },  "tools": {    "profile""coding",    "web": {      "search": {        "provider""kimi"      }    }  },  "messages": {    "ackReactionScope""group-mentions"  },  "commands": {    "native""auto",    "nativeSkills""auto",    "restart"true,    "ownerDisplay""raw"  },  "session": {    "dmScope""per-channel-peer"  },  "channels": {    "feishu": {      "enabled"true,      "appId""cli_XXXX",      "appSecret""XXXX",      "connectionMode""websocket",      "domain""feishu",      "groupPolicy""allowlist",      "groupAllowFrom": [        "oc_XXXX"      ]    }  },  "gateway": {    "port"18789,    "mode""local",    "bind""loopback",    "auth": {      "mode""token",      "token""XXXX"    },    "tailscale": {      "mode""off",      "resetOnExit"false    },    "nodes": {      "denyCommands": [        "camera.snap",        "camera.clip",        "screen.record",        "contacts.add",        "calendar.add",        "reminders.add",        "sms.send"      ]    }  },  "plugins": {    "load": {      "paths": [        "C:\\XXX\\XXXX\\AppData\\Roaming\\npm\\node_modules\\openclaw\\extensions\\feishu"      ]    },    "entries": {      "feishu": {        "enabled"true      }    }  }}

第二部分:从0配置飞书 Channel

第一步:创建飞书自建应用
1、进入 https://open.feishu.cn/,登录飞书账号(建议登录个人账号,如果是企业账号,后续步骤需要企业管理员审核),登录成功后,点击右上角【开发者后台】
2、进入飞书开放平台,点击【创建企业自建应用】
3、填好相应的应用名称、应用描述,选择【创建】
4、创建成功后,为应用添加【机器人】能力
第二步:开通应用权限
1、选择【权限管理】-【批量导入/导出权限】,复制以下 JSON 代码进去。
正确的复制姿势!!(以下方法二选一)鼠标移到代码块 右上角复制按钮(如图)鼠标点击到代码块内容,ctrl+A 全选,ctrl+C 复制⚠️注意!不要用其他应用的复制功能,不然会复制错误

代码如下:⬇️

注意:代码出现格式错误,确认一下是不是创建成“商店应用”了

{  "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",      "contact:contact.base: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"]  }}
第三步:绑定应用到 OpenClaw 并发布
1、这一步在 OpenClaw 本地按照的时候已绑定,直接跳过。请到飞书继续完成事件与配置。
2、绑定成功后,重新回到飞书刚刚创建的应用中,选择【事件与回调】,选择【长连接接受事件】,保存。
3、选择【添加事件】,在应用身份订阅栏,找到“接收消息”。确认添加。
4、终于到最后一步了。点击【版本管理与发布】-【创建版本】,填入相应的应用版本号以及更新说明(随意填,比如:1.0.0),点击【保存】并【发布】。
第四步:在手机飞书上将机器人添加到常用
  • 在飞书手机版- 工作台 -【+】搜索自建的应用名,添加到常用。
  • 机器人就会出现在你的消息人列表中,直接在飞书移动端给配置好的机器人发消息,桌面端的对话窗口就会自动弹出。你就可以实现【随时随地飞书发送消息,OpenClaw 远程为你操作电脑】
第五步:打开 OpenClaw,就可以和它沟通协作了
几点重要提示
 第一,在安装过程中遇到莫名的问题怎么办?
直接把问题截图给 Gemini 3.1 Pro 或者 Kimi 2.5 思考 ,它会引导你一步一步解决。
第二,在安装过程主要使用 Gemini 3.1 Pro 和 Kimi 2.5 思考模型,也推荐给大家,好用靠谱。
第三、安全是本地安装第一要务,建议打开 web 端只能本地连接访问权限。
bind=loopback (127.0.0.1) - 只绑定到本地回环地址
第四、Skills 环节在本地安装的时候可以都跳过,在使用 OpenClaw 过程中需要使用到具体 Skills 时,即时安装就好。
从0完整本地安装的确不容易,有了这份保姆级教程,必将大大降低了难度,快去试试吧~~

PS:

OpenClaw 火了,你搞懂 OpenClaw 架构、技术、部署、场景、使用技巧了吗?周五会开场直播详细讲解,欢迎点击预约,直播见

好了,这就是我今天想分享的内容。如果你对构建企业级 AI 原生应用新架构设计和落地实践感兴趣,别忘了点赞、关注噢~

—1—

加我微信

扫码加我👇有很多不方便公开发公众号的我会直接分享在朋友圈,欢迎你扫码加我个人微信来看👇

加星标★,不错过每一次更新!

⬇戳”阅读原文“,立即预约!