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

步骤 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 个基础技能：

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

安装命令示例：

clawhub install tavily-search
clawhub install shell-skills

查看已安装技能：openclaw skills list

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

4.1 六大核心子系统架构

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

4.2 核心工作流程

以'预订餐厅'为例：

1. 用户在 Telegram 发送指令。
2. Gateway 接收消息，Router 分配给主 Agent。
3. Agent Loop 拆解任务（搜索、筛选、预订）。
4. 调用技能执行操作（tavily-search, agent-browser）。
5. 获取结果并反馈给用户。
6. 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 拥有设备操作权限，推荐以下设置：

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

六、常见问题排查

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

七、总结

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