通过kimi claw体验了一把openclaw。kimi claw不是很好用，限制太多，无法链接外网，无法切换API等。但是感觉openclaw还不错。于是把限制的windows电脑装上了openclaw，过程如下：

首先确认系统版本，官方建议win10/11。旧电脑之前从win7升级到了win10，刚好可用。

启用wsl

管理员身份运行powershell，输入：
wsl install

这会安装 WSL2 和默认的 Ubuntu 发行版。然后在win中启用虚拟化功能：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

重启电脑。重启时进入 BIOS 设置(Thinkpad)：

开始菜单 → 设置 → 更新和安全（或"系统"→"恢复"）
点击 "恢复" → "高级启动" 下的 "立即重新启动"
选择 "疑难解答" → "高级选项" → "UEFI 固件设置" → "重启"

Security（安全） → Virtualization（虚拟化）
或
Security → Intel Virtualization Technology

开启虚拟化:

选中 "Intel Virtualization Technology" 或 "VT-x" 或 "Virtualization",按 Enter 键，选择 "Enabled"（启用）,如果有 "Intel VT-d" 选项，也一并启用.

按 F10 键,选择 "Yes" 或 "OK" 保存并退出.

重启后Ubuntu安装完毕。输入wsl --version确认成功。

然后是在这个系统中安装openclaw。

安装openclaw

因为旧机器上没有安装clade code或者codex这些，所以只能手动进行。

开始找kimi教我，走了大半天弯路，没有成功，主要是咋了虚拟系统中使用win的代理网络没搞定。我让各种curl、npm设置代理啥的，搞了半天全失败。

换deepseek，教我用景象的方法，一次成功！我让dp自己总结了一下过程：

OpenClaw-CN 在 WSL Ubuntu 上的完整安装与配置指南

本文档基于实际对话记录整理，详细介绍了如何在 Windows 11 的 WSL Ubuntu 环境中安装并配置 OpenClaw-CN（中文版），最终成功通过 Telegram 与 AI 助手交互。整个过程包括环境准备、网络代理配置、软件安装、初始化设置、Telegram 机器人配对以及 Web 控制台访问。

1. 环境准备

1.1 确认系统环境

Windows 11 主机，已安装 WSL 2 及 Ubuntu 发行版。
Ubuntu 中已安装 Node.js（版本 v22.22.0，自带 npm）。
确保 Windows 上有可用的代理软件（如 Clash、V2RayN 等）。

1.2 配置 WSL2 镜像网络模式（推荐，避免手动找 IP）

在 Windows 用户目录（C:\Users\你的用户名）下创建或编辑 .wslconfig 文件，内容如下：

[wsl2]
networkingMode=mirrored
dnsTunneling=true
firewall=true
autoProxy=true

然后以管理员身份打开 PowerShell，执行以下命令重启 WSL：

wsl --shutdown

重新打开 WSL Ubuntu 终端，此时 WSL2 的网络已与 Windows 共享，可以直接通过 127.0.0.1 访问 Windows 上的服务（包括代理）。

1.3 清除旧的代理环境变量（如果之前手动设置过）

如果你之前曾通过 export 命令设置过 http_proxy 等变量，需要清除它们以避免干扰镜像模式：

unset http_proxy https_proxy ALL_PROXY

同时检查并清理 ~/.bashrc 中相关的持久化设置（如有），然后执行 source ~/.bashrc 使其生效。

1.4 验证网络连通性

测试能否通过代理访问外网（代理软件需开启“允许局域网连接”，Windows 防火墙放行端口 22515）：

curl -I https://www.google.com

若返回 HTTP/1.1 200 OK 或 302 Moved 等响应，说明代理配置成功。

1.5 确保 npm 可用

npm -v

若正常显示版本号，则可继续。若 npm 未安装，可通过系统包管理器安装：

sudo apt update && sudo apt install npm

或使用 nvm 重新安装 Node.js（推荐）。

2. 安装 OpenClaw-CN

使用 npm 全局安装中文版 OpenClaw（openclaw-cn）：

npm install -g openclaw-cn@latest

安装过程中可能会显示一些 deprecated 警告，属于正常现象，不影响使用。安装完成后，验证命令是否存在：

