从零折腾 OpenClaw 本地部署：一个普通开发者的踩坑实录与实战心得

科技前沿 • 2026-03-20 09:09 • 阅读 0

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

从零折腾 OpenClaw 本地部署：一个普通开发者的踩坑实录与实战心得_Windows

nvm install 22 nvm use 22 node -v # 确认输出 v22.x.x

国内网络环境下，直接 npm install 大概率会卡住或者速度感人。建议先切换淘宝镜像源：

GPT plus 代充 只需 145npm config set registry https://registry.npmmirror.com

npm install -g @qingchencloud/openclaw-zh@latest

安装过程大概两三分钟，看到 added xxx packages 就算成功了。

从零折腾 OpenClaw 本地部署：一个普通开发者的踩坑实录与实战心得_App_02

GPT plus 代充 只需 145openclaw onboard –install-daemon

从零折腾 OpenClaw 本地部署：一个普通开发者的踩坑实录与实战心得_API_03

从零折腾 OpenClaw 本地部署：一个普通开发者的踩坑实录与实战心得_App_04

OpenClaw 支持多种大模型后端：Anthropic Claude、OpenAI GPT、阿里通义千问、本地 Ollama 等。我选了通义千问的 qwen3-coder-plus，原因很简单——国内访问稳定，而且阿里百炼平台新用户有免费额度。

从零折腾 OpenClaw 本地部署：一个普通开发者的踩坑实录与实战心得_Windows_05

https://coding.dashscope.aliyuncs.com/v1

从零折腾 OpenClaw 本地部署：一个普通开发者的踩坑实录与实战心得_Windows_06

从零折腾 OpenClaw 本地部署：一个普通开发者的踩坑实录与实战心得_Windows_07

GPT plus 代充 只需 145openclaw gateway start

看到类似 Gateway is running on http://localhost:18789 的输出，说明核心服务已经跑起来了。

浏览器打开 http://127.0.0.1:18789 就能看到控制面板，在这里可以直接和 Agent 对话，也可以查看运行状态。下面是 Agent UI 的界面效果：

从零折腾 OpenClaw 本地部署：一个普通开发者的踩坑实录与实战心得_Windows_08

在 WSL2 下执行 npm install -g openclaw 直接报了 EACCES 权限错误。第一反应是加 sudo，但这会导致后续所有全局包的权限都变成 root，埋下更多隐患。

mkdir /.npm-global npm config set prefix ‘/.npm-global’ echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.bashrc source ~/.bashrc

第一次启动 Gateway，日志一闪而过，进程直接退出。用 openclaw gateway start –foreground 跑前台模式才看到报错：缺少必填的环境变量。

OpenClaw 的 .env 文件至少需要配置一个模型的 API Key。如果你用 Docker 部署，还需要设置 GITHUB_TOKEN。我当时漏配了模型的 Key，改好之后一切正常。

建议：安装完第一件事，运行 openclaw doctor，它会自动检测配置问题并给出修复建议，据说能解决 80% 的常见问题。

有一次我让 OpenClaw 帮我重构一个项目的某个模块，结果它把整个 node_modules 目录都读了一遍，上下文直接爆了，任务卡死。

解决方案：在项目根目录创建 .clawignore 文件，语法和 .gitignore 一样：

GPT plus 代充 只需 145node_modules/ dist/ .next/ *.log

# config.yaml gateway: bind: “loopback” auth: “token”

从零折腾 OpenClaw 本地部署：一个普通开发者的踩坑实录与实战心得_App_09