OpenClaw 入门指南：从零部署到核心原理与实操

OpenClaw 入门指南：从零部署到核心原理与实操 | 极客日志

OpenClaw 入门指南

OpenClaw（原 Clawd、Moltbot）是一款开源的个人 AI 助手平台，核心定位是'真会动手办事'的数字员工。它接管电脑操作权限，通过自然语言指令主动执行各类任务，真正实现'聊天框里办大事'。

架构图

界面图

一、基础认知：OpenClaw 是什么？

1.1 核心定位

OpenClaw 的核心理念是'本地优先'和'执行优先'，被定义为一个'自托管的 AI 智能体框架'。区别于传统聊天机器人，它拥有'眼睛'和'手'——能操作浏览器、读写文件、执行脚本命令、模拟鼠标键盘。

简单来说：ChatGPT 能告诉你'如何清理邮箱'，而 OpenClaw 能直接帮你清理邮箱；ChatGPT 能给出'预订餐厅的步骤'，而 OpenClaw 能直接完成预订并反馈结果。

1.2 核心特性

本地优先，隐私可控：默认运行在用户本地设备（Windows、macOS、Linux），所有数据保存在本地，不上传云端。
寄生式交互，零门槛使用：可嵌入 WhatsApp、Telegram、Discord、飞书、钉钉等主流通讯软件。
持续记忆，越用越懂你：采用'文件即状态'的记忆机制，持久保存用户偏好和历史指令。
高度可扩展，技能自由：支持安装社区插件或自定义编写脚本。
多模型兼容，灵活切换：可对接 Anthropic Claude、OpenAI GPT、Gemini 等云端模型，也支持 Ollama 等本地私有模型。

二、实操入门：从零部署 OpenClaw

2.1 前置条件

系统要求：macOS 10.15+、Linux（推荐 Ubuntu）、Windows（需安装 WSL2）。
软件依赖：Node.js ≥ 22、pnpm（可选）。
其他准备：AI 模型 API Key（Claude/OpenAI/KIMI）、聊天渠道账号（Telegram/WhatsApp/飞书）。

2.2 本地部署步骤

步骤 1：安装 OpenClaw CLI

# macOS/Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (WSL2 内)
iwr -useb https://openclaw.ai/install.ps1 | iex

# 替代方案（全局安装）
npm install -g openclaw@latest

安装完成后，输入 openclaw --version 验证。

步骤 2：运行新手引导向导

openclaw onboard --install-daemon

按提示完成配置：选择部署方式、认证配置、聊天渠道配置、守护进程安装。

步骤 3：启动 Gateway 并验证 查看状态：

openclaw gateway status

手动启动：

openclaw gateway --port 18789 --verbose

浏览器访问 http://127.0.0.1:18789/ 登录控制台。

2.3 云端部署简化版

推荐阿里云轻量应用服务器部署，选择'应用镜像→OpenClaw 2026 新手版'，最低配置 2vCPU+2GiB 内存即可。放通 18789 端口，远程连接服务器执行 docker ps | grep openclaw 查看容器状态。

三、核心操作：常用指令与场景

3.1 基础指令

查看系统状态：帮我查看 OpenClaw 的运行状态，以及当前连接的模型。
文件操作：帮我创建一个名为 openclaw_test 的文件夹，然后在里面新建一个 txt 文件。
网页操作：帮我打开百度，搜索'OpenClaw 最新技能'，并把搜索结果总结给我。
日程管理：帮我添加一个明天下午 3 点的会议。

3.2 典型场景实操

场景 1：自动化清理邮箱 指令：帮我清理收件箱，删除所有来自广告邮箱的邮件，把标题包含'工作'的邮件标记为已读。

场景 2：远程控制电脑操作 指令：帮我远程打开电脑上的微信，发送一条消息给'张三'，内容是'明天的会议推迟到下午 4 点'。

3.3 技能管理

技能是 OpenClaw 的核心扩展方式，新手必装 3 个基础技能：

tavily-search：联网搜索技能。
agent-browser：浏览器自动化技能。
shell-skills：系统命令执行技能。

安装命令示例：

clawhub install tavily-search
clawhub install shell-skills

查看已安装技能：openclaw skills list

四、深度解析：核心架构与工作原理

4.1 六大核心子系统架构

Gateway（网关层）：常驻后台 Node.js 进程，负责监听消息、标准化处理指令。
Router（路由层）：根据规则将用户指令分配给对应的 Agent 实例。
Agent Loop（智能体循环）：遵循 Lobster 智能体循环模式，实现'思考 - 执行 - 观察 - 反馈'闭环。
Brain（推理层）：负责与大语言模型交互，支持多模型热切换。
Memory（记忆层）：采用'文件即状态'设计，存储为本地 Markdown/YAML 文件。
Scheduler（调度层）：实现主动式服务，支持心跳模式和定时模式。

4.2 核心工作流程

以'预订餐厅'为例：

用户在 Telegram 发送指令。
Gateway 接收消息，Router 分配给主 Agent。
Agent Loop 拆解任务（搜索、筛选、预订）。
调用技能执行操作（tavily-search, agent-browser）。
获取结果并反馈给用户。
Memory 层更新用户偏好。

五、进阶技巧：自定义技能与安全优化

5.1 自定义技能

OpenClaw 的技能本质是脚本文件，支持 JavaScript/Python。以下是一个简单的'每日天气提醒'技能示例：

// 技能名称：daily-weather
module.exports = {
  name: "daily-weather",
  description: "每日天气提醒",
  schedule: "0 8 * * *", // 每日 8 点执行
  async run(agent) {
    const weather = await agent.tools.web.search("今日本地天气");
    await agent.channels.send("telegram", `今日天气：${weather}，记得增减衣物哦～`);
    agent.memory.set("weather_preference", "每日 8 点提醒");
  },
};

将脚本保存至 ~/.openclaw/skills/daily-weather 目录，执行 openclaw skills reload 启用。

5.2 安全优化

由于 OpenClaw 拥有设备操作权限，推荐以下设置：

渐进式授权：初次仅给予只读权限。
开启操作日志：执行 openclaw security audit --deep。
沙箱隔离：在配置文件中开启沙箱模式。

六、常见问题排查

问题 1：Gateway 启动失败，提示端口 18789 被占用 解决方案：修改配置文件 ~/.openclaw/openclaw.json，将端口改为 18790，重启服务。
问题 2：聊天渠道无响应 解决方案：检查网络连通性，重启渠道服务：openclaw channels restart telegram。
问题 3：API Key 无效，模型调用失败 解决方案：检查 API Key 是否完整，重新生成并配置。
问题 4：Windows 系统部署后无法正常运行 解决方案：安装 WSL2，在 WSL2 内重新部署。

七、总结

OpenClaw 的核心价值是将 AI 从聊天工具升级为执行工具。通过本地优先、持续记忆、高度可扩展的特点，真正成为用户的贴身数字员工。建议新手先完成本地部署，熟悉基础指令，再逐步尝试安装技能、自定义配置。

OpenClaw 入门指南：从零部署到核心原理与实操