OpenClaw(大龙虾)在 WSL + WSL 内 Docker 的安装到可用全流程(通俗版)

OpenClaw(大龙虾)在 WSL + WSL 内 Docker 的安装到可用全流程(通俗版)

适用场景:Windows 电脑 + WSL(Ubuntu)+ WSL 内已安装 Docker,OpenClaw 用 Docker Compose 方式运行。


  • 一个本机可访问的管理界面(Control UI / Dashboard)
  • 一个在 WSL 里长期运行的 OpenClaw Gateway(Docker 容器)
  • 你在网页里聊天时,OpenClaw 会通过你配置的模型(例如 Anthropic/OpenAI)返回回答

进入 WSL(Ubuntu)终端后,确认 Docker / Compose 可用:


看到版本号就说明 OK。


在 WSL 里执行(root 用户):


(如果已存在仓库,则用 更新即可)


在 WSL 里(仍在 )执行:


它会做几件事(你看到输出属正常):

  • 拉取镜像(或确认镜像已是最新)
  • 生成并保存 gateway token(用于网页登录)
  • 启动 gateway 容器
  • 初始化配置目录与 workspace

在 WSL 里进入目录:


4.1 看容器是否在跑


期望看到:

  • 状态是 (最好是 healthy)

4.2 看网关健康接口


期望看到 。

4.3 运行自检


说明:

  • doctor 可能会提示一些“建议项”(例如权限 chmod 700、bind=lan 风险提醒),不一定是致命错误。
  • 真正致命的通常是:缺 API Key、或网关没起来。

5.1 推荐打开方式

用 CLI 打印 Dashboard URL(避免你手动找 token):


它会输出类似openclaw 龙虾:

你把这整段 URL 复制到 Windows 的 Chrome/Edge 地址栏打开。

5.2 如果你遇到 “pairing required” 或 token 丢失

表现:

  • 页面提示
  • 网关日志出现
  • 你打开带 的链接后,页面跳转到 ,token 不见了

处理方法(WSL 里执行):

1)列出待批准设备:


2)批准请求(把 换成 list 里的 ID):


之后再重新打开 Dashboard URL。


你现在需要的是:让 OpenClaw 能调用模型(否则聊天会提示缺 / key)。

6.1 方式A:命令行交互式配置(推荐)


按提示选择你要用的提供商(例如 Anthropic),填入 API Key,保存即可。

6.2 配完后如何确认 Key 生效

再次跑 doctor:


期望:

  • 不再提示 “No API key found for provider …”
  • 或至少你选择的那家(例如 Anthropic)不再缺 key

回到网页(Control UI)→ 左侧 聊天 → 输入一句话,比如:

如果能正常回复,就说明:

  • 网关 OK
  • token OK
  • pairing OK
  • 模型 key OK

在 WSL 中 下:

8.1 查看网关日志


8.2 重启网关


8.3 停止服务


8.4 再次启动


版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/261367.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月12日 下午11:33
下一篇 2026年3月12日 下午11:34


相关推荐

关注全栈程序员社区公众号