1. OpenClaw
墨信文档
  • api密钥创建
    • 兑换额度->创建密钥
  • 常用软件配置
    • Chatbox
    • Cherry studio
    • Tavo配置
    • Zotero配置方法
    • Claude Code 安装使用教程
    • 小懿AI配置教程
    • vscode配置教程
    • chatbox手机端配置教程
    • WPS配置教程
    • 沉浸式翻译配置教程
    • OpenClaw
      • Win安装OpenClaw
      • Win(WSL2)安装OpenClaw
  • 接口调用示例
    • 视频
      • 创建视频
      • 获取视频任务进度
      • 获取视频内容
    • 生图
      • 香蕉文生图模型调用
      • 香蕉图改图
    • 文本模型调用
      POST
    • 文本模型调用[流式]
      POST
    • 文本模型调用[控制思考长度]
      POST
  1. OpenClaw

Win(WSL2)安装OpenClaw

注:该文档是从零使用WSL2安装OpenClaw,就是在Ubuntu中运行OpenClaw,适配OpenClaw的开发环境,使用这种安装方式会大大降低使用时的出错概率

一、下载WSL2#

这里不直接使用powershell的install命令下载,因为install命令对windows10版本有要求,这里使用都可以使用的方式:

1、使用管理员打开powershell顺序执行两行命令:#

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
再执行:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
image.png

2、重启电脑#

3、下载并安装内核升级包#

下载连接:https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
image.png
下载完成后双击运行,无脑点击"下一步"知道安装完成
1b7388bef53bddc9b5664e262c4b978b.png

3、确认安装成功#

管理员打开powershell,执行wsl --set-default-version 2,若输出以下内容,则安装成功
image.png

二、下载并启动Ubuntu#

1、下载Ubuntu#

很多win10没有微软商店,这里通过链接下载:https://aka.ms/wslubuntu2204
image.png

2、解压#

直接运行Ubuntu进行安装可能会安装失败,使用powershell命令行强装也能能因为缺少运行库导致无法启动
这里使用不会出错的方式:解压
找到刚才安装的文件,一般名为:Ubuntu2204-221101.AppxBundle
把该文件的后缀改成zip:
2bb0a3f1bcbd84c6ba021f98fa6257d5.png
全部解压缩:
02e8ff315dac80b21d65bfc20bc002bb.png
找到体积最大、名字带有 x64 的文件(通常叫 Ubuntu_2204.1.7.0_x64.appx),把他的后缀也改成zip
41c0f547bf86698f51285681062569ef.png
找一个内存充足,适合存放Ubuntu的文件夹,这个文件夹就是Ubuntu的系统文件夹,把刚才的zip文件复制进去
060e252670dd8077531e04e1b177d0b0.png
将复制的zip文件解压缩
6b8ea9c929b91bf5ad1751a0ba6e681f.png

3、运行#

双击运行刚才解压完的文件中的 ubuntu.exe
165288dc97cee5c98808f57f00a33edd.png
c36f3b17ded8f9ad95435b69d6ee49cc.png
第一次需要输入系统用户用户名和密码,并确认密码
(注意:在 Linux 终端里输入密码时,屏幕上不会显示任何字符(连星号都没有)。盲打完密码后按回车即可。)
2f4dc094dd05a7f3397302b95d2a78fa.png

三、安装Npm和NodeJs#

注意:本步骤需要VPN或使用镜像,使用VPN需要开启TUN模式
运行官方下载命令:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
f161c5ce1f1c20621e073b8ab158177f.png
运行刷新环境变量命令:
source ~/.bashrc
运行一键安装Node.js命令:
nvm install --lts
f9de02d1c84acdbce2bd9b9d2d47fd20.png

四、安装和配置OpenClaw#

1、安装OpenClaw#

执行OpenClaw安装命令:npm install -g openclaw
2bfa58448fce927f1aa067ac8d4469a6.png

2、运行初始化向导#

执行命令:openclaw onboard
image.png

3、初始化向导简单设置#

风险提示,选择Yes
image.png
开始方式,选择QuickStart
image.png
Model/auth provider 模型鉴权,选择Skip for now
1694333c0c856cb2e2eb4aeca7141cd5.png
Filter models by provider 模型提供方,选择Filter models by provider
之后在配置文件中设置
f846745597d8a76f44a48464ddc6ee50.png
出现这个,可以先选第一个,点击回车
27d1523f2dfbc173795de7976ad22966.png
Select channel(QuickStart) 选择通信渠道,选择Skip for now
36a7fe43597e33eec7697b9d717ac1e4.png
Configure skills now?(recommended) 配置技能,选择No
9ca5d232003c3336cb0791a8e3f03c41.png
Enable hooks? 配置自动化钩子,移到 Skip for now,先按空格,再按回车
aaae0635383a271b3d2c994a80a2d54d.png

4、复制网址#

输出以下内容:
36b369c23dcefedae93878b159b15a51.png
注意:一定要把带token的http网址复制下来!之后在浏览器要打开这个链接!
de0a03d8ec832cc14f3893d9a35a30e8.png

五、启动OpenClaw#

