🌟 序章：神秘的传说

那是2026年3月的一个普通下午。

我在朋友的聚会上，偶然听到有人在聊"养小龙虾"。

"养小龙虾？那不是应该买个水族箱吗？"我心里嘀咕。

但很快，我发现他们说的不是真的龙虾——而是OpenClaw，一个号称能让你拥有私人AI助手的神秘工具。

"只要装在自己的电脑上，7×24小时在线，还能自动帮你干活......"

朋友的话像一颗种子，在我心里生根发芽。

挑战宣言：我要在我的Win10笔记本上，驯服这只"龙虾"！

---

🗺️ 第一章：寻找龙穴（GitHub探险）

冒险等级：★☆☆☆☆

我的第一步，是找到传说中的OpenClaw藏身处。

🎯 任务目标：找到OpenClaw的官方源码

🔗 神秘坐标：https://github.com/openclaw/openclaw

打开浏览器，输入网址，眼前的景象让我震惊——满屏的英文，星星数高达数万，还有各种我看不懂的技术术语。

"这就是传说中的龙穴吗......"

我深吸一口气，在页面上寻找着中文的踪迹。终于，我发现了README.md文件，里面隐约提到了安装方法。

💡 探险家笔记：

• • GitHub是程序员的宝藏库

• • 找项目先看README（项目说明文档）

• • 星星数⭐越多，项目越受欢迎

---

⚔️ 第二章：第一道关卡（npm的试炼）

冒险等级：★★☆☆☆

README上写着简单的安装指令：

npm install -g openclaw@latest

"看起来挺简单的嘛！"我信心满满地打开命令提示符，输入指令——

❌ 失败！

'npm' 不是内部或外部命令，也不是可运行的程序

"npm是什么鬼？！"

我在电脑前抓狂了十分钟，然后开始了疯狂搜索。原来，npm是Node.js的包管理器，要先装Node.js才能用npm！

🎯 任务目标：安装Node.js

🔗 下载地址：https://nodejs.org

📋 操作步骤：

1. 1. 访问 https://nodejs.org

2. 2. 点击大大的绿色"LTS"按钮下载

3. 3. 双击安装包，一路"Next"

4. 4. 重启电脑（重要！）

安装完成后，我在命令行输入：

node --versionnpm --version

当看到版本号跳出来时，我激动得差点喊出声：

v22.16.010.8.2

✅ 第一关，通过！

💡 探险家笔记：

• • Node.js是JavaScript的运行环境

• • LTS = Long Term Support（长期支持版，更稳定）

• • 安装后一定要重启，否则环境变量不生效

---

🐧 第三章：神秘的WSL召唤

冒险等级：★★★☆☆

Node.js装好了，我再次尝试安装OpenClaw：

npm install -g openclaw@latest

❌ 又一次失败！

这次错误信息更诡异了，什么"bash命令找不到"、"Linux环境缺失"......

我又是一顿搜索，才发现：OpenClaw在Windows上需要WSL（Windows Subsystem for Linux）！

"WSL？这又是什么外星科技？"

🎯 任务目标：安装WSL

📋 操作步骤（管理员身份运行PowerShell）：

# 以管理员身份打开PowerShell# 右键点击"Windows PowerShell" → "以管理员身份运行"# 安装WSLwsl --install# 安装完成后，重启电脑

电脑重启后，WSL自动配置完成。我再次尝试：

npm install -g openclaw@latest

这次，进度条开始走了！各种包开始下载，屏幕上飞速滚动着我看不懂的信息......

✅ 第二关，通过！

💡 探险家笔记：

• • WSL = Windows上的Linux子系统

• • 很多开源工具都是为Linux设计的，WSL让Windows也能跑

• • 安装WSL后需要重启，这是Windows的规矩

---

🚪 第四章：消失的控制面板

冒险等级：★★★☆☆

OpenClaw终于装好了！我迫不及待地运行安装向导：

openclaw onboard --install-daemon

向导很友好，一步一步引导我配置Kimi API和Telegram。最后，它告诉我：

控制面板地址：http://127.0.0.1:18789/

