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

OpenClaw(大龙虾)在 WSL + WSL 内 Docker 的安装到可用全流程(通俗版)svg xmlns http www w3 org 2000 svg style display none svg

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



 
  
    
     
      
     

适用场景: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):

 
        

它会输出类似:

你把这整段 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 再次启动

 
           

小讯
上一篇 2026-03-31 09:10
下一篇 2026-03-31 09:08

相关推荐

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