OpenClaw：从认知到行动的 AI 智能体架构解析

2.4 交互层

主打'轻量化、多渠道'，用户可通过 Telegram、iMessage 等常用通讯软件下达指令，同时提供可视化 UI 方便配置参数。

三、关键技术实现：从'意图'到'行动'的代码落地

OpenClaw 的核心技术突破，在于将大语言模型的'认知能力'与执行引擎的'操作能力'深度融合。以下结合核心代码示例，拆解其技术实现细节。

3.1 ReAct 循环的落地实现

OpenClaw 的任务执行核心是 ReAct 循环，即'思考→行动→观察→再思考'的闭环。它能根据执行结果动态调整策略，而非机械执行预设指令。

Python 核心逻辑示例

import openclaw.tools as tools
import openclaw.llm as llm

class ReActLoop:
    def __init__(self, user_instruction):
        self.instruction = user_instruction
        self.task_queue = []
        self.task_status = {}
        self.memory = {}

    def parse_intent(self):
        """意图解析：将自然语言指令转化为任务目标和子任务"""
        prompt = f"""
        请将用户指令拆分为可执行的子任务，按执行顺序排列：
        用户指令：{self.instruction}
        要求：每个子任务需明确可调用的工具，格式为 [子任务 ID，子任务描述，工具名称]
        """
        response = llm.call(prompt)
        self.task_queue = self._parse_response_to_tasks(response)
        return self.task_queue

    def _parse_response_to_tasks(self, response):
        """解析大模型响应，生成子任务队列（简化实现）"""
        # 实际场景中这里会解析 LLM 返回的 JSON 结构
        tasks = [
            [1, "筛选邮箱中包含发票的邮件", "email_filter"],
            [2, "从发票邮件中提取发票信息", "invoice_extractor"],
            [3, "打开 Excel 并填写提取的发票信息", "excel_writer"],
            [4, "将 Excel 文件发送至财务邮箱", "email_sender"]
        ]
        return tasks

    def run(self):
        """启动 ReAct 循环，执行所有子任务"""
        self.parse_intent()
        print(f"任务拆解完成，子任务队列：{self.task_queue}")

        for task in self.task_queue:
            task_id, task_desc, tool_name = task
            print(f"\n执行子任务{task_id}：{task_desc}，调用工具：{tool_name}")
            try:
                tool = getattr(tools, tool_name)()
                result = tool.execute(task_desc, self.memory)
                self.task_status[task_id] = "success"
                self.memory[f"task_{task_id}_result"] = result
                print(f"子任务{task_id}执行成功")
            except Exception as e:
                self.task_status[task_id] = "failed"
                print(f"子任务{task_id}执行失败，错误：{str(e)}，正在重试...")
                # 重试逻辑略

        print("\n所有子任务执行完成，任务闭环！")
        return {
            "instruction": self.instruction,
            "task_status": self.task_status,
            "final_result": "发票整理完成，Excel 文件已发送至财务邮箱"
        }

if __name__ == "__main__":
    user_instruction = "整理邮箱里的发票，提取信息填入 Excel 并发送给财务"
    react_loop = ReActLoop(user_instruction)
    result = react_loop.run()
    print(result)

3.2 关键模块：工具调用与记忆管理

系统工具调用：Excel 文件读写

该工具实现了'打开 Excel→填写信息→保存文件'的核心操作，是 OpenClaw 操控本地文件的典型示例。

import pandas as pd
import os

class ExcelWriter:
    def __init__(self):
        self.excel_path = "./invoice_data.xlsx"
        self._init_excel()

    def _init_excel(self):
        if not os.path.exists(self.excel_path):
            df = pd.DataFrame(columns=["发票号码", "发票金额", "开票日期", "邮件来源"])
            df.to_excel(self.excel_path, index=False)
            print(f"初始化 Excel 文件：{self.excel_path}")

    def execute(self, task_desc, memory):
        invoice_info = memory.get("task_2_result", [])
        if not invoice_info:
            raise Exception("未获取到发票信息，无法填写 Excel")

        df = pd.read_excel(self.excel_path)
        new_data = pd.DataFrame(invoice_info)
        df = pd.concat([df, new_data], ignore_index=True)
        df.to_excel(self.excel_path, index=False)
        return f"Excel 填写完成，共添加{len(new_data)}条发票信息"

