前置环境及注意事项1.1 环境node.js 环境配置git 安装openclaw: Node.js v22.19 is required (current: v22.18.0). If you use nvm, run: nvm install 22 nvm use 22 nvm alias default 22此情况需要升级 node 环境的版本升级后建议重新安装 openclaw确保脚本执行由于之前安装时跳过了脚本升级 Node 后最好重新安装一次并允许执行脚本npm uninstall -g openclaw npm install -g --allow-scriptsopenclaw,google/genai,protobufjs,tree-sitter-bash openclawlatest验证openclaw --version如图 如果正常输出版本号就说明一切就绪了。1.2 注意事项1.2.1 node 版本必须为22.18.0 以上的版本1.2.2 配置PowerShell执行策略必选1.3 设置npm全局路径到D盘推荐避免C盘爆满此项为可选# 创建目录 mkdir D:\OpenClaw\npm-global -Force mkdir D:\OpenClaw\npm-cache -Force 一键获取完整项目代码 bash # 配置npm路径 npm config set prefix D:\OpenClaw\npm-global第一步 打开 Windows PowerShell输入Windows PowerShell-右击管理员打开第二步安装OpenClaw2.1 全局安装OpenClaw#powershell # 以管理员身份运行PowerShell npm install -g openclawlatest added 656 packages in 3m第三章首次配置最关键的一步3.1 运行配置向导#powershell openclaw onboard #按提示选择 #知晓风险 → Yes #安装模式 → QuickStart快速开始 #配置类型 → Create new创建新配置3.1 选择快速启动3.2 选择大模型配置 API 密钥选择 more 的可以显示更多大模型 API 的选择本人选 DeepSeekDeepSeek | 深度求索如果这里之前创建的 API 密钥忘记了可以直接删除重新再创建一个 API 密钥3.2 配置模型提供商这里可以浏览你选择的 API 供应商所有在 OpenClaw 智能体里可以使用的模型甚至选择的步骤本身你也可交给 AI 来进行综合考量选择最恰当的情况3.3 选择频道、配置连接方式3.3.1 创建飞书机器人飞书官网传送门飞书开放平台-右上角点击按钮进入开发者工作台飞书工作台传送门开发者后台 - 飞书开放平台-点击创建应用图标你也可以自定义点击配置点击权限管理输入 im、并且选中所有权限设置完成后点击确认发布编辑订阅方式选择为长连接搜索通讯录-勾选点击全部-点击确认然后再次发布新版3.3.2 连接 OpenClaw 与飞书这里可以选择第二个在所有群聊里都可以使用机器人但是必须艾特机器人这里可以选跳过空格选跳过-按回车选第一个回车进入OKKKKKK3.4 完成向导通讯渠道 → Skip for now先不配 技能配置 → No稍后手动装 最后选择 → Restart重启网关3.5 连接飞书机器人移动端使用 OpenClaw选择 localopenclaw pairing list --channel feishu这里的 ID 和 App Secret 可以在终端界面通过鼠标右键快速复制粘贴如果给 AI Agent 发消息其没有回复则可以通过下述网址解决https://juejin.cn/post/7611769471620956198配置 OpenClaw视频版选择通讯渠道Skills空格选择 Skip For now空格选择 Skip For now是否启用 Hook:空格选择 Skip For now接来下程序会自动启用网关该窗口不用关选择小龙虾的启用方式选择 Web UI界面更直观操作更友好一些原视频地址https://www.bilibili.com/video/BV1UsP1zqEWc/?spm_id_from333.337.search-card.all.clickvd_source5cf5b4cdcb9854406ecd88503afe4492附录 openClaw 相关指令的操作集合第五章安装文件管理技能让AI能操作电脑自选 5.1 安装ClawHub技能商店 #powershell npm install -g clawhub 一键获取完整项目代码 bas 5.2 安装file-manager技能 #powershell npx clawhublatest install file-manager #预期结果 #text #✔ OK. Installed file-manager - C:\Users\你的用户名\.openclaw\workspace\skills\file-manager 5.3 验证技能安装 #powershell openclaw skills list #应该能看到 #text #✓ ready │ file-manager │ OpenClaw自动化文件管理助手... 第六章配置网关和权限 6.1 编辑配置文件 notepad $env:USERPROFILE\.openclaw\openclaw.json 一键获取完整项目代码 bash 6.2 替换为完整配置 { models: { mode: merge, providers: { deepseek: { baseUrl: https://api.deepseek.com/v1, apiKey: sk-YOUR_NEW_SECRET_KEY_HERE, api: openai-completions, models: [ { id: deepseek-v4-pro, name: DeepSeek V4 Pro, contextWindow: 128000, maxTokens: 8192 } ] } } }, agents: { defaults: { model: { primary: deepseek/deepseek-v4-pro }, workspace: C:\\Users\\你的用户名\\.openclaw\\workspace } }, tools: { profile: full, exec: { host: gateway, security: full, ask: off } }, commands: { native: auto, nativeSkills: auto, restart: true, bash: true }, gateway: { port: 18789, mode: local, bind: loopback, auth: { mode: token, token: 你的网关Token可以自己随便设一个复杂字符串 } } } 一键获取完整项目代码 bash 6.3 重启网关 #powershell openclaw gateway restart 6.4 验证状态 #powershell openclaw gateway status # 必须看到 # Runtime: running # RPC probe: ok providers: { deepseek: { baseUrl: https://api.deepseek.com/v1, apiKey: sk-8f80143d8fa848deaba1998d2609007f, api: openai-completions, models: [ { id: deepseek-v4-pro, name: DeepSeek V4 Pro, contextWindow: 128000, maxTokens: 8192 } ] }openclaw status用于查看 OpenClaw 系统当前会话、插件、模型和运行时的状态openclaw doctor命令。这个内置工具可以自动检测并尝试修复配置问题openclaw主要启动命令在终端中执行以下命令来启动 OpenClaw直接启动openclaw。这是最简单的启动方式。启动网关服务openclaw gateway或openclaw gateway start。这是启动核心网关服务的主要命令。后台运行openclaw gateway start。该命令会让网关服务在后台运行不占用终端。前台调试openclaw gateway run。该命令会让网关服务在前台运行方便你实时查看日志进行调试。打开网页控制台也就是Windows PowerShellopenclaw dashboard。执行后浏览器会自动打开 OpenClaw 的网页控制台界面。openclaw 对接完飞书群机器人配置踩坑记消息不回、Gateway 断开问题排查_receive events or callbacks through persistent con-CSDN博客openclaw 对接完飞书群机器人配置踩坑记消息不回、Gateway 断开问题排查