本地 AI 智能体 OpenClaw 安装与配置教程

在这里插入图片描述

前言

OpenClaw 是一款功能强大的本地 AI 智能体（Agent）框架。它的核心理念是将云端的大语言模型（LLM）的'大脑'与你本地计算机的'手脚'连接起来，让 AI 能够突破网页对话框的限制，直接读取你的本地文件、执行系统命令，甚至自动化完成日常的开发与运维工作。

核心架构与工作原理 OpenClaw 的运行机制由三个关键部分组成：

本地网关 (Gateway Engine)：这是运行在你电脑后台的守护进程（Daemon）。它类似于一个微型服务器，负责监听指令、管理权限以及调度底层的 AI 模型，是整个框架的控制中枢。
可插拔的'大脑' (LLM 接入)：OpenClaw 本身不直接提供大模型计算，而是作为一个载体。你可以自由接入各类顶尖模型（如 Moonshot Kimi、Gemini 等），通过配置 API Key 为其注入思考和推理能力。
交互渠道 (Channels)：它是你与 AI 沟通的物理桥梁。目前最成熟的方案是 Telegram Bot，这意味着你可以随时随地通过手机或平板向处于开机状态的电脑下发工作指令。

核心功能与应用场景

本地系统接管：只要在你授权的工作区（Workspace）范围内，它可以直接分析目录结构、读取代码文件内容、甚至替你执行命令行的脚本。
丰富的技能插件 (Skills Ecosystem)：OpenClaw 支持通过安装额外的依赖库来针对性扩充能力。
多端可视化控制：除了即时通讯软件，它还内置了本地的 Web Dashboard 控制台（默认运行在 http://127.0.0.1:18789），可以清晰地查看进程日志、Token 消耗状态和模型链路。对于开发者，它还提供了 VS Code 插件版本，无缝融入代码编辑器环境。

一、下载并安装 OpenClaw

首先，我们需要把 OpenClaw 这个软件下载到你的电脑上。打开你电脑的命令行工具（Windows 用户打开 CMD 或 PowerShell，Mac 用户打开终端 Terminal），在黑框框里输入以下命令并按下回车（Enter）键：

npm install -g openclaw

在这里插入图片描述

二、启动配置向导与绑定 AI 大脑

安装完成后，我们需要给它做一个基础的'开机设置'，顺便给它装上一个聪明的'AI 大脑'。

1. 启动向导

在终端里输入以下命令并回车：

openclaw onboard

这会唤醒 OpenClaw 的初始化配置程序。

在这里插入图片描述

命令 (Command)	核心作用 (Role)	前端开发类比 (前端视角)	关联与依赖 (Connection)
`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 机器人不回消息时，第一个就该敲这个命令。	它是只读操作，不会启动或关闭任何服务。只负责把当前后台的各项数据汇报给你。

命令 (Command)	核心作用 (Role)	前端开发类比 (前端视角)
`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`）时使用。

本地 AI 智能体 OpenClaw 安装与配置教程