if __name__ == "__main__":
    excel_tool = ExcelWriter()
    memory = {
        "task_2_result": [
            {"发票号码": "INV20260301", "发票金额": 1200.0, "开票日期": "2026-03-01", "邮件来源": "[email protected]"}
        ]
    }
    result = excel_tool.execute("填写发票信息到 Excel", memory)
    print(result)

记忆模块实现：短期缓存与长期存储

OpenClaw 采用'短期记忆 + 长期存储'的双模架构，以下是核心实现（TypeScript）。

import fs from 'fs';
import path from 'path';

interface MemoryStore {
    get(key: string): any;
    set(key: string, value: any): void;
    clearShortTerm(): void;
    persistLongTerm(): void;
}

class OpenClawMemory implements MemoryStore {
    private shortTerm: Record<string, any>;
    private longTermPath: string;
    private longTerm: Record<string, any>;

    constructor() {
        this.shortTerm = {};
        this.longTermPath = path.join(process.cwd(), "memory", "long_term.json");
        this.longTerm = this._loadLongTerm();
    }

    private _loadLongTerm(): Record<string, any> {
        if (!fs.existsSync(this.longTermPath)) {
            const defaultLongTerm = {
                user_preferences: { excel_format: "xlsx", finance_email: "[email protected]" },
                history_tasks: []
            };
            this._saveLongTerm(defaultLongTerm);
            return defaultLongTerm;
        }
        const data = fs.readFileSync(this.longTermPath, "utf-8");
        return JSON.parse(data);
    }

    private _saveLongTerm(data: Record<string, any>): void {
        const dir = path.dirname(this.longTermPath);
        if (!fs.existsSync(dir)) {
            fs.mkdirSync(dir, { recursive: true });
        }
        fs.writeFileSync(this.longTermPath, JSON.stringify(data, null, 2));
    }

    get(key: string): any {
        return this.shortTerm[key] ?? this.longTerm[key];
    }

    set(key: string, value: any, isLongTerm = false): void {
        if (isLongTerm) {
            this.longTerm[key] = value;
            this._saveLongTerm(this.longTerm);
        } else {
            this.shortTerm[key] = value;
        }
    }

    clearShortTerm(): void {
        this.shortTerm = {};
    }

    persistLongTerm(): void {
        this._saveLongTerm(this.longTerm);
    }
}

const memory = new OpenClawMemory();
memory.set("current_invoice_info", [{"发票号码": "INV20260301", "金额": 1200}]);
memory.set("user_preferences.finance_email", "[email protected]", true);
console.log("短期记忆：", memory.get("current_invoice_info"));
console.log("长期记忆（财务邮箱）：", memory.get("user_preferences.finance_email"));
memory.clearShortTerm();

四、应用场景与产业影响

OpenClaw 解决了 AI 落地的核心痛点——'无法执行'，其应用场景已覆盖个人生产力、企业办公、开发运维等多个领域。

4.1 核心应用场景

• 个人生产力提升：自动抓取热帖生成摘要、整合日历同步任务、批量处理文件。
• 企业办公自动化：财务自动化（筛选发票、填报销单）、客户服务（多渠道回复）、投研自动化（公告抓取、研报生成）。
• 开发运维（DevOps）：代码辅助（生成模板、排查 Bug）、服务器运维（自愈型管理）、工作流编排。

4.2 产业影响

• 降低 AI 落地门槛：开源基础软件栈，加速规模化落地。
• 重构人机交互方式：从'一问一答'变为'指令下达→结果反馈'。
• 推动 AI 生态升级：带动大模型、工具插件、安全防护等领域发展。

五、挑战与未来

尽管前景广阔，OpenClaw 仍面临诸多挑战：

• 安装门槛较高：目前主要面向命令行工具，非技术用户上手有难度。
• 安全与隐私风险：拥有系统底层权限，需防范恶意利用和误操作。
• 任务执行稳定性：复杂场景下可能出现意图解析错误或工具调用失败。

未来趋势将集中在降低使用门槛、强化安全可控性、多智能体协同以及深度融合行业场景等方面。

六、结语

OpenClaw 的核心价值，不在于比 ChatGPT 更'聪明'，而在于打破了 AI 与现实世界的壁垒，让大语言模型的能力从'文本世界'延伸到'物理世界'。虽然仍处于发展初期，但随着技术优化和生态完善，它有望像 Windows 改变个人计算一样，开启 AI'行动时代'的新篇章。