【人工智能:Agent】--Windows搭建中文版OpenClaw(小龙虾)

张开发
2026/5/4 22:37:09 15 分钟阅读
【人工智能:Agent】--Windows搭建中文版OpenClaw(小龙虾)
目录1.OpenClaw--简介2.OpenClaw--安装环境2.1.安装Node.js环境2.2.安装git环境3.OpenClaw--一键部署3.1.安装前端架构3.2.启动服务3.3.打开服务4.OpenClaw--使用4.1.连接微信1.OpenClaw--简介OpenClaw 是一个开源的个人 AI 助手网关被形象地称为“长在你电脑里的数字员工”。它允许你将各种 AI 能力接入到日常通讯工具中实现跨平台、跨设备的智能任务处理。以下是对其详细介绍及核心功能的梳理 核心概念与特点项目定位OpenClaw 是一个开源的 AI 网关工具运行在个人电脑或服务器上作为 AI 能力的“中转站”和通讯平台的“连接器”。增长速度自 2025 年 11 月开源以来迅速斩获 GitHub 230K Stars成为开源史上增长最快的 AI 项目之一。核心优势实现“一次部署多平台通联”支持本地化运行与全连接打破平台和空间限制。 多平台接入能力OpenClaw 支持将 AI 能力接入多种通讯工具包括但不限于飞书、钉钉、Telegram、Discord、iMessage、WhatsApp 等。这意味着你可以在一个平台上使用 AI 助手同时在其他平台上也能同步接收和处理信息实现多平台同时在线。 智能任务处理OpenClaw 不仅能聊天还能通过接入的 AI 大模型如 Claude、Pi、ChatGPT 等执行复杂的智能任务例如文件管理自动检索、发送文件。代码编写编写代码并部署运行。生活助手查询天气、记录日程、生成菜谱等。️ 部署与使用OpenClaw 的部署门槛较低支持 Windows 系统通过 Node.js 和 Git 等工具进行安装配置。即使是没有技术背景的用户也可以通过教程在 30 分钟内完成从环境搭建到公网访问的全流程。OpenClaw 通过整合 AI 能力和通讯工具为用户提供了一个高效、便捷的智能助手解决方案适用于个人和企业用户提升工作和生活效率。githubhttps://github.com/openclaw/openclaw文档https://docs.openclaw.ai/zh-CN2.OpenClaw--安装环境Windows 操作系统上进行部署。在运行 OpenClaw前必须要安装两样基础工具Node.js 和 Git。官方虽然提供的一键脚本即可安装Nodejs和Git 但是可能存在网络问题所以这里更建议小伙伴们手动安装一下2.1.安装Node.js环境Node.js 环境是开启后端开发、前端工具链或 AI 应用开发的第一步。这里推荐使用nvm进行安装nvm是node.js的版本管理器可以方便地切换不同版本的node.js。首先打开nvm的github仓库当前最新版本发布页面https://github.com/coreybutler/nvm/releases最下面找到.exe文件下载按照提示安装即可安装完成后来到刚才安装nvm的位置【D:\nvm】双击打开【settings.txt】文件粘贴如下代码然后按【ctrl s】保存node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/验证一下打开终端nvm -v常见的命令分类命令说明安装与卸载nvm install version安装指定版本的 Node.js (如nvm install 18.16.0)nvm install latest安装最新的官方发布版本nvm install --lts安装最新的 LTS长期支持版本nvm uninstall version卸载指定版本的 Node.js版本切换nvm use version切换到指定版本仅对当前终端窗口有效nvm alias default version设置默认 Node.js 版本新建终端也会生效查看状态nvm ls列出本地已安装的所有版本nvm ls-remote列出官方所有可供安装的远程版本nvm current显示当前正在使用的版本nvm version查看当前 nvm 的版本其他辅助nvm alias name version给版本起别名 (如nvm alias prod 14.17.0)nvm unalias name删除已定义的别名nvm which version查看指定版本的安装路径nvm install 22 nvm use 22.20.0 node -v npm -v这样就成功安装好了nodejs啦通过nvm管理器后续可以用同样操作很方便地安装和切换不同版本的nodejs。2.2.安装git环境参考这个教程https://blog.csdn.net/qq_58602552/article/details/148012862?ops_request_misc%257B%2522request%255Fid%2522%253A%2522b9552c1ba3c7588b1571f5622ba3d880%2522%252C%2522scm%2522%253A%252220140713.130102334.pc%255Fblog.%2522%257Drequest_idb9552c1ba3c7588b1571f5622ba3d880biz_id0utm_mediumdistribute.pc_search_result.none-task-blog-2~blog~first_rank_ecpm_v1~rank_v31_ecpm-1-148012862-null-null.nonecaseutm_termgitspm1018.2226.3001.4450安装好后验证一下git --version3.OpenClaw--一键部署安装完成nodejs和git环境后接下来就是部署中文版openclaw了。这里推荐使用一键部署脚本官方提供多种部署方式包括cmd、powershell、npm、pnpm等这里以PowerShell为例进行演示。3.1.安装前端架构// 将默认源永久修改为淘宝镜像以后所有 npm 操作都会加速 npm config set registry https://registry.npmmirror.com // 验证是否成功 npm config get registry // 安装openclaw中文版 npm install -g qingchencloud/openclaw-zhlatest这样就好了3.2.启动服务openclaw onboard --install-daemon┌ OpenClaw 初始化向导│◇ 安全 ────────────────────────────────────────────────────────────────────────────────────╮│ ││ 安全警告 — 请仔细阅读。 ││ ││ OpenClaw 是一个业余项目仍处于测试阶段。请注意可能存在的问题。 ││ 默认情况下OpenClaw 是个人代理单一可信操作者边界。 ││ 如果启用了工具这个机器人可以读取文件并执行操作。 ││ 恶意提示可能诱使它做出不安全的事情。 ││ ││ OpenClaw 默认不是对抗性多租户边界。 ││ 如果多个用户可以向同一个启用工具的代理发消息他们将共享该代理的工具权限。 ││ ││ 如果你不熟悉安全加固和访问控制请不要运行 OpenClaw。 ││ 在启用工具或将其暴露到互联网之前请寻求有经验的人帮助。 ││ ││ 建议的基线配置 ││ - 配对/白名单 提及控制。 ││ - 多用户/共享信箱拆分信任边界独立网关/凭证最好使用独立的系统用户/主机。 ││ - 沙箱 最小权限工具。 ││ - 共享信箱隔离私信会话 (session.dmScope: per-channel-peer) 并保持最小工具访问权限。 ││ - 将密钥保存在代理无法访问的文件系统之外。 ││ - 对于任何带有工具或不受信任收件箱的机器人使用最强大的可用模型。 ││ ││ 定期运行 ││ openclaw security audit --deep ││ openclaw security audit --fix ││ ││ 必读文档https://docs.openclaw.ai/gateway/security ││ ││ 汉化版社区QQ群 https://qt.cool/c/OpenClaw | 微信群 https://qt.cool/c/OpenClawWx1.基础配置◇ 我理解这默认是个人使用的共享/多用户使用需要安全加固。是否继续│Yes◇ 初始化模式│快速开始◇ 配置处理方式│使用现有值2.配置模型这里使用阿里云百炼获取apihttps://bailian.console.aliyun.com/cn-beijing/?tabmodel#/model-market◇ 模型/认证提供商│Qwen Cloud│◆ Qwen Cloud auth method│ ● Coding Plan API Key for China (subscription) (Endpoint: coding.dashscope.aliyuncs.com)│ ○ Coding Plan API Key for Global/Intl (subscription)│ ○ Standard API Key for China (pay-as-you-go)│ ○ Standard API Key for Global/Intl (pay-as-you-go)│ ○ 返回这里选择第三种然后输入api-key认证方式名称适用区域计费/订阅模式备注Coding Plan API Key for China中国 (China)订阅制 (Subscription)需绑定 Endpoint:coding.dashscope.aliyuncs.comCoding Plan API Key for Global全球/国际 (Global/Intl)订阅制 (Subscription)适用于国际版服务Standard API Key for China中国 (China)按量付费 (Pay-as-you-go)通用的中国区付费模式Standard API Key for Global全球/国际 (Global/Intl)按量付费 (Pay-as-you-go)通用的国际区付费模式◇ Default model│qwen/qwen3.5-plus3.OpenClaw 的渠道Channel配置向导界面。OpenClaw 是一个 AI 聊天机器人框架它需要通过不同的聊天软件如微信、Telegram、飞书等来与你对话。这个界面就是让你选择通过哪个软件来连接和使用 AI。 快速开始 (推荐新手):选择Telegram。原因根据界面提示Telegram 是“最简单的入门方式”。你只需要在 Telegram 里找一个叫BotFather的机器人几步操作就能拿到一个 Token然后填到这里就能立刻开始使用。 国内用户常用:选择飞书/Lark (Feishu)或QQ Bot。原因这两个是国内比较主流的通讯工具集成体验较好。⏭️ 暂时跳过:选择● 暂时跳过。原因如果你现在不想配置任何渠道或者想先研究一下可以选择跳过。以后可以随时通过命令行openclaw channels add来添加和配置渠道。我们这里暂时跳过◇ 选择渠道 (快速开始)│ 暂时跳过4.网页搜索和技能skills配置◇ 网页搜索 ────────────────────────────────────────────────────────╮│ ││ 网页搜索让您的智能体在线查找信息。 ││ 选择一个提供商。部分提供商需要 API 密钥部分无需密钥即可使用。 ││ Docs: https://docs.openclaw.ai/tools/web │◇ 搜索提供商│ 暂时跳过17:02:4908:00 [skills] Skipping skill path that resolves outside its configured root.│◇ 技能状态 ──────────────────╮│ ││ 可用: 4 ││ 缺少依赖: 38 ││ Unsupported on this OS: 8 ││ 被白名单阻止: 0 │◇ 现在配置技能推荐│No都选择跳过5.配置hooks可以按需选择这里选择全部启用建议启用包含命令历史、记忆功能等选择对应的按【空格】键即可选中最后重启网关即可如果有问题就运行下面的诊断命令openclaw doctor --fixopenclaw logs --follow3.3.打开服务openclaw gateway start #开启网络访问 openclaw dashboard #打开前端显示http://127.0.0.1:18789/chat?sessionmain4.OpenClaw--使用4.1.连接微信npx -y tencent-weixin/openclaw-weixin-clilatest install扫码之后连接

更多文章