openclaw-cn --version

如果提示命令未找到，可能是因为 npm 全局 bin 目录未加入 PATH，可尝试使用 npx openclaw-cn --version 测试，或重新登录终端。

可选：创建别名 alias openclaw=’openclaw-cn’，但不必须
注意：安装的是 openclaw-cn，命令名也是 openclaw-cn，而不是 openclaw。若之前安装过官方版，建议先卸载避免冲突：
npm uninstall -g openclaw

3. 初始化配置（onboard）

运行初始化向导，它会引导你完成核心配置并启动守护进程：

openclaw-cn onboard --install-daemon

向导中会依次询问：

安全确认：输入 Yes 并回车。
AI 模型配置：选择你使用的模型服务商（如阿里云百炼、DeepSeek、OpenAI 等），并填写 API Key。这是 OpenClaw 的“大脑”，必须配置。
通信渠道：选择 Telegram（或其他聊天软件）。新手可以先跳过，后续在 Web 界面中随时添加。
技能安装：推荐安装内置技能，直接回车或按提示选择“是”。

初始化完成后，OpenClaw 的核心服务（Gateway）将在后台运行。

4. Telegram 机器人配对

4.1 在 Telegram 中创建机器人

通过 @BotFather 创建一个新机器人，获取其 Bot Token（格式如 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）。

4.2 在 OpenClaw 中添加 Telegram 渠道

可以通过 Web 控制台添加（见第 5 节），但更快捷的方式是使用 CLI 命令。假设你已知道 Bot Token，可以运行：

openclaw-cn channel add telegram --token "你的Bot Token"

或等待后续在 Web 界面中配置。

4.3 批准配对请求

当你在 Telegram 中向机器人发送 /start 时，机器人会回复类似以下消息：

ask the bot owner to approve with: openclaw pairing approve telegram xxxx

请复制 openclaw pairing approve telegram xxxx 整条命令，然后在 WSL 终端中执行（注意将 openclaw 替换为 openclaw-cn）：

openclaw-cn pairing approve telegram xxxx

（将 xxxx 替换为实际的配对码）

终端显示 Approved successfully 后，再次在 Telegram 中向机器人发送 /start 或任意消息，即可开始对话。

5. 访问 Web 控制台

OpenClaw 提供了一个功能丰富的 Web 控制台，用于管理模型、渠道、技能、任务等。

5.1 启动 Web 控制台

在 WSL 终端中运行：

openclaw-cn dashboard

终端会输出类似以下信息：

Dashboard URL: http://127.0.0.1:18789/?token=9547760a1944847132f1620aafdbb4f5eb4sdfe70c58d4bdfds
Copied to clipboard.

请保持此终端窗口运行（它启动了一个本地 Web 服务）。

5.2 访问并登录

直接复制终端输出的完整 URL（包括 ?token=... 部分）并粘贴到浏览器地址栏中打开。由于是本地连接（127.0.0.1），OpenClaw 会自动批准该设备，无需额外配对。

如果打开的页面提示需要输入 token，请从 URL 中提取 token= 后面的字符串（如上例中的 9547760a...64b8）并粘贴到输入框中。

5.3 首次登录后的操作

配置 Telegram 渠道（如果初始化时未配置）：在控制台中找到 Channels 或渠道设置，添加 Telegram，填入 Bot Token。
管理技能：在 Skills 页面可以启用/禁用已安装的技能，或安装新技能。
查看日志：在 Debug 或 Logs 页面可以查看 Gateway 运行日志，便于排查问题。

6. 常见问题及解决方法

Q1: 运行 `openclaw-cn` 命令提示 command not found

确认全局安装成功：npm list -g --depth=0 | grep openclaw-cn
若已安装，可能是 npm 全局 bin 目录未加入 PATH。可尝试：
```
~/.nvm/versions/node/当前版本/bin/openclaw-cn --version
```
或重新登录终端。

Q2: Telegram 机器人提示“ask the bot owner to approve”

如果安装的中文版，确保你运行的是 openclaw-cn pairing approve ... 而不是 openclaw ...。
检查配对码是否正确，命令中的 telegram 和配对码之间有无空格。

