AI

WSL2 安装 Claude Code，OpenClaw，Hermes Agent

WSL2 install agent

Posted by shake on May 16, 2026

发现使用笔记软件，也是会导致版本太多，导致经常自己查看都很不方便。记忆感觉确实因为AI，在逐步变差，唯一的办法，就是停下来，整理文章。

文章内容笔记里，公众号，不同的内容混杂一次。我需要整理一个适合我使用的版本。

WSL 2

对于 Windows 资深用户来说，无论是安装 OpenClaw 还是 Claude Code，WSL2 (Windows Subsystem for Linux) 都是官方推荐且唯一的“最优解”。

微软其实应该2024年，才算彻底解决WSL2的各种技术问题。用最新版本，可以避免很多麻烦。

确认WSl 2正常

遇到过安装所谓的精简win11，导致WSL2给精简的案例。确保win11，是2024后到版本

1
2
3
4
5
6
7
8

## Powershell admin 运行

# 检查版本信息
wsl --version

# 强制更新至最新版本
wsl --update

开启“镜像网络”模式 (Critical)

这是 Windows 用户避坑的最关键一步。默认的 WSL 网络是 NAT 模式，在处理代理、本地浏览器通讯（OpenClaw 核心需求）时极其痛苦。镜像模式 (Mirrored) 能让 Linux 直接共享 Windows 的 IP 和网络配置。

  1. 打开资源管理器，进入当前用户目录：C:\Users<你的用户名>\。
  2. 新建文件：.wslconfig (注意文件名前有小数点)。
  3. 写入以下配置：
1
2
3
4

[wsl2]
# 开启镜像网络模式
networkingMode=mirrored

WSL 常用命令

WSL启动的虚拟机，有点类似容器，你是无法在虚拟机关机，必须在Powershell里才能关机，习惯就好，差异不多。

1
2
3
4
5
6
7
8
9
10

## 关机
wsl --terminate Ubuntu-24.04


# 注销原系统：
wsl --unregister Ubuntu-24.04

# 导入到新位置：
wsl --import Ubuntu-24.04 D:\WSL\Ubuntu-24.04 D:\backups\ubuntu-24.04-snapshot-claude-20260410.tar

安装Ubuntu 24.04

1
2
3
4
5
6
7

# 查看可用分发版本
wsl --list --online
# 安装 Ubuntu 24.04
wsl --install -d Ubuntu-24.04

# 安装过程中会提示输入 Unix 用户名 和 密码（建议记住，后续 sudo 命令需要使用）。我的用户名：shake

装完系统后，关闭powershell。因为这个时候，你运行 wsl命令，是不管用的。

启动Ubutnu

windows 搜索 Ubuntu 24.04，看到图标，点击就可以打开一个Ubuntu 24.04.

sudo vi /etc/wsl.conf

1
2
3
4

[boot]
systemd=true
[user]
default=shake

配置 default 用户，可防止后续导出恢复后默认以 root 登录。

sudo无密码

1

echo "$USER ALL=(ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/$USER

更新

1
2
3
4

sudo apt update -y
sudo apt upgrade -y
sudo apt install unzip jq -y

WSL存储移动到D盘

重新打开Power shell

1
2
3
4
5
6
7
8
9
10
11
12
13

# 关闭并注销（在 PowerShell 运行）：
wsl --terminate Ubuntu-24.04

# 导出快照（建议在 D 盘创建 backups 文件夹）
wsl --export Ubuntu-24.04 D:\backups\ubuntu-24.04-init.tar

# 注销原系统：
wsl --unregister Ubuntu-24.04

# 导入到新位置：（建议在 D 盘创建 WSL 文件夹）
# 格式：wsl --import <分发名> <安装位置> <备份文件路径>
wsl --import Ubuntu-24.04 D:\WSL\Ubuntu-24.04 D:\backups\ubuntu-24.04-init.tar

windows，搜索Ubuntu 24.04，就可以再次启动Ubuntu 24.04.

虚拟机持续运行

默认情况下，关闭终端窗口会导致 WSL 挂起，且 Windows 重启后服务无法自启。我们要实现“开机即后台运行”。

Ubuntu 虚拟机里，创建一个脚本：wsl-autostart.sh

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

sudo tee ~/wsl-autostart.sh > /dev/null << 'EOF'
#!/bin/bash

# ==========================================
# 脚本名称: wsl-autostart.sh
# 适用场景: 通用 WSL 2 持久化后台运行
# ==========================================

# 1. 自动获取当前用户和家目录
USER_NAME=$(whoami)
USER_HOME=$(eval echo ~$USER_NAME)
LOG_FILE="$USER_HOME/wsl-session.log"

