OpenClaw：从认知到执行的行动型 AI 框架解析

（4）交互层：人类与 AI 的'沟通桥梁'

主打'轻量化、多渠道'，用户可通过 Telegram、iMessage 等常用通讯软件，以语音或文字形式下达指令，同时提供可视化 UI，方便用户配置参数、监控任务执行状态。

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

OpenClaw 的核心技术突破，在于将大语言模型的'认知能力'与执行引擎的'操作能力'深度融合。

3.1 核心执行流程：ReAct 循环的落地实现

OpenClaw 的任务执行核心是 ReAct 循环，即'思考→行动→观察→再思考'的闭环，这也是其区别于普通自动化脚本的关键。

3.1.2 代码示例：ReAct 循环核心逻辑（Python）

以下代码模拟了 OpenClaw 处理'整理邮箱发票并填写 Excel'任务的 ReAct 循环逻辑：

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):
        tasks = [
            [1, "筛选邮箱中包含发票的邮件", "email_filter"],
            [2, "从发票邮件中提取发票信息（号码、金额、日期）", "invoice_extractor"],
            [3, "打开 Excel 并填写提取的发票信息", "excel_writer"],
            [4, "将 Excel 文件发送至财务邮箱", "email_sender"]
        ]
        return tasks

    def run(self):
        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}执行成功，结果：{result[:50]}...")
            except Exception as e:
                self.task_status[task_id] = "failed"
                print(f"子任务{task_id}执行失败，错误：{str(e)}，正在重试...")
                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}重试成功，结果：{result[:50]}...")
        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 关键模块代码实现：工具调用与记忆管理

3.2.1 系统工具调用：Excel 文件读写（Python）

该工具实现了'打开 Excel→填写信息→保存文件'的核心操作：

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)}条发票信息，文件路径：{self.excel_path}"

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

3.2.2 记忆模块实现：短期缓存与长期存储（TypeScript）

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

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]",
                    notification_channel: "telegram"
                },
                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();
console.log("清除后短期记忆：", memory.get("current_invoice_info"));

四、应用场景与产业影响

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

4.1 核心应用场景

• 个人生产力提升：自动抓取热帖生成摘要、整合日历同步任务、批量重命名文件及转换格式。
• 企业办公自动化：自动筛选发票邮件、对接财务系统、整合多渠道通讯工具自动回复咨询。
• 开发运维（DevOps）：生成接口模板、排查代码 Bug、实现自愈型服务器管理及工作流编排。

4.2 产业影响

• 降低 AI 落地门槛：作为开源项目，提供了基础软件栈，加速 AI 技术的规模化落地。
• 重构人机交互方式：未来交互将不再是'一问一答'，而是'指令下达→结果反馈'的极简模式。
• 推动 AI 生态升级：带动大模型、工具插件、安全防护等相关领域的发展。

五、挑战与未来

尽管 OpenClaw 被寄予厚望，但仍面临诸多挑战：

• 安装门槛较高：需要掌握 Node.js 环境配置、API 密钥设置等技术。
• 安全与隐私风险：拥有系统底层权限，若被恶意利用可能导致系统入侵。
• 任务执行稳定性不足：在复杂场景中可能出现意图解析错误或工具调用失败。

未来发展趋势包括降低使用门槛、强化安全与可控性、多智能体协同以及深度融合行业场景。

六、结语

OpenClaw 的核心价值，在于它打破了 AI 与现实世界的壁垒，让大语言模型的能力从'文本世界'延伸到'物理世界'，解决了 AI 落地的'最后 100 米'痛点。随着技术的不断优化、生态的不断完善，OpenClaw 有望改变 AI 与人类的交互方式，开启 AI'行动时代'的新篇章。