OpenClaw 核心流程+核心配置

作为新手学习 OpenClaw，核心是先掌握它的通用底层逻辑——本质是一套「本地 AI 智能体自动化框架」，核心流程是「指令→解析→执行→反馈」的通用闭环，核心配置是围绕「让智能体“能理解、能执行、能交互”」展开的关键模块。

一、先懂 OpenClaw 核心架构（流程和配置的基础）

学习前先明确 OpenClaw 的 5 个核心组件：

组件	核心作用	通俗比喻
网关（Gateway）	核心中枢，负责调度所有组件、管理连接、执行任务分发	公司的“总调度室”
智能体（Agent）	绑定 AI 模型（如 phi3:mini），负责指令解析、任务规划	公司的“大脑/决策层”
技能（Skills）	可插拔的功能插件，负责执行具体操作（文件管理、软件控制等）	公司的“员工/工具手”
配置层（Config）	全局统一配置，管理路径、权限、模型参数、技能规则等	公司的“规章制度”
交互层（Dashboard/终端/API）	用户输入指令、接收反馈的入口	公司的“前台/沟通窗口”

---

二、OpenClaw 通用核心流程（所有场景都适用）

无论用 OpenClaw 做什么（剪视频、写小说、文件管理），核心流程都是以下 5 个阶段的闭环，无场景差异：

阶段 1：启动初始化（前置准备，一次性）

• 核心动作：
  1. 启动网关服务（OpenClaw 的核心进程）；
  2. 加载全局配置文件（~/.openclaw/config.yaml）；
  3. 初始化已配置的 Agent（绑定 AI 模型）；
  4. 加载已安装并启用的 Skills（技能插件）；
  5. 启动交互层（面板/终端监听）。
• 通用命令（验证启动状态）：

  # 启动网关
  openclaw gateway start
  # 查看网关状态（核心！必须显示 running）
  openclaw gateway status
  # 查看已加载的 Agent 和 Skills
  openclaw agents list
  openclaw skills list
  

• 关键特征：启动后网关常驻后台，除非手动停止（openclaw gateway stop），无需重复启动。

阶段 2：指令输入（用户触发，任意方式）

• 核心动作：用户通过任意交互层输入指令，指令会被传递到网关。
• 3 种通用输入方式（所有场景通用）：
  1. 可视化面板（推荐新手）：openclaw dashboard 打开面板，在聊天框输入自然语言指令；
  2. 终端指令（精准控制）：openclaw run task --skill 技能名 --params 参数；
  3. API 调用（进阶开发）：通过网关的 HTTP 接口（默认 http://127.0.0.1:18789）发送指令。
• 示例（通用，无场景）：

  # 终端输入通用指令（执行文件管理技能）
  openclaw run task --skill file-manager --params '{"action":"list","path":"~/Desktop"}'
  

阶段 3：指令解析与任务规划（核心智能环节）

• 核心动作：
  1. 网关将指令转发给已绑定的 Agent（智能体）；
  2. Agent 调用绑定的 AI 模型（如 phi3:mini），解析指令意图（比如“整理文件”→ 意图是“列出文件+分类+移动”）；
  3. AI 模型将自然语言指令拆解为可执行的子任务序列（比如：子任务1=列出桌面文件，子任务2=按类型分类，子任务3=移动到对应文件夹）；
  4. Agent 为每个子任务匹配对应的 Skills（比如“列出文件”匹配 file-manager 技能），生成任务执行计划。
• 关键特征：这一步是“AI 智能”的核心，无需用户干预，模型自动完成拆解和匹配。

阶段 4：任务执行（自动化核心，无人工参与）

• 核心动作：
  1. 网关按照 Agent 生成的执行计划，依次调度对应的 Skills；
  2. Skills 执行具体操作（如调用系统接口列文件、移动文件、控制软件）；
  3. 执行过程中处理异常（如文件不存在、权限不足，会暂停并记录日志）；
  4. 收集每个子任务的执行结果（成功/失败、输出内容）。
• 关键特征：
  • Skills 是“可插拔”的，缺什么功能装什么，不影响核心流程；
  • 执行过程全程自动化，无需用户点击/操作。

阶段 5：结果反馈与闭环（用户感知）

• 核心动作：
  1. 网关汇总所有子任务的执行结果；
  2. Agent 将结果转换成自然语言（或结构化数据）；
  3. 通过交互层反馈给用户（面板聊天框/终端输出/API 响应）；
  4. 记录执行日志（~/.openclaw/logs/），供排查问题。
• 示例反馈（通用）：
  • 面板：“已成功列出桌面文件，共 15 个，其中 5 个文档、3 个视频、7 个图片”；
  • 终端：{"status":"success","data":{"file_count":15,"categories":{"docs":5,"videos":3,"images":7}}}。

流程闭环总结（通用）：

用户输入指令 → Agent 解析规划 → 网关调度 Skills 执行 → 结果反馈给用户 → 日志留存，全程无人工干预，可无限重复。

---

三、OpenClaw 核心配置（6 大通用模块，必学）

配置的核心是“让 OpenClaw 知道：用什么大脑（模型）、有什么手脚（技能）、能操作什么资源（路径/权限）、按什么规则干活（参数）”，以下是所有场景通用的 6 大核心配置模块：

模块 1：基础环境配置（前提，一次性）

