WSL使用记录

初入WSL

安装wsl（ubuntu）指定盘符

wsl --install Ubuntu --location D:\WSL\Ubuntu

且在弹出的黑色窗口里设置好了用户名（username）和密码（password），就已经拥有了一个直接安装在 D 盘的干净 Linux 系统。

为ubuntu更换国内镜像

sudo sed -i 's|http://archive.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list.d/ubuntu.sources
sudo sed -i 's|http://security.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list.d/ubuntu.sources

如果看到下载进度条刷刷地走，并且域名里带有 aliyun.com，那就说明大功告成了

Openclaw 相关

结合AI食用
参考官方教程：https://docs.openclaw.ai/zh-CN/install

安装过程

安装依赖

sudo apt update
sudo apt install -y wget curl git unzip python3 python3-pip python3-venv build-essential

国内镜像安装nvm

# 1. 下载 nvm 源码到本地
git clone https://gitee.com/mirrors/nvm.git ~/.nvm

# 2. 进入目录并切换到最新稳定版
cd ~/.nvm
git checkout v0.39.7

# 3. 将 nvm 配置写入系统环境
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> ~/.bashrc

# 4. 设置 Node.js 下载镜像源为阿里云（这步非常关键，否则下一步会极慢）
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/' >> ~/.bashrc

# 5. 刷新环境配置
source ~/.bashrc

安装node.js22

# 安装 Node.js 22
nvm install 22

# 使用 Node.js 22
nvm use 22

# 设置 npm 国内镜像（安装 OpenClaw 依赖时会用到）
npm config set registry https://registry.npmmirror.com

验证

node -v       # 应该输出 v22.x.x
python3 -v    # 应该输出 3.10 或 3.12
git --version # 应该正常输出

安装

npm i -g openclaw

安装完成后输入

openclaw

如果提示 command not found，请执行一次 source ~/.bashrc 刷新环境，因为 npm -g 的安装路径已经包含在 nvm 自动配置的 PATH 路径下了

使用过程

扫码

如果命令行中生成的二维码扫不出来，先尝试 Ctrl + - 缩小窗口

使用arduino cli

需要在wsl上先配置透传

步骤1：Windows PowerShell（管理员）检查 USB 状态

# 查看 USB 设备列表
usbipd list

# 你应该能看到类似：
# BUSID  VID:PID    DEVICE                    STATE
# 1-1    1a86:7523  USB Serial (CH340)        Attached
# 或
# 1-1    1a86:7523  USB Serial (CH340)        Shared

步骤2：如果状态是 “Not shared”，重新附加

# 重新附加到 WSL
usbipd attach --wsl --busid 1-1

# 或如果已 Shared 但未 Attached：
usbipd attach --wsl --busid 1-1 --auto-attach

步骤3：WSL 内验证

# 检查设备是否出现
ls /dev/ttyUSB*

# 应该输出：
# /dev/ttyUSB0

# 验证板子检测
arduino-cli board list

# 应该输出：
# Port         Type              Board Name  FQBN            Core
# /dev/ttyUSB0 Serial Port (USB) Arduino Uno arduino:avr:uno arduino:avr

步骤4：重新烧录（也可以命令让openclaw烧录）

cd /home/aki/.openclaw/workspace/10-projects/arduino/serial-weather-clock
arduino-cli compile --fqbn arduino:avr:uno .
arduino-cli upload -p /dev/ttyUSB0 --fqbn arduino:avr:uno .

如何检测串口输出？（在你的固件有输出内容到串口的情况下）一些命令配置可以询问claw获取

arduino-cli monitor -p /dev/ttyUSB0 --config baudrate=9600

docker相关

安装

参考链接：https://zhuanlan.zhihu.com/p/1946945462901933435

wsl文件管理相关

从windows移动文件到wsl文件夹

（当前是默认只使用了一个系统，暂未知多个系统的时候怎么选择）

在wsl内：假设在用户目录

cd /mnt/g/wokwi_cli_for_linux

这里的g是指windows下的盘符，后面名字是文件夹名称

设置该文件夹下的某文件为可操作状态（rwx中的x，其中r是只读，w是只写，chmod是改变状态的命令）

chmod +x wokwi-cli-linux-x64

剪切移动该文件到 wsl下的指定位置

sudo mv wokwi-cli-linuxstatic-x64 /usr/local/bin/wokwi-cli

这个方法在wsl下git clone经常失效的情况下很有用

当然更简单的方法是 win下ctrlx 到wsl文件夹下粘贴

wsl网络管理相关

linux配置相关

终端

zsh

Donate