Q3: Web 控制台提示“unauthorized: gateway token missing”

如第 5.2 节所述，使用带 token 的完整 URL 访问。
确保 openclaw-cn dashboard 命令保持运行。
如果 token 丢失，可以尝试重启服务：openclaw-cn restart，然后重新运行 dashboard 获取新 token。

Q4: 无法通过代理访问外网

确认 WSL2 已启用镜像模式（wsl --version 查看版本，或检查 ip addr 中是否有与 Windows 相同的 IP）。
检查代理软件是否开启“允许局域网连接”。
Windows 防火墙是否放行代理端口（如 22515）。

Q5: npm 安装包时卡住或报错

可以设置 npm 代理（即使镜像模式下也推荐显式设置）：

npm config set proxy http://127.0.0.1:22515
npm config set https-proxy http://127.0.0.1:22515

或使用国内镜像源（如淘宝源）加速：

npm config set registry https://registry.npmmirror.com

7. 总结

通过以上步骤，你已经成功在 WSL Ubuntu 中部署了 OpenClaw-CN，并接入了 Telegram。现在你可以：

在 Telegram 中与 AI 助手对话。
通过 Web 控制台精细管理各项功能。
根据需要安装更多技能、添加其他渠道。

OpenClaw 的强大之处在于其高度可扩展性和灵活性，建议阅读官方文档 docs.clawd.bot 以探索更多可能性。

OpenClaw 安装时通过 --install-daemon 已经将核心服务（Gateway）设置为后台守护进程，因此关闭终端不会影响其运行。但你需要知道如何管理它，以及何时需要保持终端窗口打开。

8. 管理 OpenClaw 核心服务（Gateway）

核心服务在后台运行，负责处理 AI 请求、消息渠道等。使用以下命令管理：

操作	命令
检查服务状态	`openclaw-cn status`
启动服务	`openclaw-cn start`
停止服务	`openclaw-cn stop`
重启服务	`openclaw-cn restart`

这些命令不需要一直开着终端窗口——执行后服务会在后台持续运行，即使关闭 WSL 终端也不会停止。

注意：如果 WSL 发行版被完全关闭（例如重启 Windows 或运行 wsl --shutdown），服务会停止。下次打开 WSL 终端时，需要手动启动服务（openclaw-cn start）。若希望开机自启，可参考文末提示。

9. Web 控制台（Dashboard）的说明

openclaw-cn dashboard 命令会启动一个临时的本地 Web 服务器，用于提供管理界面。它不是后台服务，因此：

运行 dashboard 的终端窗口必须保持打开，否则 Web 界面将无法访问。
你可以：
- 另开一个终端窗口专门运行 dashboard，需要管理时再打开。
- 或者让它在后台运行：openclaw-cn dashboard &（但要注意后台进程的管理）。
关闭 dashboard 终端（按 Ctrl+C）只会关闭 Web 界面，不影响核心服务。之后想再用 Web 管理时，重新运行 openclaw-cn dashboard 即可。

10. 关于 WSL 终端和服务的关系

核心服务（Gateway）：后台守护进程，独立于终端。关闭终端 → 服务继续运行。关闭 WSL 发行版 → 服务停止。
Web 控制台（Dashboard）：前台进程，依赖终端。关闭终端 → 服务停止（Web 无法访问），但核心服务不受影响。

11. 开机自启（可选）

若希望 WSL 启动时自动运行 OpenClaw 核心服务，可以将启动命令添加到 ~/.bashrc 中，但这样每次打开新终端都会尝试启动（可能重复）。更推荐的方式是使用 Windows 任务计划程序或 WSL 的 init 系统（如 systemd），但配置较复杂。一般场景下，手动启动已足够。

12. 快速回顾常用命令

# 核心服务管理
openclaw-cn status      # 查看运行状态
openclaw-cn start       # 启动服务
openclaw-cn stop        # 停止服务
openclaw-cn restart     # 重启服务

# Web 控制台（临时）
openclaw-cn dashboard   # 打开管理界面（保持终端打开）

# Telegram 批准（如需）
openclaw-cn pairing approve telegram <配对码>

# 查看日志
openclaw-cn logs        # 或通过 Web 控制台查看