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