1. 部署思路与工具选型1.1 为什么选择 Windows 原生部署而不是 Docker 或 WSL我第一次接触 OpenClaw圈里人都叫它“小龙虾”时第一反应也是往 WSL 里塞。毕竟在 Linux 下跑这类 AI 代理框架文件权限、软链接、进程管理都比 Windows 原生态舒服得多。但实际折腾下来发现 Windows 原生部署反而更省心原因有三点。第一OpenClaw 的安装脚本本身就是跨平台的它对 Windows 有独立的适配分支不需要你手动补齐一堆 Linux 兼容层。你在 WSL 里跑反而要额外解决 Windows 和 Linux 文件系统互访的性能损耗以及端口转发、环境变量同步这些琐碎问题。第二Docker 也不是最优解。虽然容器化能隔离环境但 OpenClaw 在 Windows 上要做到“本地化操作”的能力会受限——比如读取 Windows 桌面的文件路径、调用宿主机的摄像头或麦克风——这些在容器里都得额外做设备映射配置量不小。第三也是最实际的一点OpenClaw 的日常场景是作为个人 AI 代理常驻后台。Windows 原生进程可以像普通软件一样开机自启、静默运行、随时唤起。而 WSL 里的进程你得开个终端挂着一关窗口就可能断这对“常驻工具”来说是灾难。所以我的建议很直接Windows 10 22H2 以上系统直接原生部署。除非你有服多开、严格隔离的硬需求否则不要给自己加戏。1.2 一键安装脚本的设计逻辑官方提供的一键安装脚本本质上是把三件事打包了环境检查、依赖安装、配置文件生成。你不需要懂 PowerShell 语法也能跑通但了解它的执行顺序能帮你快速定位问题。脚本执行的大致流程是检测系统架构x64 / arm64确认 Windows 版本是否满足要求检查 Python 是否安装版本是否不低于 3.10检查 Git 是否可用用于拉取更新自动创建 OpenClaw 的安装目录默认在用户目录下创建 Python 虚拟环境并激活通过 pip 安装核心依赖包括模型接口 SDK、系统控制模块等拉取默认配置模板并生成config.yaml运行一次自我检测验证组件是否完整看到这里你应该明白了所谓“一键”其实只是把原本手工要做的七八步操作合并成一个脚本。所以如果脚本在中途报错你要做的事情也是顺着这八步去查——哪一步断了就补哪一步。2. 部署前的环境准备2.1 三项硬性检查系统版本、Python 版本、网络条件先别急着跑安装脚本花五分钟做三项检查能帮你避开百分之六十的坑。先说系统版本。OpenClaw 官方要求 Windows 10 22H2 或 Windows 11内核版本不能太老。这是因为脚本里依赖了一些较新的系统 API老版本会直接触发兼容性警告。你可以按Win R输入winver查看当前版本号低于 22H2 的先去系统设置里更新。然后是 Python 版本。这一点我踩过坑——OpenClaw 用到了一些较新的语法特性和库Python 3.9 及以下会直接安装失败。建议装 Python 3.10 到 3.12 之间的版本太新比如 3.13反而可能遇到某些原生依赖还没发布对应 wheel 包的问题。去官网下载安装包时务必勾选“Add Python to PATH”这是安装脚本自动检测 Python 的前置条件。最后是网络条件。安装过程中需要访问 PyPI 仓库拉取依赖如果你的网络环境对国外站点访问不稳定建议提前换国内镜像源。在用户目录下创建pip.ini文件填入以下内容[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cn这一步不是必须的但能大幅缩短依赖安装时间尤其是碰到大体积的机器学习相关包时。2.2 可选的辅助工具Git 与终端环境虽然 OpenClaw 安装脚本会在检测到 Git 缺失时自动跳过拉取更新这一步但我仍然建议你手动装好 Git。原因很简单OpenClaw 的更新节奏非常快几乎每周都有新模型适配和 Bug 修复。没有 Git 的话你只能手动下载压缩包覆盖旧文件容易丢失配置文件有 Git 的话进入安装目录执行一条git pull就能完成升级。终端方面不要用系统自带的旧版 cmd 或 Windows PowerShell 5。请安装 Windows Terminal 并升级到 PowerShell 7。原因是 OpenClaw 的交互模式会输出大量彩色日志和动态进度条老终端渲染起来会出现字符错位严重的时候直接闪屏。Windows Terminal 配合 PowerShell 7渲染效率和兼容性都好很多。安装完这些之后还要处理一个 Windows 特有的毛病PowerShell 的执行策略。默认情况下系统禁止运行本地脚本直接跑安装脚本会报“禁止运行脚本”的错误。解决办法是用管理员身份打开 PowerShell执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser这个命令表示本地创建的脚本可以直接运行从网上下载的脚本需要有数字签名才能运行。既解决了安装脚本的执行限制又保留了基本的安全防护属于折中方案。3. 一键安装实操流程3.1 下载与启动安装脚本正式安装前先确认你的用户目录里没有中文路径。这是 Windows 上很多 Python 工具的隐性炸弹——某些原生库在处理含中文的路径时会直接崩溃而且报错信息毫无规律可言。我的建议是桌面、文档、下载这几个系统文件夹都有可能被软件自动迁移最好新建一个纯英文路径的目录比如D:\Tools\OpenClaw或者直接用默认的C:\Users\你的用户名拼音\OpenClaw。接着打开 PowerShell依次执行以下命令cd D:\Tools curl -O https://example.com/install_openclaw.ps1这个下载地址是我为说明方便虚构的实际请以项目仓库官网的指引为准。下载之后不要急着双击运行先右键点击install_openclaw.ps1选择“使用 PowerShell 运行”。脚本运行起来后你会看到类似下面这样的输出[OpenClaw] Detecting system architecture... [OpenClaw] Architecture: x64 [OpenClaw] Checking Windows version... [OpenClaw] Windows 10 22H2 detected, OK. [OpenClaw] Checking Python... [OpenClaw] Python 3.11.6 found, OK. [OpenClaw] Checking Git... [OpenClaw] Git 2.44.0 found, OK. [OpenClaw] Creating virtual environment...看到每一行后面都跟着OK说明你的环境准备过关了。如果哪一步显示MISSING或FAILED脚本通常会直接退出这时请你回到 2.1 节对照检查。3.2 依赖安装与首次启动虚拟环境创建完之后脚本会进入依赖安装阶段。这一步通常会持续三到五分钟取决于你的网络速度和机器性能。期间你会看到密密麻麻的包名滚过去不用紧张这是正常的。依赖装完后脚本会做两件事生成config.yaml默认配置并运行一次自检。自检会尝试加载所有核心模块如果你的硬件或系统缺少某些运行库比如 VC Redistributable这里有可能会报错。常见提示是DLL load failed这时候去微软官网装上最新的 Visual C 运行库就能解决。看一眼自检结果没问题就直接启动试试。OpenClaw 的启动命令是openclaw start第一次启动会提示是否输入模型 API 服务地址。这一步很多人犯迷糊OpenClaw 本身不直接依赖某个固定的模型而是通过 API 网关连接你选择的后端模型服务。你可以用本地模型服务比如某个开源模型也可以使用在线模型服务比如国内大模型平台的兼容服务。按提示输入服务的 Base URL 和 API Key 即可。如果你不想现在就配置也可以直接回车跳过等启动后手工编辑config.yaml修改。3.3 安装完成后的目录结构解读装完以后你应该能看到这样一个目录结构OpenClaw/ ├── bin/ │ └── openclaw.exe ├── data/ │ ├── sessions/ │ ├── logs/ │ └── memory/ ├── models/ │ └── cache/ ├── config.yaml ├── install.log └── README.md每个目录的作用我简单说一下方便你后续排查问题bin存放可执行文件openclaw.exe就是主程序入口data/logs存放运行日志排查问题第一优先看这里data/sessions记录每次对话会话的历史快照data/memory是 OpenClaw 的长期记忆存储区它会自动把重要信息整理成结构化文件保存这也是它区别于普通聊天机器人的核心能力models/cache是本地模型文件的缓存目录如果你用的是纯本地模型这里会明显变大config.yaml是所有功能的控制中枢几乎所有行为都在这里调记住这几个路径后面配置和查错都要用到。4. 配置与初始化让 OpenClaw 真正“可用”4.1 核心配置项逐行拆解OpenClaw 的config.yaml是 YAML 格式缩进敏感编辑时推荐用 VS Code千万别用系统自带的记事本。我第一次用记事本改Tab 和空格混在一起直接导致解析失败找了好久才发现是缩进问题。下面是一个典型的最小配置示例agent: name: my-agent language: zh-CN model: provider: openai-compatible base_url: https://api.example.com/v1 api_key: sk-xxxxxxxxxxxxxxxx default_model: qwen-plus temperature: 0.7 max_tokens: 4096 memory: enabled: true storage: local auto_compact: true permissions: allow_system_ops: false allow_network: true workspace: D:/Workspace/OpenClaw_Projects逐项解释一下我的理解model.provider填openai-compatible表示你用的是任意兼容 OpenAI 接口格式的服务这是目前最通用的连接方式几乎各家大模型服务都支持。base_url一定要填完整以/v1结尾否则请求会 404。temperature是温度系数控制输出随机性。日常对话填 0.7 比较合适写代码建议降到 0.2要实事求是而不是天马行空。memory.enabled建议保持开启。OpenClaw 的长期记忆能力是它区别普通问答工具的重要特性开启后它会自动总结之前的对话下次提到相关话题时能主动调用记忆。permissions.allow_system_ops默认保持false。这个开关控制 OpenClaw 能否直接执行系统级操作比如安装软件、修改注册表。激进用户会打开它追求全自动但我个人不建议新手这么做等完全摸清它的行为模式再放开不迟。4.2 首次对话与功能验证配置完成并重新执行openclaw start后你会进入一个交互式对话界面。输入/status可以查看当前系统状态包括模型连接是否正常、记忆存储是否可用、磁盘占用率等。先别急着让它干活花五分钟做三件事验证安装是否真正成功第一问它“你能调用哪些系统能力”如果它给出具体的能力列表比如读取文件、定时任务管理、执行脚本等说明核心模块加载正常。第二尝试让它读一个本地文件。比如在桌面放一个test.txt输入“请帮我读取桌面上 test.txt 的内容”。如果它能正确返回内容说明文件系统访问通道是通的。第三开启一个长时间对话连续问它十几个问题然后输入/memory查看它是否记录了关键信息。如果记忆列表里有内容恭喜你OpenClaw 的核心功能已经完整跑通了。5. 常见问题与排查技巧实录5.1 Windows 平台高发错误的根因与处理我在多台 Windows 机器上部署过 OpenClaw也看过不少群友的报错求助整理出五个最高频的问题和对应的排查思路问题现象根因解决方式安装脚本提示“禁止运行脚本”PowerShell 执行策略限制执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser依赖安装阶段网络超时默认源在国外访问不稳定配置清华镜像源见 2.1重试启动时报DLL load failed缺少 VC 运行库安装最新的 Visual C Redistributable输入中文乱码或光标错位老终端渲染问题用 Windows Terminal PowerShell 7配置文件改了但没生效缩进错误或未重启进程用 VS Code 检查缩进保存后执行openclaw restart这里特别说一个隐蔽的问题如果你发现 OpenClaw 的某些功能时好时坏先去data/logs底下翻最新的日志。Windows 系统在杀毒软件拦截时不会弹任何提示但 OpenClaw 会默默在日志里记一笔permission denied。如果是这种情况去杀毒软件里把 OpenClaw 的安装目录加入白名单。5.2 模型接入失败的三种典型场景模型接入失败是部署完成后最常遇到的问题。症状表现都是“对话无响应”或“提示 API 错误”但解决办法完全不同。第一种是 401 错误。这说明 API Key 没有通过认证。检查config.yaml里api_key有没有多余的空格以及环境变量里是否存在另一个同名的变量覆盖了配置。Windows 环境下我用一个简单的命令检查实际生效的配置openclaw env。第二种是 404 错误。通常是base_url拼错了。站点路径必须和模型服务官方文档完全一致末尾的/v1不能少协议也不能混用 http 和 https。哪怕是https://api.example.com和https://api.example.com/v1这种仅差一个路径的结果都天差地别。第三种是模型名报错。每个模型服务都有自己的一串模型标识符比如某个平台的语言模型和另一个平台的模型名称就不同。你要在配置里写服务商实际提供的模型 ID而不是随便填。有一个比较快的验证方法先用文档里给的 curl 示例测试请求是否能通如果 curl 能通而 OpenClaw 不行再去检查配置的格式。5.3 进程后台化与管理技巧Windows 下常驻进程的管理我摸索出一套相对顺手的方案。核心思路是注册为计划任务而不是直接开着窗口。打开“任务计划程序” 创建任务 → 触发器登录时 → 操作启动 D:\Tools\OpenClaw\bin\openclaw.exe 加参数 start --daemon 条件取消勾选“只有在计算机使用交流电源时才启动此任务”这样配置之后每次登录 WindowsOpenClaw 会以隐藏后台任务的方式自动启动不会弹黑窗口也不会因为你关了终端就退出。需要停止服务时执行openclaw stop需要看状态时执行openclaw status。查看运行日志也有小技巧。手动启动时日志直接打在终端里但后台模式会把日志写入data/logs目录。我习惯用下面的命令实时跟踪新日志Get-Content D:\Tools\OpenClaw\data\logs\openclaw.log -Wait -Tail 50看到这里你应该已经能完整地把 OpenClaw 跑起来了。最后提一句我在实际使用中的体会OpenClaw 这类本地 AI 代理最忌讳的就是一开始就让权限全开。先花一个星期用对话方式摸索它能做什么、做事边界在哪里再逐步放开文件访问和系统操作权限这样既保护了电脑也能让你真正理解它的工作逻辑。 
长河君 · 2026/10/22 21:14:12 · 阅读 1.2k Windows原生部署OpenClaw：环境准备与配置实战
1. 部署思路与工具选型1.1 为什么选择 Windows 原生部署而不是 Docker 或 WSL我第一次接触 OpenClaw圈里人都叫它“小龙虾”时第一反应也是往 WSL 里塞。毕竟在 Linux 下跑这类 AI 代理框架文件权限、软链接、进程管理都比 Windows 原生态舒服得多。但实际折腾下来发现 Windows 原生部署反而更省心原因有三点。第一OpenClaw 的安装脚本本身就是跨平台的它对 Windows 有独立的适配分支不需要你手动补齐一堆 Linux 兼容层。你在 WSL 里跑反而要额外解决 Windows 和 Linux 文件系统互访的性能损耗以及端口转发、环境变量同步这些琐碎问题。第二Docker 也不是最优解。虽然容器化能隔离环境但 OpenClaw 在 Windows 上要做到“本地化操作”的能力会受限——比如读取 Windows 桌面的文件路径、调用宿主机的摄像头或麦克风——这些在容器里都得额外做设备映射配置量不小。第三也是最实际的一点OpenClaw 的日常场景是作为个人 AI 代理常驻后台。Windows 原生进程可以像普通软件一样开机自启、静默运行、随时唤起。而 WSL 里的进程你得开个终端挂着一关窗口就可能断这对“常驻工具”来说是灾难。所以我的建议很直接Windows 10 22H2 以上系统直接原生部署。除非你有服多开、严格隔离的硬需求否则不要给自己加戏。1.2 一键安装脚本的设计逻辑官方提供的一键安装脚本本质上是把三件事打包了环境检查、依赖安装、配置文件生成。你不需要懂 PowerShell 语法也能跑通但了解它的执行顺序能帮你快速定位问题。脚本执行的大致流程是检测系统架构x64 / arm64确认 Windows 版本是否满足要求检查 Python 是否安装版本是否不低于 3.10检查 Git 是否可用用于拉取更新自动创建 OpenClaw 的安装目录默认在用户目录下创建 Python 虚拟环境并激活通过 pip 安装核心依赖包括模型接口 SDK、系统控制模块等拉取默认配置模板并生成config.yaml运行一次自我检测验证组件是否完整看到这里你应该明白了所谓“一键”其实只是把原本手工要做的七八步操作合并成一个脚本。所以如果脚本在中途报错你要做的事情也是顺着这八步去查——哪一步断了就补哪一步。2. 部署前的环境准备2.1 三项硬性检查系统版本、Python 版本、网络条件先别急着跑安装脚本花五分钟做三项检查能帮你避开百分之六十的坑。先说系统版本。OpenClaw 官方要求 Windows 10 22H2 或 Windows 11内核版本不能太老。这是因为脚本里依赖了一些较新的系统 API老版本会直接触发兼容性警告。你可以按Win R输入winver查看当前版本号低于 22H2 的先去系统设置里更新。然后是 Python 版本。这一点我踩过坑——OpenClaw 用到了一些较新的语法特性和库Python 3.9 及以下会直接安装失败。建议装 Python 3.10 到 3.12 之间的版本太新比如 3.13反而可能遇到某些原生依赖还没发布对应 wheel 包的问题。去官网下载安装包时务必勾选“Add Python to PATH”这是安装脚本自动检测 Python 的前置条件。最后是网络条件。安装过程中需要访问 PyPI 仓库拉取依赖如果你的网络环境对国外站点访问不稳定建议提前换国内镜像源。在用户目录下创建pip.ini文件填入以下内容[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cn这一步不是必须的但能大幅缩短依赖安装时间尤其是碰到大体积的机器学习相关包时。2.2 可选的辅助工具Git 与终端环境虽然 OpenClaw 安装脚本会在检测到 Git 缺失时自动跳过拉取更新这一步但我仍然建议你手动装好 Git。原因很简单OpenClaw 的更新节奏非常快几乎每周都有新模型适配和 Bug 修复。没有 Git 的话你只能手动下载压缩包覆盖旧文件容易丢失配置文件有 Git 的话进入安装目录执行一条git pull就能完成升级。终端方面不要用系统自带的旧版 cmd 或 Windows PowerShell 5。请安装 Windows Terminal 并升级到 PowerShell 7。原因是 OpenClaw 的交互模式会输出大量彩色日志和动态进度条老终端渲染起来会出现字符错位严重的时候直接闪屏。Windows Terminal 配合 PowerShell 7渲染效率和兼容性都好很多。安装完这些之后还要处理一个 Windows 特有的毛病PowerShell 的执行策略。默认情况下系统禁止运行本地脚本直接跑安装脚本会报“禁止运行脚本”的错误。解决办法是用管理员身份打开 PowerShell执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser这个命令表示本地创建的脚本可以直接运行从网上下载的脚本需要有数字签名才能运行。既解决了安装脚本的执行限制又保留了基本的安全防护属于折中方案。3. 一键安装实操流程3.1 下载与启动安装脚本正式安装前先确认你的用户目录里没有中文路径。这是 Windows 上很多 Python 工具的隐性炸弹——某些原生库在处理含中文的路径时会直接崩溃而且报错信息毫无规律可言。我的建议是桌面、文档、下载这几个系统文件夹都有可能被软件自动迁移最好新建一个纯英文路径的目录比如D:\Tools\OpenClaw或者直接用默认的C:\Users\你的用户名拼音\OpenClaw。接着打开 PowerShell依次执行以下命令cd D:\Tools curl -O https://example.com/install_openclaw.ps1这个下载地址是我为说明方便虚构的实际请以项目仓库官网的指引为准。下载之后不要急着双击运行先右键点击install_openclaw.ps1选择“使用 PowerShell 运行”。脚本运行起来后你会看到类似下面这样的输出[OpenClaw] Detecting system architecture... [OpenClaw] Architecture: x64 [OpenClaw] Checking Windows version... [OpenClaw] Windows 10 22H2 detected, OK. [OpenClaw] Checking Python... [OpenClaw] Python 3.11.6 found, OK. [OpenClaw] Checking Git... [OpenClaw] Git 2.44.0 found, OK. [OpenClaw] Creating virtual environment...看到每一行后面都跟着OK说明你的环境准备过关了。如果哪一步显示MISSING或FAILED脚本通常会直接退出这时请你回到 2.1 节对照检查。3.2 依赖安装与首次启动虚拟环境创建完之后脚本会进入依赖安装阶段。这一步通常会持续三到五分钟取决于你的网络速度和机器性能。期间你会看到密密麻麻的包名滚过去不用紧张这是正常的。依赖装完后脚本会做两件事生成config.yaml默认配置并运行一次自检。自检会尝试加载所有核心模块如果你的硬件或系统缺少某些运行库比如 VC Redistributable这里有可能会报错。常见提示是DLL load failed这时候去微软官网装上最新的 Visual C 运行库就能解决。看一眼自检结果没问题就直接启动试试。OpenClaw 的启动命令是openclaw start第一次启动会提示是否输入模型 API 服务地址。这一步很多人犯迷糊OpenClaw 本身不直接依赖某个固定的模型而是通过 API 网关连接你选择的后端模型服务。你可以用本地模型服务比如某个开源模型也可以使用在线模型服务比如国内大模型平台的兼容服务。按提示输入服务的 Base URL 和 API Key 即可。如果你不想现在就配置也可以直接回车跳过等启动后手工编辑config.yaml修改。3.3 安装完成后的目录结构解读装完以后你应该能看到这样一个目录结构OpenClaw/ ├── bin/ │ └── openclaw.exe ├── data/ │ ├── sessions/ │ ├── logs/ │ └── memory/ ├── models/ │ └── cache/ ├── config.yaml ├── install.log └── README.md每个目录的作用我简单说一下方便你后续排查问题bin存放可执行文件openclaw.exe就是主程序入口data/logs存放运行日志排查问题第一优先看这里data/sessions记录每次对话会话的历史快照data/memory是 OpenClaw 的长期记忆存储区它会自动把重要信息整理成结构化文件保存这也是它区别于普通聊天机器人的核心能力models/cache是本地模型文件的缓存目录如果你用的是纯本地模型这里会明显变大config.yaml是所有功能的控制中枢几乎所有行为都在这里调记住这几个路径后面配置和查错都要用到。4. 配置与初始化让 OpenClaw 真正“可用”4.1 核心配置项逐行拆解OpenClaw 的config.yaml是 YAML 格式缩进敏感编辑时推荐用 VS Code千万别用系统自带的记事本。我第一次用记事本改Tab 和空格混在一起直接导致解析失败找了好久才发现是缩进问题。下面是一个典型的最小配置示例agent: name: my-agent language: zh-CN model: provider: openai-compatible base_url: https://api.example.com/v1 api_key: sk-xxxxxxxxxxxxxxxx default_model: qwen-plus temperature: 0.7 max_tokens: 4096 memory: enabled: true storage: local auto_compact: true permissions: allow_system_ops: false allow_network: true workspace: D:/Workspace/OpenClaw_Projects逐项解释一下我的理解model.provider填openai-compatible表示你用的是任意兼容 OpenAI 接口格式的服务这是目前最通用的连接方式几乎各家大模型服务都支持。base_url一定要填完整以/v1结尾否则请求会 404。temperature是温度系数控制输出随机性。日常对话填 0.7 比较合适写代码建议降到 0.2要实事求是而不是天马行空。memory.enabled建议保持开启。OpenClaw 的长期记忆能力是它区别普通问答工具的重要特性开启后它会自动总结之前的对话下次提到相关话题时能主动调用记忆。permissions.allow_system_ops默认保持false。这个开关控制 OpenClaw 能否直接执行系统级操作比如安装软件、修改注册表。激进用户会打开它追求全自动但我个人不建议新手这么做等完全摸清它的行为模式再放开不迟。4.2 首次对话与功能验证配置完成并重新执行openclaw start后你会进入一个交互式对话界面。输入/status可以查看当前系统状态包括模型连接是否正常、记忆存储是否可用、磁盘占用率等。先别急着让它干活花五分钟做三件事验证安装是否真正成功第一问它“你能调用哪些系统能力”如果它给出具体的能力列表比如读取文件、定时任务管理、执行脚本等说明核心模块加载正常。第二尝试让它读一个本地文件。比如在桌面放一个test.txt输入“请帮我读取桌面上 test.txt 的内容”。如果它能正确返回内容说明文件系统访问通道是通的。第三开启一个长时间对话连续问它十几个问题然后输入/memory查看它是否记录了关键信息。如果记忆列表里有内容恭喜你OpenClaw 的核心功能已经完整跑通了。5. 常见问题与排查技巧实录5.1 Windows 平台高发错误的根因与处理我在多台 Windows 机器上部署过 OpenClaw也看过不少群友的报错求助整理出五个最高频的问题和对应的排查思路问题现象根因解决方式安装脚本提示“禁止运行脚本”PowerShell 执行策略限制执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser依赖安装阶段网络超时默认源在国外访问不稳定配置清华镜像源见 2.1重试启动时报DLL load failed缺少 VC 运行库安装最新的 Visual C Redistributable输入中文乱码或光标错位老终端渲染问题用 Windows Terminal PowerShell 7配置文件改了但没生效缩进错误或未重启进程用 VS Code 检查缩进保存后执行openclaw restart这里特别说一个隐蔽的问题如果你发现 OpenClaw 的某些功能时好时坏先去data/logs底下翻最新的日志。Windows 系统在杀毒软件拦截时不会弹任何提示但 OpenClaw 会默默在日志里记一笔permission denied。如果是这种情况去杀毒软件里把 OpenClaw 的安装目录加入白名单。5.2 模型接入失败的三种典型场景模型接入失败是部署完成后最常遇到的问题。症状表现都是“对话无响应”或“提示 API 错误”但解决办法完全不同。第一种是 401 错误。这说明 API Key 没有通过认证。检查config.yaml里api_key有没有多余的空格以及环境变量里是否存在另一个同名的变量覆盖了配置。Windows 环境下我用一个简单的命令检查实际生效的配置openclaw env。第二种是 404 错误。通常是base_url拼错了。站点路径必须和模型服务官方文档完全一致末尾的/v1不能少协议也不能混用 http 和 https。哪怕是https://api.example.com和https://api.example.com/v1这种仅差一个路径的结果都天差地别。第三种是模型名报错。每个模型服务都有自己的一串模型标识符比如某个平台的语言模型和另一个平台的模型名称就不同。你要在配置里写服务商实际提供的模型 ID而不是随便填。有一个比较快的验证方法先用文档里给的 curl 示例测试请求是否能通如果 curl 能通而 OpenClaw 不行再去检查配置的格式。5.3 进程后台化与管理技巧Windows 下常驻进程的管理我摸索出一套相对顺手的方案。核心思路是注册为计划任务而不是直接开着窗口。打开“任务计划程序” 创建任务 → 触发器登录时 → 操作启动 D:\Tools\OpenClaw\bin\openclaw.exe 加参数 start --daemon 条件取消勾选“只有在计算机使用交流电源时才启动此任务”这样配置之后每次登录 WindowsOpenClaw 会以隐藏后台任务的方式自动启动不会弹黑窗口也不会因为你关了终端就退出。需要停止服务时执行openclaw stop需要看状态时执行openclaw status。查看运行日志也有小技巧。手动启动时日志直接打在终端里但后台模式会把日志写入data/logs目录。我习惯用下面的命令实时跟踪新日志Get-Content D:\Tools\OpenClaw\data\logs\openclaw.log -Wait -Tail 50看到这里你应该已经能完整地把 OpenClaw 跑起来了。最后提一句我在实际使用中的体会OpenClaw 这类本地 AI 代理最忌讳的就是一开始就让权限全开。先花一个星期用对话方式摸索它能做什么、做事边界在哪里再逐步放开文件访问和系统操作权限这样既保护了电脑也能让你真正理解它的工作逻辑。