一、AI智能体框架OpenClaw部署(openclaw.ai)

OpenClaw是一款完全开源、本地优先的AI智能体执行网关,它不仅能对话,还能直接操控电脑执行任务(管理文件、编写代码、浏览网页、发送邮件等),所有数据完全存储在本地设备上。

系统要求

  • 操作系统:Windows 10 21H2+ 或 Windows 11
  • 内存:最低2GB,推荐4GB以上
  • 存储:约500MB可用空间
  • 网络:互联网连接(用于AI API调用,本地模型可离线运行)
  • 依赖:Node.js 22.0.0+(LTS版本推荐)

方案一:一键脚本部署(新手首选,5分钟完成)

这是官方推荐的最简单方法,自动检测并安装所有依赖。

  1. 以管理员身份打开PowerShell

    • 开始菜单搜索"PowerShell"
    • 右键点击"Windows PowerShell"
    • 选择"以管理员身份运行"
  2. 允许脚本执行
    Windows默认禁止运行远程脚本,需要先授权:

    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
    

    当系统提示确认时,输入Y并按回车。

  3. 执行官方安装脚本

    # 官方脚本(推荐)
    iwr -useb https://openclaw.ai/install.ps1 | iex
    
    # 国内网络超时可使用中国社区镜像
    # iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
    

    等待2-5分钟,出现"OpenClaw installed successfully"即为安装完成。

  4. 验证安装
    关闭所有PowerShell窗口,重新打开一个新的PowerShell窗口:

    openclaw --version
    

    如果显示版本号,说明安装成功。

方案二:WSL2部署(官方推荐,稳定性最佳)

官方明确表示原生Windows安装虽然可用,但稳定性较差,强烈推荐使用WSL2环境部署OpenClaw。

  1. 安装WSL2和Ubuntu
    以管理员身份打开PowerShell:

    wsl --install
    

    安装完成后重启电脑,系统会自动创建Ubuntu用户账户。

  2. 在WSL2中启用systemd
    打开Ubuntu终端,编辑wsl.conf文件:

    sudo nano /etc/wsl.conf
    

    添加以下内容:

    [boot]
    systemd=true
    

    保存退出(Ctrl+O,回车,Ctrl+X),然后关闭WSL:

    wsl --shutdown
    

    重新打开Ubuntu终端。

  3. 在WSL2中安装OpenClaw

    curl -fsSL https://openclaw.ai/install.sh | bash
    

    安装完成后,重新加载环境变量:

    source ~/.bashrc
    
  4. 验证安装

    openclaw --version
    

方案三:Docker容器化部署(生产/隔离环境首选)

Docker部署提供了最佳的隔离性和可移植性,适合需要长期稳定运行的场景。

  1. 安装Docker Desktop
    Docker官网下载并安装Windows版Docker Desktop。安装时确保勾选"Use the WSL 2 based engine"选项。

  2. 启动Docker Desktop
    等待Docker状态显示为"Running"。

  3. 运行OpenClaw容器
    打开PowerShell:

    docker run -d --name openclaw -p 18789:18789 --restart unless-stopped openclaw/openclaw:latest
    

    --restart unless-stopped参数确保容器在系统重启或崩溃后自动启动。

  4. 验证容器运行状态

    docker ps
    

    你应该看到openclaw容器状态为"Up"。

初始化配置与启动

无论使用哪种部署方式,都需要完成以下初始化步骤:

  1. 运行新手引导

    openclaw onboard --flow quickstart
    

    按照向导提示完成:

    • 选择AI模型提供商(支持Claude、OpenAI、DeepSeek、Kimi等)
    • 输入对应的API密钥
    • 配置聊天通道(推荐Telegram,配置最简单)
  2. 启动OpenClaw服务

    openclaw start
    
  3. 安装为系统服务(可选)
    让OpenClaw在系统启动时自动运行:

    openclaw gateway install
    
  4. 访问Web管理界面
    打开浏览器访问:http://localhost:18789
    在这里你可以查看日志、管理技能、配置更多通道。

常见问题排查

问题现象 可能原因 解决方案
openclaw: command not found 环境变量未生效 关闭所有PowerShell窗口后重新打开,或重启电脑
ExecutionPolicy报错 脚本执行权限不足 重新执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
node-gyp编译失败 缺少C++编译工具 下载安装Microsoft Visual Studio Build Tools,勾选"使用C++的桌面开发"工作负载
防火墙拦截 Windows Defender阻止网络访问 在Windows防火墙中允许OpenClaw相关进程通过
WSL2下服务无法访问 跨网络问题 确保WSL2和Windows在同一网络,使用localhost:18789访问
Logo

这里是“一人公司”的成长家园。我们提供从产品曝光、技术变现到法律财税的全栈内容,并连接云服务、办公空间等稀缺资源,助你专注创造,无忧运营。

更多推荐