• 作用：确保 OpenClaw 依赖的底层环境正常，是所有配置的基础。
• 核心检查项（必须满足）：
  1. Node.js 版本 ≥22.x.x（node -v 验证）；
  2. 已安装并启动 Ollama（ollama --version + ollama serve & 验证）；
  3. 已下载至少 1 个 AI 模型（ollama list 验证，如 phi3:mini）；
  4. OpenClaw 版本 ≥2026.3.7（openclaw --version 验证）。
• 无额外配置命令：只需确保环境达标，OpenClaw 会自动识别。

模块 2：Agent（智能体/模型）配置（核心，决定“理解能力”）

• 作用：绑定 AI 模型，让 OpenClaw 能解析指令、规划任务（无模型=无智能）。
• 核心参数（通用）：

  参数	作用	通用值
  provider	模型提供商	ollama（本地）/ openai（云端）/ anthropic（云端）
  model	模型名称	phi3:mini / llama3:8b / gpt-4o
  endpoint	模型访问地址	本地 Ollama：http://127.0.0.1:11434；云端：对应 API 地址
  is_default	是否设为默认 Agent	true / false

• 通用配置命令：

  # 配置默认 Agent（绑定本地 phi3:mini）
  openclaw agents configure \
    --default \
    --provider ollama \
    --model phi3:mini \
    --endpoint http://127.0.0.1:11434
  # 验证配置（关键！Status 必须为 connected）
  openclaw agents show
  

• 核心原则：优先用本地模型（ollama），隐私性/稳定性远高于云端。

模块 3：技能（Skills）配置（核心，决定“执行能力”）

• 作用：安装/启用/禁用/卸载技能，是 OpenClaw 的“功能扩展核心”。
• 核心操作（通用）：

  操作	命令	示例
  安装技能	openclaw skills install 技能名	openclaw skills install file-manager
  启用技能	openclaw skills enable 技能名	openclaw skills enable file-manager
  禁用技能	openclaw skills disable 技能名	openclaw skills disable file-manager
  卸载技能	openclaw skills uninstall 技能名	openclaw skills uninstall file-manager
  查看所有技能	openclaw skills list	-

• 核心技能（通用，所有场景都可能用到）：
  • file-manager：文件/文件夹管理（列、建、删、移）；
  • system-control：系统操作（启动软件、执行终端命令）；
  • text-processing：文本处理（生成、润色、格式转换）；
  • log-manager：日志管理（查看、清理、导出）。
• 核心原则：“最小安装”——只装需要的技能，减少资源占用。

模块 4：网关（Gateway）配置（中枢，通用参数）

• 作用：配置网关的基础运行规则，如端口、日志级别、启动模式。
• 核心参数（通用）：

  参数	作用	通用值	配置命令
  port	网关端口（面板/API 访问）	默认 18789	openclaw config set gateway.port 18789
  log_level	日志级别（排障用）	info / debug / error	openclaw config set gateway.log_level info
  auto_start	开机自启	true / false	openclaw config set gateway.auto_start true

• 验证配置：

  # 查看网关配置
  openclaw config list | grep gateway
  # 重启网关使配置生效
  openclaw gateway restart
  

模块 5：权限与路径配置（通用，确保“能操作”）

• 作用：配置 OpenClaw 能访问的文件路径、系统权限，避免“有权限但用不了”。
• 核心配置（通用）：
  1. 文件路径配置（告诉 OpenClaw 能操作哪些文件夹）：

     # 配置全局基础路径（示例）
     openclaw config set base.path "~/Documents/OpenClaw"
     # 配置临时文件路径
     openclaw config set temp.path "~/Library/Caches/OpenClaw"
     

  2. 系统权限配置（macOS 通用）：
     • 打开「系统设置→隐私与安全性→辅助功能」，勾选终端/iTerm；
     • 「文件与文件夹」勾选需要操作的路径（如桌面、文档）；
     • 「屏幕录制」（可选，如需识别视频/截图）勾选终端。
• 验证：执行 openclaw run task --skill file-manager --params '{"action":"list","path":"~/Desktop"}'，能列出桌面文件即权限生效。

模块 6：核心配置文件解析（进阶，理解底层）

所有配置最终都会写入 ~/.openclaw/config.yaml（OpenClaw 唯一的全局配置文件），新手可通过命令配置，进阶可直接编辑该文件：

# 核心配置文件示例（关键字段）
gateway:
  port: 18789
  log_level: info
  auto_start: false
agent:
  default:
    provider: ollama
    model: phi3:mini
    endpoint: http://127.0.0.1:11434
skills:
  enabled: ["file-manager", "system-control", "text-processing"]
paths:
  base: ~/Documents/OpenClaw
  temp: ~/Library/Caches/OpenClaw

• 核心原则：修改配置文件后，需重启网关生效（openclaw gateway restart）。

---

四、核心总结（新手必记的 3 个核心）

1. 核心流程（通用闭环）：启动网关→输入指令→Agent 解析规划→Skills 执行→反馈结果，所有场景都遵循这个逻辑；
2. 核心配置（三大支柱）：
   • Agent 配置：绑定 AI 模型，让 OpenClaw “能理解”；
   • Skills 配置：安装功能插件，让 OpenClaw “能执行”；
   • 权限/路径配置：让 OpenClaw “能访问资源”；
3. 核心原则：OpenClaw 是“通用自动化框架”，所有场景的差异仅在于“用什么技能、传什么参数”，底层流程和配置逻辑完全一致