"太棒了！"

我兴奋地打开浏览器，输入地址——

❌ 页面无法访问！

"什么鬼？！"

我刷新、换浏览器、检查防火墙......折腾了半小时，页面就是打不开。

🎯 任务目标：诊断问题

📋 操作步骤：

# 检查OpenClaw健康状态openclaw doctor

运行后，诊断报告出来了：

❌ Gateway未安装❌ Gateway服务未运行

原来，控制面板需要Gateway服务支持，而Gateway没有正确安装！

💡 探险家笔记：

• • Gateway是OpenClaw的核心服务

• • openclaw doctor是你的"体检医生"，哪里出问题一目了然

• • 127.0.0.1表示本机地址，18789是默认端口

---

👑 第五章：权限的诅咒

冒险等级：★★★★☆

我尝试安装Gateway：

openclaw gateway install

❌ 安装失败！

错误提示很模糊，什么"权限不足"、"拒绝访问"......

我又尝试了网上找到的各种方法：修改注册表、关闭UAC、添加用户组......全都无效。

就在我快要放弃时，突然灵光一闪：

"等等，我是不是没有用管理员权限？"

🎯 任务目标：以管理员身份安装

📋 操作步骤：

# 右键点击"Windows PowerShell"或"命令提示符"# 选择"以管理员身份运行"# 然后再次执行：openclaw gateway installopenclaw gateway start

✅ 成功了！

这次Gateway顺利安装并启动。我迫不及待地打开浏览器：

http://127.0.0.1:18789/

🎉 控制面板终于出现了！

💡 探险家笔记：

• • Windows权限管理很严格

• • 遇到"拒绝访问"，首先尝试"以管理员身份运行"

• • 右键菜单里的"以管理员身份运行"是神器

---

💰 第六章：API rate limit的陷阱

冒险等级：★★★☆☆

控制面板打开了，我兴奋地尝试发送第一条消息：

你好，OpenClaw！

❌ 错误！

API rate limit exceeded

"API rate limit？什么限制？"

原来，Kimi的免费API有调用频率限制。我这种折腾法，早就超出限制了。

🎯 任务目标：解决API限制

📋 操作步骤：

1. 1. 访问 https://platform.moonshot.cn

2. 2. 登录账号，进入控制台

3. 3. 充值购买API额度（我买了10元，够用很久）

4. 4. 获取新的API Key

5. 5. 更新OpenClaw配置：

openclaw config set models.providers.moonshot.apiKey "你的新API密钥"

充钱之后，rate limit问题解决了。

✅ 又可以愉快聊天了！

💡 探险家笔记：

• • API rate limit = 接口调用频率限制

• • 免费套餐通常有限制，付费后额度提升

• • 开发初期建议充值少量金额（5-10元够用很久）

---

🤖 第七章：沉默的Telegram机器人

冒险等级：★★★★☆

现在，我可以在控制面板和AI对话了。但朋友告诉我，真正的用法是通过Telegram随时随地聊天。

我按照教程创建了Telegram机器人，拿到了Bot Token，配置好了OpenClaw......

但发送消息后，没有任何反应。

机器人就像一个沉默的哑巴。

🎯 任务目标：修复Telegram连接

📋 排查步骤：

# 1. 检查Telegram频道状态openclaw channels status# 2. 查看实时日志openclaw logs --follow# 3. 检查配置openclaw config get channels.telegram

我在控制面板里尝试各种配置调整：

• • 检查Bot Token是否正确

• • 确认dmPolicy设置为"open"

• • 检查allowFrom是否包含"*"

• • 重启Gateway服务

终于在一次次尝试后，消息回复出现了！

🎉 Telegram机器人活了！

💡 探险家笔记：

• • Telegram机器人需要在BotFather里关闭Privacy Mode

• • 配置修改后要重启Gateway才能生效

• • openclaw logs --follow是排查问题的利器

---

🏆 终章：驯龙成功

经过整整三天的折腾，我终于成功了！

现在，我可以通过Telegram随时随地和我的AI助手对话：

• • 早上问天气 ☀️