# 2. 记录启动时间（用于排查开机自启是否触发）
echo "[$(date '+%Y-%m-%d %H:%M:%S')] WSL Session Started for $USER_NAME" >> "$LOG_FILE"


# 4. 【核心指令】防止 WSL 闲置关闭
# tail -f /dev/null 是最轻量的占座方式，不消耗 CPU 但能维持进程活跃
echo "Keep-alive process (tail) started." >> "$LOG_FILE"
tail -f /dev/null
EOF

授权

1

sudo chmod +x ~/wsl-autostart.sh

设置 Windows 任务计划程序

按下 Win + R，输入 taskschd.msc。

1
2
3
4
5
6
7

#创建任务（非基本任务）：  
  ○ 常规：名称设为 wsl-autostart；勾选“不管用户是否登录都要运行”；勾选“使用最高权限运行”。  
  ○ 触发器：新建 -> 选择“启动时”；高级设置勾选“延迟任务运行 1 分钟”。  
  ○ 操作：新建 -> 程序：wsl；参数：-d Ubuntu-24.04 -u <你的用户名> -e /home/<你的用户名>/wsl-autostart.sh。  
  ○ 设置：取消勾选“只有在计算机使用交流电源时才启动此任务”；取消勾选“如果任务运行时间超过以下时间则停止”。
#  确定并输入 Windows 登录密码。

初始化Ubuntu

因为是给Claude code，OpenClaw，Hermes agent使用，所以为了方便，先安装基本必须工具。

nodejs

OpenClaw需要用到，官方推荐24的版本，最低版本要求是，skill很多都需要。

1
2
3
4
5
6
7

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install nodejs -y

## 验证
node --version
npm --version

bun

1
2
3
4
5

# 安装bun
curl -fsSL https://bun.sh/install | bash

source .bashrc
bun --version

uv

1
2
3
4
5

curl -LsSf https://astral.sh/uv/install.sh | sh

 source $HOME/.local/bin/env
 uv --version

brew

1

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

设置环境变量

1
2
3
4

echo >> /home/shake/.bashrc
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv bash)"' >> /home/shake/.bashrc
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv bash)"

安装环境需要包

1

sudo apt-get install build-essential -y

Claude Code

用curl，一行命令就完成安装

1

curl -fsSL https://claude.ai/install.sh | bash

查看目录

1
2
3

ls -la ~/.claude
backups  cache  downloads

启动Claude code 前

需要对Claude code进行基本的初始化设置

  • 全局的CLAUDE.md 文件
  • 配置使用的模型，~/.claude/settings.json
  • 设置快捷键，提升效率，修改 .bashrc
  • 创建两个项目文件夹：project-writer，devops，不同的工作，不同的文件夹下操作
  • 给两个项目文件夹，创建项目的CLAUDE.md 文件，开发和写作，有区别的。
  • 创建 ./claude/knowledge 目录, 存放相关内容。

claude 文件夹

1
2
3
4
5
6
7
8
9
10
11
12

~/.claude/
 ├── CLAUDE.md           ← 主记忆（目录索引）
 ├── commands/           ← 自定义命令
 └── knowledge/          ← 知识库文件夹
     ├── CLAUDE.md       ← 知识库索引
     ├── credentials/    ← 凭证（API 密钥）
     ├── guides/         ← 方法指南
     ├── setups/         ← 安装配置
     └── standards/      ← 规范标准
     └── library/        ← 知识文档

我已经把文件都准备好，从windows 复制过来就可以。Ubuntu复制windows的文件的玩法，需要熟悉一下。

1
2
3
4
5
6

cp -r /mnt/d/share ~/
cp -r ./share/claude/* ./.claude/
cp ./share/.bashrc ./
cp -r share/project-writer/ ./
cp -r share/devops/ ./
source ~/.bashrc

启动Claude code

进入devops 文件夹，启动claude code，已经设置快捷键：cc

Statusline

1

 @ ~/.claude/knowledge/setups/statusline-installation.md 安装statusline

hooks

1

 @ ~/.claude/knowledge/setups/hooks-installation.md 安装 Hooks

MCP

1
2

 @ ~/.claude/knowledge/setups/mcp-installation.md 安装MCP，确保MCP服务运行正常。
 密钥在~/.claude/knowledge/credentials

minimax cli

1

 @ ~/.claude/knowledge/setups/minimax-cli-installation.md 安装，验证生图，识别图片功能正常。
CATALOG
    FEATURED TAGS
    生活 AI 儿子 留学 技术 son 历史 AP