OpenClaw 是一款本地 AI 智能体框架，将云端大语言模型与本地计算机连接，支持读取文件、执行命令及自动化运维。教程涵盖通过 npm 安装 OpenClaw，利用配置向导绑定 Moonshot Kimi 大模型与 Telegram Bot 账户。内容包括启动网关服务、管理后台进程、可视化控制台使用及核心命令解析。此外列举了文件整理、文档处理、系统控制等实际应用场景，帮助用户快速部署并掌握本地 AI 助手的使用方法。
OpenClaw 是一款功能强大的本地 AI 智能体（Agent）框架。它的核心理念是将云端的大语言模型（LLM）的'大脑'与你本地计算机的'手脚'连接起来，让 AI 能够突破网页对话框的限制，直接读取你的本地文件、执行系统命令，甚至自动化完成日常的开发与运维工作。
核心架构与工作原理 OpenClaw 的运行机制由三个关键部分组成：
核心功能与应用场景
首先，我们需要把 OpenClaw 这个软件下载到你的电脑上。打开你电脑的命令行工具（Windows 用户打开 CMD 或 PowerShell，Mac 用户打开终端 Terminal），在黑框框里输入以下命令并按下回车（Enter）键：
npm install -g openclaw
安装完成后，我们需要给它做一个基础的'开机设置'，顺便给它装上一个聪明的'AI 大脑'。
在终端里输入以下命令并回车：
openclaw onboard
这会唤醒 OpenClaw 的初始化配置程序。
系统会问你使用什么账户，默认选择 Yes 即可（代表作为个人账户继续）。使用键盘方向键选择，回车确认。
对于新手，强烈建议在这里选择 QuickStart (快速入门)。这个模式会自动帮你跳过很多复杂的底层配置，提供最顺畅的新手引导。
现在我们要给机器人挑选一个'大脑'。OpenClaw 支持很多国内外大模型。
对于国内开发者来说，为了网络稳定和中文理解能力，这里推荐使用方向键选择 Moonshot AI (Kimi K2.5)
紧接着，选择 Kimi API key (.cn)
这是目前国内开发者的主流选择，直连国内服务器，速度最快
系统会提示你输入 API Key。这个 Key 就像是你使用 Kimi 大脑的'专属密码'。
需要先去 Moonshot 开放平台 注册并生成一个 API Key
将你申请到的 API Key 复制，然后在此处粘贴，按下回车。
大脑装好了，我们得找个地方跟它聊天下指令。OpenClaw 支持把机器人接入常见的聊天软件中。
在列表里选择 Telegram (Bot API)
Telegram 对开发者极其友好，是目前控制机器人最丝滑的平台。
系统会要求你输入 Telegram bot token。
你需要提前在 Telegram 里搜索 @BotFather
然后发送 /newbot 创建一个机器人，它会发给你一串像 123456:ABCDefg... 这样的长代码。
把这串代码粘贴到终端里，按下回车。
接下来系统会问你是否需要安装一些额外的技能。
Skills 是让机器人拥有额外能力的插件（比如搜索网页、操作 GitHub 等）。
作为新手，这里可以直接按回车跳过 (Skip for now)，等以后熟练了随时可以加。
⚠️ ⚠️ ⚠️
这里暂时跳过，不是说明 skills 没啥用，恰恰相反 skills 的作用极大！！！
OpenClaw 和普通的 AI 对话工具最大的区别，不是对话能力有多强，而是它有一个完整的 skills 生态。
说白了，不用 skills，你可能只发挥了 OpenClaw 20% 的能力。
这就像买了一部顶配的智能手机，但从来不装 APP，只用来打电话发短信，完全浪费了硬件性能，暴殄天物。
Hooks 是针对高级开发者的钩子功能（比如记录日志等）
同样，直接按回车先跳过即可
最后，系统会提示正在管理 Gateway（网关）服务
如果有提示，请选择 Restart (重启)
这会让刚才填写的配置全部生效！
配置全部走完后，我们要把底层的发动机彻底跑起来，并进行最后一步安全验证。
如果终端回到了普通的输入状态，请输入以下命令：
openclaw gateway
这行命令非常重要！它是 OpenClaw 的核心服务器（你可以把它理解为机器人的心脏）。它负责监听本地端口、连接 Telegram 并调用刚才配置的大模型。注意：启动后，这个黑色的终端窗口千万不能关，否则机器人就掉线啦！
打开你的 Telegram，找到你刚才创建的那个机器人，随便给它发一条消息（比如发个 hi 或者点击底部的 Start）。
你会发现机器人没有立刻回答你的问题，而是给你发了一段带有 Pairing code（配对码）的提示。
别慌，这是为了保护你电脑安全的机制！它在问：'是你本人在试图控制这台电脑吗？'
操作方法：
这个动作相当于你作为'主人'，亲自给 Telegram 上的机器人发放了'进场许可证'。
配对成功后，回到 Telegram，你就可以正常和它聊天了！
试着对它说：'你好，请用中文介绍一下你自己，并告诉我当前我电脑操作系统的名称。'
它不仅能听懂你说话，还能直接读取你的系统信息返回给你！
列出我电脑桌面上所有的文件名:
10 分钟后发消息提醒：
这四个命令本质上都是围绕着 'OpenClaw 核心后台服务（Gateway）' 展开的。
| 命令 (Command) | 核心作用 (Role) | 前端开发类比 (前端视角) | 关联与依赖 (Connection) | 核心区别与特征 (Difference) |
|---|---|---|---|---|
openclaw gateway | 启动核心网关服务（前台模式） | |||
| 启动本地服务器，监听端口，连接大模型与 Telegram。 | 相当于运行 npm run dev 或 umi dev | 是所有功能运行的基础引擎。如果不运行它，Telegram 机器人会瘫痪，Dashboard 网页也会打不开。 | 前台阻塞进程。终端窗口必须一直开着，一旦你按 Ctrl+C 或关闭黑窗口，服务立刻终止。主要用于排查报错日志（Debug）。 | |
openclaw daemon start | 启动核心网关服务（后台守护模式） | |||
| 将网关服务注册为系统后台任务静默运行。 | 相当于运行 pm2 start server.js | 作用完全等同于 openclaw gateway，但它是独立在后台存活的。 | 后台静默进程。执行后你可以直接关闭终端窗口，服务依然在后台偷偷运行，通常还会跟随电脑开机自启。 | |
openclaw dashboard | 打开可视化控制面板 | |||
生成安全的本地免密登录链接，并自动唤起浏览器打开 127.0.0.1:18789。 | 相当于在浏览器输入 localhost:8000?token=xxx 预览项目 | 严重依赖 Gateway 引擎。只有当你通过 gateway 或 daemon start 把服务跑起来后，这个命令才有意义，否则网页直接报错'无法访问'。 | 它本身不是服务器，只是一个'快捷方式脚本'，用来帮你省去手动复制超长安全 Token 的麻烦。 | |
openclaw status | 查看系统体检报告 | |||
| 输出当前网关的状态、Telegram 的连接情况、大模型的 Token 消耗量。 | 相当于运行 pm2 status 或查看服务端 Health Check 接口 | 用于侦测 Gateway 引擎的运行状况。当你发现 Telegram 机器人不回消息时，第一个就该敲这个命令。 | 它是只读操作，不会启动或关闭任何服务。只负责把当前后台的各项数据汇报给你。 |
你可以把 OpenClaw 想象成一家 AI 餐厅：
openclaw gateway 或 openclaw daemon start（二选一）：这就是在 '开门营业 / 启动后厨'。没有后厨，什么都做不了。（区别只是 gateway 是你亲自盯场子，daemon 是雇了个经理在后台帮你管）。openclaw status：这就是在 '查房/看监控'。看看后厨（Gateway）还在不在运作，服务员（Telegram）有没有在接客。openclaw dashboard：这是餐厅的 '经理办公室'。后厨必须在营业状态，你才能走进办公室看账本（运行日志）、调配方（修改 API Key 配置）。建议按照以下顺序使用，获得最舒适的开发体验：
openclaw daemon start（让它在后台跑，不碍事）。openclaw status 看看是不是断网了或模型连不上。openclaw dashboard 在网页里可视化修改。openclaw daemon restart（等于重启 PM2 进程）。当你熟悉了基础的启动和运行后，下面这几个命令将是你日常维护、排错和进阶配置的得力助手：
| 命令 (Command) | 核心作用 (Role) | 前端开发类比 (前端视角) | 典型使用场景 (Usage Scenario) |
|---|---|---|---|
openclaw onboard | 初始化系统向导 | ||
| 引导式完成 API 密钥、白名单、基础插件的配置。 | 相当于 create-umi 或 npx create-react-app | 只有在第一次安装，或者你想彻底推翻重来（重新配置所有核心设置）时才会用到。 | |
openclaw logs | 查看实时运行日志 | ||
| 打印出后台 Gateway 接收指令、调用大模型、执行本地脚本的完整流水。 | 相当于 pm2 logs 或浏览器的 Network / Console 面板 | 排错神器！当机器人胡言乱语、或者让你执行某个动作却没反应时，输入 openclaw logs --follow 就能实时看到底层的报错信息。 | |
openclaw daemon stop | |||
openclaw daemon restart | 停止/重启后台服务 | ||
| 对后台守护进程进行生命周期管理。 | 相当于 pm2 stop / pm2 restart | 当你觉得电脑变得卡顿，或者修改了底层环境需要让 OpenClaw 重新加载时使用。 | |
openclaw config | 管理底层配置 | ||
| 直接增删改查系统配置项，跳过繁琐的 onboard 向导。 | 相当于直接修改 .env 环境变量文件或 config/config.ts | 高级配置。比如你想把默认对话模型切换为基于 3 Pro 的模型，或者在做前端设计时，专门为 UI 图片生成配置类似 Nano Banana Pro 这样的大模型参数，用这个命令可以直接写入，不用重启向导。 | |
openclaw pairing | 设备/渠道安全配对 | ||
| 管理或清除已授权的客户端（如 Telegram 账号）。 | 相当于后台管理系统的'设备登录授权管理' | 当你换了一部手机上的 Telegram，或者不小心清理了缓存，需要重新进行安全授权（例如执行 pairing approve）时使用。 |
OpenClaw 虽然在终端里跑着一堆看似硬核的代码，但它一旦运行起来，对于完全不懂代码的普通用户（甚至行政、财务、运营人员）来说，简直就是一个长了手脚的 钢铁侠贾维斯。
它最核心的实际用途，就是把用鼠标点来点去的繁琐体力活，变成在 Telegram 里发一条微信语音般的指令。
以下梳理了 10 个最常用、最好用的非开发者核心场景：
对于非开发人员，OpenClaw 相当于一个懂人话的 Windows/Mac 高级管家。
你不需要知道文件在哪个绝对路径，也不需要学习复杂的软件操作，只要通过聊天表达你的意图，它就能帮你操纵本地文件和系统。
这些场景里，有没有哪个是你现在就想拿起手机在 Telegram 里让它替你跑一遍的？（比如试试自动整理一下你的桌面？）
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online