• • 工作中查资料 💼

• • 晚上让它提醒我给ally喂食 🐕

• • 需要写文档时，它帮我生成初稿 ✍️

这一切，都始于那个偶然的"养小龙虾"话题。

回头看这段旅程，我踩过的坑包括：

• • ❌ 没装Node.js就想跑npm

• • ❌ 不知道需要WSL

• • ❌ 权限不够就乱安装

• • ❌ 免费API rate limit被限制

• • ❌ Telegram配置各种错误

但正是这些挫折，让我学到了：

• • ✅ 如何阅读GitHub项目文档

• • ✅ Windows权限管理

• • ✅ Linux基础知识

• • ✅ API和Gateway的概念

• • ✅ 排查问题的系统方法

这不只是一次软件安装，这是一次完整的技术成长。

---

📚 附录：驯龙完整指南

一、前期准备清单

项目	要求	备注
操作系统	Windows 10/11	需要支持WSL2
内存	4GB+	8GB更流畅
Node.js	v22.16+	从官网下载LTS版
WSL	必须安装	管理员身份运行wsl --install
API Key	Kimi/OpenAI	建议充值5-10元

二、完整安装流程

# Step 1: 安装Node.js# 访问 https://nodejs.org 下载安装# Step 2: 安装WSL（管理员PowerShell）wsl --install# 重启电脑# Step 3: 安装OpenClaw（管理员PowerShell）npm install -g openclaw@latest# Step 4: 运行安装向导openclaw onboard --install-daemon# Step 5: 安装并启动Gateway（管理员）openclaw gateway installopenclaw gateway start# Step 6: 验证安装openclaw doctoropenclaw gateway status

三、配置Kimi模型

编辑配置文件 %USERPROFILE%\.openclaw\openclaw.json：

{  "models": {    "providers": {      "moonshot": {        "baseUrl": "https://api.moonshot.cn/v1",        "api": "openai-completions",        "apiKey": "你的API密钥",        "models": [{          "id": "kimi-k2.5",          "name": "Kimi K2.5",          "contextWindow": 256000        }]      }    }  },  "agents": {    "defaults": {      "model": {        "primary": "moonshot/kimi-k2.5"      }    }  }}

四、配置Telegram机器人

1. 1. 在Telegram搜索 @BotFather

2. 2. 发送 /newbot 创建机器人

3. 3. 获取Token（形如：123:ABC...）

4. 4. 在BotFather发送 /setprivacy 选择 Disable

5. 5. 配置openclaw.json：

{  "channels": {    "telegram": {      "enabled": true,      "botToken": "你的Token",      "dmPolicy": "open",      "allowFrom": ["*"]    }  }}

五、故障排查速查表

问题	解决
npm不是命令	安装Node.js并重启
需要WSL	管理员运行wsl --install
权限不足	以管理员身份运行终端
Gateway未安装	管理员运行openclaw gateway install
API rate limit	充值或更换API Key
Telegram无响应	检查Privacy Mode和Token

六、常用指令

# 系统诊断openclaw doctor# 查看Gateway状态openclaw gateway status# 重启Gatewayopenclaw gateway restart# 查看日志openclaw logs --follow# 打开控制面板openclaw dashboard

---

🎭 写在最后

如果你也想开始这段冒险，请记住：

每一个技术高手，都是从一次次失败中爬起来的。

当我第一次输入npm install却看到错误提示时，我以为我不适合搞技术。

当我面对满屏的英文文档时，我想过放弃。

当我第三次安装失败时，我差点把笔记本扔出窗外。

但现在，我有了一个7×24小时在线的AI助手，它能帮我写代码、查资料、提醒我照顾宠物，甚至帮我写公众号文章。

这一切，都值得。

🦞 去吧，驯服属于你的那只"龙虾"！

---

参考资源：

• • OpenClaw官网：https://openclaw.ai

• • GitHub仓库：https://github.com/openclaw/openclaw

• • Kimi API平台：https://platform.moonshot.cn

• • Node.js下载：https://nodejs.org

愿每一个冒险者，都能成功驯服自己的龙。 🐉