OpenClaw安装配置及使用问题记录

本文档提供了OpenClaw平台的安装配置和使用指南。主要内容包括：1) Ubuntu和Windows系统的安装说明；2) 大模型配置方法（UI界面和命令行两种方式）；3) 系统启动流程和常用命令；4) 网关运维管理命令；5) WSL中Ubuntu的特殊配置；6) Web UI界面功能说明；7) 常见问题解决方法。文档详细介绍了OpenClaw的安装部署、模型配置、服务管理等核心操作，并针对不同系

SP八岐大兔

279人浏览 · 2026-03-20 10:50:00

SP八岐大兔 · 2026-03-20 10:50:00 发布

OpenClaw

安装参考

注：安装时可以跳过的都跳过(Skip xxx)
Ubuntu：https://docs.openclaw.ai/zh-CN/start/getting-started
Windows：https://scn93qi3owua.feishu.cn/docx/Aomxd0vcloAMRQxKw2Jcp8mNnfc

快速安装选项说明

Model/auth provider：模型提供商授权配置

配置ollama注意事项

一定一定一定关闭360，不然会导致websockt频繁掉线重连，导致推理结果无法返回。

配置文件

Windows：C:\Users\你\.openclaw\openclaw.json
Linux：~/.openclaw/openclaw.json

Window也可直接在文件夹地址栏输入：%USERPROFILE%\.openclaw

大模型配置

Ubuntu：https://docs.openclaw.ai/zh-CN/providers
Windows：https://docs.openclaw.ai/zh-CN/start/getting-started

WebUI中配置模型：
方法1：UI配置，英文，AI与代理-Models-Model Provider Model List - Add，只需要填写Id、Input、Name、Resoning几个参数即可。
方法2：参考官方中文文档https://docs.openclaw.ai/zh-CN/providers中对应的模型提供商的案例使用命令行添加或修改。

启动流程

1、启动网关（服务）
openclaw gateway start
2、启动WebUI(UI界面，获取访问链接)
openclaw dashboard
3、打开配置向导
openclaw onboard

修复服务忽然启动不起来

# 1. 先卸载损坏的服务（如果存在）
openclaw gateway uninstall

# 2. 重新安装Gateway服务
openclaw gateway install

# 3. 启动服务并验证状态
openclaw gateway start
openclaw gateway status

运维命令

启动Web控制面板(默认端口)
openclaw dashboard

指定端口启动控制面板
openclaw dashboard --port 8080

# * 一键修复（自动改好所有问题）
openclaw doctor --fix 

# *体检（只读）
openclaw doctor 

# 给指定agent ''main' 发消息
openclaw agent --agent main --message "Summarize logs"
更多手机、渠道等发消息命令参考官方文档的agent send。

# 查看已配置模型：
openclaw models list

# 启动OpenClaw网关服务
openclaw gateway start

# 停止OpenClaw网关服务
openclaw gateway stop

# 重启OpenClaw网关服务
openclaw gateway restart

# 查看网关当前运行状态
openclaw gateway status

# 查看实时日志（启动/停止过程中的输出）
openclaw gateway logs

# 查看完整配置文件
cat ~/.openclaw/openclaw.json

# 仅查看网关相关配置
grep -A 20 "gateway" ~/.openclaw/openclaw.json

源码安装系统更新

# 查看当前OpenClaw的版本
openclaw --version

# 更新到最新版本
npm update -g openclaw

# 重启Gateway服务
openclaw gateway restart

WSL中Ubuntu网关参数修改(老版本的BUG，如果上述已经可以允许了请忽略后续操作)

前因：WSL中安装的Ubuntu需要在主机浏览器来访问，需要修改ubuntu上Openclaw的两个参数，即gateway.bind和gateway.controlUi.allowedOrigins。
gateway.bind现在支持以下几种绑定模式：

模式	说明	适用场景
loopback	只允许WSL Ubuntu内部访问（默认值）	本地使用
lan	允许局域网内所有设备访问	同一局域网内的设备访问
custom	允许自定义IP地址访问	需要指定特定IP地址的场景
tailnet	允许Tailscale网络内的设备访问	使用Tailscale的远程访问场景
auto	自动选择合适的绑定模式	不确定使用哪种模式的场景

修改访问规则（gateway.bind）：
1、修改Gateway的bind参数为lan模式
openclaw config set gateway.bind lan
2、查看修改后的配置
openclaw config get gateway.bind
3、重启Gateway服务
openclaw gateway restart

修改允许访问的IP(gateway.controlUi.allowedOrigins),感觉像是配置ununtu允许被访问的IP，这样就不用ssh链接了：
1、查看原有的配置
openclaw config get gateway.controlUi.allowedOrigins
2、查看wsl中ubuntu的IP地址,ubuntu中执行
ip addr show eth0 | grep inet | awk '{print $2}' | cut -d/ -f1  
3、在原有基础上追加wsl中ubuntu的访问地址
openclaw config set gateway.controlUi.allowedOrigins '["xxxx","xxx","http://172.21.5.112:18789", ]'
4、查看修改后的配置
openclaw config get gateway.controlUi.allowedOrigins
5、重启Gateway服务
openclaw gateway restart

Web UI界面

修改和查看访问链接和Token等信息：控制 - 概览
修改和查看大模型配置信息：配置-Models
配置：可以对配置文件在界面进行修改。

配置-Models-Model Providers：选择和配置要使用的大模型。

问题记录

SimpleClaw安装技能失败解决：
一键安装的SimpleClaw在安装技能时安装失败时，可以用npm命令行安装，然后重启。

离线安装skill：
从clawhub下载技能文件，保存到SimpleClaw的xxxx\SimpleClaw\resources\openclaw-runtime\skills目录下，此处存所有安装的技能。

手动删除OpenClaw源码官方安装：
Get-ChildItem -Path "C:\Program Files", "C:\Program Files (x86)", $env:APPDATA, $env:LOCALAPPDATA -Filter "*openclaw*" -Recurse -ErrorAction SilentlyContinue  取出所有列举出来的地址删除文件，最后再用360清理下注册表即可。

生成文件的默认地址：
 C:\Users\xxxx\.openclaw\workspace