跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw:实现 AI 直接操控电脑的本地部署指南

OpenClaw 是一款能够直接操作 Windows 或 Linux 系统的 AI 智能体。不同于传统聊天机器人,它具备执行文件管理、代码编写及环境部署等实际任务的能力。梳理了基于 Node.js 的本地部署流程,涵盖原生安装与 WSL2 两种方案,并提供了常见问题的排查思路及开源替代方案参考。

GitMaster发布于 2026/4/5更新于 2026/6/1226 浏览

OpenClaw:实现 AI 直接操控电脑的本地部署指南

什么是 OpenClaw

OpenClaw 是一个能够直接操作 Windows 或 Linux 系统的 AI 智能体。与传统聊天机器人不同,它不仅限于对话,还能执行文件管理、代码编写、环境部署及模拟鼠标键盘等操作。你可以把它理解为一个坐在你电脑前帮你干活的数字员工。

核心能力

  • 开发与调试:自动新建文件、编写代码、保存并运行程序。
  • 文件管理:按规则整理桌面文件、重命名、移动目录。
  • 自动化任务:批量处理图片、下载工具、配置环境。
  • 系统交互:打开浏览器、填写表单、查询资料。

前置准备

运行 OpenClaw 需要满足以下基础条件:

  1. Node.js 环境:版本需为 22 及以上。
  2. API Key:支持接入 DeepSeek、OpenAI、Claude 等主流模型服务。

验证 Node.js 版本是否达标:

node -v
# 应显示 v22.x.x 或更高

部署方案

方案一:Windows 原生安装(推荐新手)

以管理员身份打开 PowerShell,执行官方安装脚本。该过程会自动完成依赖检查与环境初始化。

iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后,运行初始化命令引导配置:

openclaw onboard --install-daemon

按提示选择模型服务商并填入 API Key。若不需要开机自启,输入 n 即可。启动成功后,浏览器将自动跳转至本地控制台:

text
http://localhost:18789
方案二:WSL2 容器运行(兼容最佳)

若原生环境存在依赖冲突,建议使用 WSL2 部署。

  1. 启用 WSL2:在管理员 PowerShell 中执行以下命令并重启电脑。
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --set-default-version 2
  1. 安装 Ubuntu 与 Node.js: 在 Microsoft Store 安装 Ubuntu 22.04 LTS 或 24.04 LTS。进入终端后更新系统并安装 Node.js 22:
sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
  1. 部署应用:
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

服务启动后,同样访问 http://localhost:18789 进行交互。

常用指令与配置

  • 切换模型:在 UI 设置中选择「模型」,更新 API Key 或地址。
  • 本地模型:若使用 Ollama 等本地推理服务,需在引导时填入地址(如 http://localhost:11434)。
  • 服务管理:
openclaw daemon stop    # 停止服务
openclaw daemon start   # 启动服务
openclaw daemon status  # 查看状态
  • 端口修改:如遇端口冲突,可指定其他端口启动:
openclaw gateway --port 18790 --verbose

常见问题排查

  • 网页无法打开:尝试重启 openclaw 服务。
  • 无响应:检查 API Key 有效性及网络连通性。
  • 权限不足:确保以管理员身份运行 PowerShell 或终端。
  • WSL2 网络异常:重置网络栈。
wsl --shutdown
netsh winsock reset
netsh int ip reset
  • 依赖安装失败:尝试使用 pnpm 重新安装全局包。
npm install -g pnpm
pnpm add -g openclaw@latest

开源替代方案

若需更轻量或隐私导向的选择,以下项目可供参考:

  • NanoBot:架构极简,资源占用低,适合对系统开销敏感的场景。
  • ZeroClaw:Rust 编写,单二进制部署,内存占用极低,安全性较高。
  • IronClaw:侧重隐私安全,采用 WASM + Docker 沙箱隔离。
  • Kai:专为 Claude 工具链设计,适合深度代码协作场景。

注:涉及本地系统操作,请谨慎授予权限,注意数据备份。

目录

  1. OpenClaw:实现 AI 直接操控电脑的本地部署指南
  2. 什么是 OpenClaw
  3. 核心能力
  4. 前置准备
  5. 应显示 v22.x.x 或更高
  6. 部署方案
  7. 方案一:Windows 原生安装(推荐新手)
  8. 方案二:WSL2 容器运行(兼容最佳)
  9. 常用指令与配置
  10. 常见问题排查
  11. 开源替代方案
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 37 个 Python Web 开发框架整理与选型指南
  • 配置 OpenClaw 机器人集成钉钉与 OpenMetadata
  • 前端微前端架构:大型项目是解药还是新坑?
  • 前端SSE(Server-Sent Events)实现详解:从原理到前端AI对话应用
  • Qwen3 与 Qwen Agent 智能体开发实战:接入 MCP 工具
  • XGBoost 机器学习实战指南:从安装到模型调优
  • Android 工程师面试指南:核心知识点梳理与备考策略
  • Maven Profile 资源插件配置不生效的解决方法
  • 学生如何申请并使用 GitHub Copilot
  • LLaMA-Factory DeepSeek-R1 模型微调基础教程
  • Linux 系统权限详解:用户、文件与目录管理
  • Python 的十大核心特性详解
  • 无人机低空智能巡飞巡检平台:全域感知与智能决策
  • Linux 是什么?
  • Web 应用架构与安全漏洞体系梳理
  • Python 基础语法陷阱与底层原理深度解析
  • OpenClaw 本地优先 AI 智能体:从安装到实战部署指南
  • Rust与WebAssembly深度实战:浏览器与Node.js 高性能应用
  • 前端国际化实战:i18n 选型、架构设计与 RTL 布局避坑
  • LLM 本地知识库构建:文档分割与向量化方案探讨

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online