1、修改wsl.conf#

此时如果直接运行网关会报错,需要先唤醒systemd
这里不使用sudo编辑配置文件,直接运行命令:
sudo bash -c "echo -e '[boot]\nsystemd=true' > /etc/wsl.conf"
可能需要输一下密码
image.png

2、重启WSL引擎#

把这个ubuntu界面关闭,重新启动ubuntu.exe
image.png

3、启动网关#

运行启动网关命令:openclaw gateway run
282719db418548126c511bbdd066c1fe.png

4、在浏览器中运行#

打开浏览器,把上面 四-4 复制的网址输入进去,打开
注意:带token的网址只要输入一次就行了,之后可以使用不带token的http链接访问(http://127.0.0.1:18789/)
image.png
把语言改成中文:
image.png

六、配置第三方端点(墨信),密钥和默认模型#

1、打开openclaw.json文件#

不建议在命令行和文本管理器中编辑wsl.conf文件,各有各的问题,建议下载一个vscode,配置会很舒适
vscode打开wsl.conf为例,新运行一个ubuntu.exe,执行vscode打开wsl.conf命令:
image.png
code ~/.openclaw/openclaw.json
730fb96d5a536650f7fa6d4d76f1d8f4.png

2、配置openclaw.json文件#

在 openclaw.json 配置文件的根节点(最外层的大括号)内,新增一段 "models" 配置块:
这个意思就是创建了一个自己的模型提供方,命名为custom-1
id和name可添加多个,但id一定要和模型中的模型名保持一致
注意:apiKey要填成你自己创建的密钥
  "models": {
    "providers": {
      "custom-1": {
        "baseUrl": "https://www.moxin.studio/v1",
        "apiKey": "sk-mobt1BjGxfQJ2znyRLho7JsabKwAI0kBdQT8oevICZc5OKS",
        "api": "openai-completions",
        "models": [
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro"
          }
        ]
      }
    }
  },
在agents---defaults中添加两个配置块,将刚创建的模型提供方配置为默认:
如果要更换模型,需要把模型先添加到根节点的models中,再在下方替换
      "model": {
        "primary": "custom-1/gemini-2.5-pro"
      },
      "models": {
        "custom-1/gemini-2.5-pro": {}
      },
配置的时候可以在cmd中查看日志,分辨是否配置成功:黄字错,蓝字对
image.png
完整的openclaw.json参考:
{
  "wizard": {
    "lastRunAt": "2026-02-26T03:31:08.789Z",
    "lastRunVersion": "2026.2.24",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom-1/gemini-2.5-pro"
      },
      "models": {
        "custom-1/gemini-2.5-pro": {}
      },
      "workspace": "/home/jiangyi/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "models": {
    "providers": {
      "custom-1": {
        "baseUrl": "https://www.moxin.studio/v1",
        "apiKey": "sk-mobt1BjGxfQJ2znyRLho7JsabKwAI0kBdQT8oevICZc5OKS",
        "api": "openai-completions",
        "models": [
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro"
          }
        ]
      }
    }
  },
  
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "40e94e0115f6236380be09bd41a4d505d46c4bbc09eedf9b"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "calendar.add",
        "contacts.add",
        "reminders.add"
      ]
    }
  },
  "meta": {
    "lastTouchedVersion": "2026.2.24",
    "lastTouchedAt": "2026-02-26T03:31:08.796Z"
  }
}

七、使用openclaw#

1、测试对话#

回到聊天里对话
image.png
这个不是报错,是需要给AI一个定位,比如你是谁,AI是谁,要做什么,在你的第一句对话后会触发,按实际情况填写即可
比如:我是张总,是一个运营总监,你是我的助手流萤,帮我操作电脑,执行我给的命令
image.png

2、配置记忆指令#

记忆指令可以理解成agent
比如:通过WSL2部署的OpenClaw默认是不知道自己是windows下部署的,如果让她找个桌面文件她只会到ubuntu系统的目录下查找,可以通过记忆指令来给她,可以这样跟她对话:
注意:路径需要根据实际情况更改!
如果是 C:\ 开头,就改成 /mnt/c/
如果是 D:\ 开头,就改成 /mnt/d/
如果是 F:\ 开头,就改成 /mnt/f/
改完后,反转所有的/
比如你的路径是:F:\360MoveData\Users\lixiaojing\Desktop\dpyh
反转完之后是:/mnt/f/360MoveData/Users/lixiaojing/Desktop/dpyh
流萤请记住:我的真实 Windows 桌面绝对路径是 /mnt/c/Users/Administrator/Desktop。以后当我要你把文件保存在桌面,或者问你我的桌面路径时,你必须且只能使用这个绝对路径。请调用你的 Edit 工具,把这条规则永久记录到 USER.md 文件中
试一下:
d2aa94390c095bffd307b9c921b5addf.png
可以访问windows了,成功:
e69f3f573450e4399e8bbaf38567a898.png
至此,在Windows中通过WSL2安装OpenClaw已成功!
修改于 2026-03-05 09:49:28
上一页
Win安装OpenClaw
下一页
创建视频
Built with