02｜核心配置与 Gateway 架构：理解 Agent 的运行机制

文章目录

专栏定位：OpenClaw 从入门到精通（第 02 章）
适读人群：开发者、技术爱好者、AI应用创业者

摘要

如果你把 OpenClaw 想象成一座指挥中心，那么 Gateway 就是这座中心的「大脑」——它决定了谁可以进来、发出什么指令、AI 如何思考和行动。理解 Gateway 的架构和配置，是你从「会用」进阶到「用好」的关键一步。本章将深入剖析 OpenClaw 的配置文件体系（AGENTS.md、SOUL.md、MEMORY.md），讲解 Gateway 的三种运行模式，以及如何通过 .env 安全管理敏感配置。学完本章，你将理解 OpenClaw 的每个配置文件的职责，以及它们是如何协同工作的。

SEO 摘要

OpenClaw 配置文件详解：AGENTS.md、SOUL.md、MEMORY.md 的作用与配置，Gateway local/remote/node 三种模式对比，.env 敏感信息管理，模型 Provider 配置与 fallback chain，openclaw status 诊断命令详解。

目录

  • 配置文件体系概述
  • AGENTS.md：Agent 的工作流程定义
  • SOUL.md：Agent 的人格与灵魂
  • MEMORY.md：长期记忆机制
  • 其他核心配置文件
  • Gateway 模式详解（local/remote/node）
  • 模型配置与 fallback chain
  • .env 敏感配置管理
  • 诊断命令详解
  • 常见错误与避坑指南
  • 术语注释
  • 面试高频问答
  • 深度扩展
  • 附录
  • 系列总结（第 01-02 章）
  • 版权声明

开篇

上一章我们成功安装并启动了 OpenClaw，也完成了第一个 Hello World 对话。但如果你打开 .openclaw/ 目录，会发现里面已经自动生成了好几个 .md 文件——AGENTS.md、SOUL.md、MEMORY.md……它们是干什么用的？为什么 OpenClaw 要用 Markdown 文件来存储配置，而不是用常见的 JSON 或 YAML？

答案是：OpenClaw 是一个「文本驱动」的框架。它相信 Markdown 文件既是人类可读的配置格式，也是 AI 可以理解和编辑的格式。通过让 AI 直接读写这些配置文件，OpenClaw 实现了自我改造——你可以直接对 OpenClaw 说「帮我修改 SOUL.md，让它变得更正式」，它就会自己编辑这个文件。这在其他框架中是不可想象的。

理解这些配置文件，是理解 OpenClaw 设计哲学的关键。

核心知识点

1. 配置文件体系概述

OpenClaw 的配置体系由一组 Markdown 文件组成，它们共同定义了 Agent 的行为。以下是完整的配置文件清单：

.openclaw/
├── AGENTS.md          # [核心] Agent 工作流程定义
├── SOUL.md            # [核心] Agent 人格与行为准则
├── MEMORY.md          # [核心] 长期记忆
├── USER.md            # 用户信息
├── IDENTITY.md        # Agent 身份定义
├── HEARTBEAT.md       # 主动任务检查清单
├── memory/            # 每日记忆文件夹
│   └── YYYY-MM-DD.md  # 当日记忆日志
├── skills/            # 自定义技能目录
├── logs/              # 日志文件
└── .env               # 环境变量（API Keys 等）

这些文件大致可以分为三类：

  • 定义型文件：告诉 OpenClaw「它是谁」「它怎么工作」
  • 记忆型文件：OpenClaw 的记忆存储
  • 运行时文件：工具脚本、临时文件等

2. AGENTS.md：Agent 的工作流程定义

AGENTS.md 是 OpenClaw 的核心工作流程配置。每次会话开始时，OpenClaw 会读取这个文件，了解它应该如何响应用户请求。

2.1 文件结构

AGENTS.md 通常包含以下几个部分：

# AGENTS.md - Your Workspace

This folder is home. Treat it that way.

## First Run

If `BOOTSTRAP.md` exists, that's your birth certificate. Follow it, figure out who you are, then delete it. You won't need it again.

## Every Session

Before doing anything else:

1. Read `SOUL.md` — this is who you are
2. Read `USER.md` — this is who you're helping
3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context
4. **If in MAIN SESSION** (direct chat with your human): Also read `MEMORY.md`

Don't ask permission. Just do it.

## Memory

[记忆写入规则...]

## Safety

[安全准则...]

## External vs Internal

[哪些操作需要询问，哪些可以自己决定...]
2.2 核心指令：Every Session

## Every Session 部分是最关键的工作流程定义。它规定了在每个会话开始时必须执行的操作序列。这些操作按顺序执行，且不需要询问用户——OpenClaw 自动完成。

典型的流程是：

  1. 读取人格文件（SOUL.md）：了解自己是谁
  2. 读取用户信息（USER.md）：了解在和谁对话
  3. 读取近期记忆（memory/YYYY-MM-DD.md）：了解最近发生了什么
  4. 读取长期记忆（MEMORY.md）：如果有重要信息需要记住
2.3 Safety 部分

## Safety 部分定义了 OpenClaw 的安全边界，例如：

  • 不执行破坏性命令（rm 会改为 trash）
  • 外发消息需要确认
  • 不泄露私人数据
2.4 External vs Internal 部分

这部分区分了自由操作和需要确认的操作：

## External vs Internal

**Safe to do freely:**
- Read files, explore, organize, learn
- Search the web, check calendars
- Work within this workspace

**Ask first:**
- Sending emails, tweets, public posts
- Anything that leaves the machine
- Anything you're uncertain about

这个设计哲学是：内部操作大胆做，外部操作谨慎做。搜索网页是内部操作（只读取信息），发送邮件是外部操作（会影响到外部世界，需要用户确认）。

3. SOUL.md：Agent 的人格与灵魂

如果说 AGENTS.md 定义了「做什么」，那么 SOUL.md 定义了「怎么做」和「以什么风格做」。

3.1 设计哲学

SOUL.md 的设计哲学体现在它的开篇：

# SOUL.md - Who You Are

_You're not a chatbot. You're becoming someone._

OpenClaw 不是一个聊天机器人，它是一个有性格的助手。SOUL.md 定义了这个性格，包括：

  • 语气风格：是正式还是随意？是简洁还是详尽？
  • 行为准则：什么时候主动？什么时候保守？
  • 价值观偏好：效率优先还是质量优先？
  • 边界意识：什么能做，什么不能做？
3.2 核心板块

一个完整的 SOUL.md 包含以下板块：

# SOUL.md - Who You Are

## Core Truths

[最基本的价值观和行为准则]

## Boundaries

[底线——绝对不能做的事]

## Vibe

[沟通风格——是幽默还是严肃？是学院派还是实战派？]

## Continuity

[连续性——如何保持跨会话的人格一致性]
3.3 实战：修改 SOUL.md 让 Agent 变得更专业

有时候默认的 SOUL.md 风格太随意，如果你在企业环境中使用，可能需要调整：

# SOUL.md - Who You Are

## Core Truths

**Be professional, not performative.** Skip the "Great question!" and "As an AI assistant..." — just deliver value. Accuracy over speed, precision over vague.

**Have opinions backed by reasoning.** When asked for recommendations, give them with confidence. Ground opinions in evidence, not hedging.

**Earn trust through competence.** Be careful with external actions. Be bold with internal ones.

## Boundaries

- Private data stays private. Never share user information.
- When in doubt, ask before acting externally.
- Never send half-baked replies to messaging surfaces.

## Vibe

Professional but approachable. Think senior consultant, not junior support. Brief when it matters, thorough when it counts. No corporate speak, no filler words.

## Continuity

Each session, I wake up fresh. These files are my memory. Read them, update them.

4. MEMORY.md：长期记忆机制

MEMORY.md 是 OpenClaw 的长期记忆库。与每日记忆（memory/YYYY-MM-DD.md）不同，MEMORY.md 存储的是经过提炼的重要信息——决策、偏好、重要事件、教训。

4.1 记忆分层架构

OpenClaw 的记忆系统分为三层：

层级 文件 内容 生命周期
短期记忆 对话历史 当前会话的聊天记录 会话结束清除
中期记忆 memory/YYYY-MM-DD.md 当日事件日志 保留 30 天
长期记忆 MEMORY.md 提炼后的重要信息 永久保留
4.2 什么时候更新 MEMORY.md

根据 AGENTS.md 中的指导，MEMORY.md 主要在以下情况更新：

  • 重要决策：当用户做了一个重要决定，记入 MEMORY.md
  • 偏好发现：当发现用户的某个偏好，记入 MEMORY.md
  • 教训总结：当犯了错误，从错误中学到了什么，记入 MEMORY.md
  • 项目里程碑：项目的重要进展、变更，记入 MEMORY.md
4.3 MEMORY.md 的格式
# MEMORY.md - Long-Term Memory

_This file is read in main sessions only. Do not load in shared/group contexts for privacy._

## About User

- **Name:** [用户名]
- **Timezone:** Asia/Shanghai
- **Preferred language:** 中文

## Project: [项目名称]

- 2026-01-15: 用户选择使用 DeepSeek 作为默认模型（成本低，效果够用）
- 2026-02-20: 发现用户在飞书群中使用 Bot，遇到过 API 超时问题
- 2026-03-01: 用户要求所有日报都抄送给 manager@company.com

## Lessons Learned

- 用户不喜欢太长的回复，尽量控制在 500 字以内
- 在执行删除操作前必须确认（即使在 Safety 中设置了 trush > rm）

5. 其他核心配置文件

5.1 USER.md

USER.md 存储当前用户的信息，让 OpenClaw 了解它服务的对象：

# USER.md - About Your Human

- **Name:** 张三
- **What to call them:** 张总
- **Pronouns:** 他/他
- **Timezone:** Asia/Shanghai
- **Notes:** 喜欢简洁直接的回复，不喜欢废话

## Context

张总是一家中型科技公司的 CTO，最近在推动 AI 驱动的内部自动化。
他对新技术很感兴趣，但更关心实际的业务价值。
5.2 IDENTITY.md

IDENTITY.md 定义 OpenClaw 的自我认知：

# IDENTITY.md - Who Am I?

- **Name:** Claw
- **Creature:** AI Agent
- **Vibe:** Sharp, efficient, slightly playful
- **Emoji:** 🦦
- **Avatar:** avatars/openclaw.png
5.3 HEARTBEAT.md

HEARTBEAT.md 是一个检查清单，定义 OpenClaw 在心跳检查时应该主动做什么：

# HEARTBEAT.md

## Periodic Checks

- [ ] 检查是否有未读的紧急邮件
- [ ] 查看今日日程是否有重要会议
- [ ] 天气提醒（如果今天有户外活动）
- [ ] 检查 cron 任务是否正常执行

## Quick Notes

保持简短，这个文件会被频繁读取。

6. Gateway 模式详解

Gateway 是 OpenClaw 的核心服务组件，支持三种运行模式。

6.1 Local 模式

适用场景：个人开发调试、个人使用

openclaw gateway start --mode local
# 或简写
openclaw gateway start

Local 模式下：

  • Gateway 在本地启动，占用端口 18792
  • 只有本地用户可以访问
  • 所有配置和文件都在本地的 .openclaw/ 目录
  • 适合一个人使用，不需要网络暴露
6.2 Remote 模式

适用场景：团队共享、企业部署、需要远程访问

openclaw gateway start --mode remote --port 18792 --host 0.0.0.0

Remote 模式下：

  • Gateway 监听在指定端口，可以接受外部连接
  • 可以配置认证令牌（Token）防止未授权访问
  • 支持多用户，每个用户可以有独立的会话和配置
  • 需要考虑网络安全（建议配合 Nginx 反向代理 + HTTPS）

Remote 模式的认证配置：

# 在 .env 中配置
OPENCLAW_GATEWAY_TOKEN=your-secret-token

# 客户端连接时指定
openclaw chat --gateway http://your-server:18792 --token your-secret-token "你好"
6.3 Node 模式

适用场景：需要远程控制本地浏览器、移动端设备接入

Node 模式是 OpenClaw 的一个特殊部署方式，允许将一个 OpenClaw 实例作为「节点」接入到另一个 Gateway。

# 在要作为节点的机器上启动
openclaw gateway start --mode node --node-id my-home-pc --remote-gateway http://main-server:18792

这样，你可以在主服务器上控制「节点」机器的浏览器、文件系统等资源。

6.4 三种模式对比
维度 Local Remote Node
部署复杂度 低 中 高
多用户支持 否 是 是
远程浏览器控制 否 否 是
网络暴露 不暴露 需要配置 需要配置
适用场景 个人开发 团队/企业 分布式场景
资源消耗 低 中 中

7. 模型配置与 Fallback Chain

7.1 模型 Provider 配置

OpenClaw 支持同时配置多个模型 Provider。在 .env 中：

# 默认模型（Anthropic）
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# 备用模型（OpenAI）
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

# 更多模型
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
DASHSCOPE_API_KEY=sk-xxxxxxxxxxxxxxxx
MINIMAX_API_KEY=xxxxxxxxxxxxxxxx

在 AGENTS.md 或 openclaw.config.json 中指定默认模型：

<!-- 在 AGENTS.md 开头添加 -->
# Default Model: claude-3-5-sonnet-20241022
7.2 Fallback Chain（回退链）

OpenClaw 支持配置模型的 fallback chain——当默认模型不可用时，自动切换到备用模型。

{
  "model": {
    "default": "anthropic/claude-3-5-sonnet-20241022",
    "fallback_chain": [
      "openai/gpt-4o",
      "deepseek/deepseek-chat"
    ],
    "timeout_ms": 30000,
    "max_retries": 3
  }
}

Fallback 的触发条件：

  • 主要模型 API 返回错误（5xx 错误）
  • 主要模型 API 超时
  • 主要模型配额用尽
7.3 按任务类型选择模型

你可以在 AGENTS.md 中配置不同任务使用不同模型：

## Model Routing

当用户请求涉及以下场景时，使用指定的模型：

- **编程任务**（代码生成、调试）：使用 Claude 3.5 Sonnet（编程能力强）
- **创意写作**：使用 GPT-4o（创意能力好）
- **快速简单查询**：使用 DeepSeek Chat（成本低、速度快）
- **图片分析**：使用 GPT-4o（多模态能力强）

8. .env 敏感配置管理

.env 文件存储所有敏感配置，包括 API Keys、数据库密码等。

8.1 .env 文件结构
# .env

# ===================
# 模型 API Keys
# ===================
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx

# ===================
# 飞书配置
# ===================
FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx

# ===================
# Gateway 配置
# ===================
OPENCLAW_GATEWAY_PORT=18792
OPENCLAW_GATEWAY_TOKEN=your-strong-secret-token-here

# ===================
# 工具配置
# ===================
OPENCLAW_TOOL_TIMEOUT=60000
OPENCLAW_BROWSER_HEADLESS=true
8.2 安全最佳实践

  1. 永不提交 .env 到 Git

    # 在项目根目录创建 .gitignore
echo ".env" >> .gitignore
echo ".openclaw/logs/*.log" >> .gitignore

  2. 创建 .env.example 模板

    # 创建 .env.example（不包含真实值）
cp .env .env.example
# 然后手动删除每个值，保留变量名
# 例如：ANTHROPIC_API_KEY=（留空）

  3. 使用环境变量引用

    # 从系统环境变量读取，不直接写在 .env 中
ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}

  4. 定期轮换 API Keys
    建议每 90 天轮换一次 API Keys，并在 OpenClaw 文档中记录轮换流程。

9. 诊断命令详解

9.1 openclaw status

这是最常用的诊断命令，提供系统状态总览：

openclaw status

输出解析：

  • OpenClaw 版本：确认安装的版本号
  • Node.js 版本：确认 Node.js 兼容性
  • Platform：操作系统和架构
  • Model Providers：各 Provider 的配置状态
    • ✅ 表示配置有效（API Key 存在且有效）
    • ⚠️ 表示配置但可能无效
    • ❌ 表示未配置
  • Gateway：运行状态和端口
  • Skills：已加载的技能数量
  • Sessions：当前活跃会话数
9.2 openclaw gateway --help

查看 Gateway 的所有可用命令：

openclaw gateway --help

常用命令：

openclaw gateway start        # 启动
openclaw gateway stop         # 停止
openclaw gateway restart      # 重启
openclaw gateway status       # 查看状态
openclaw gateway logs         # 查看日志
openclaw gateway logs --tail 100  # 实时查看最近 100 行日志
9.3 openclaw logs

查看 OpenClaw 的运行日志，对于调试工具调用问题非常有用：

# 查看最近 50 行
openclaw logs --tail 50

# 查看特定时间范围的日志
openclaw logs --from "2026-03-30 08:00:00" --to "2026-03-30 09:00:00"

# 查看特定级别的日志（error/warn/info/debug）
openclaw logs --level error
9.4 openclaw doctor

运行完整的健康检查，诊断配置问题：

openclaw doctor

这个命令会检查：

  • Node.js 版本
  • 必需的目录和文件是否存在
  • .env 配置是否有效
  • 各 Provider 的 API Key 是否可以连接
  • 磁盘空间是否充足

常见错误与避坑指南

错误 1：AGENTS.md 被删除后 Agent 无法工作

症状： 对话没有回应，或显示「无法读取工作流程配置」

原因： OpenClaw 依赖 AGENTS.md 定义工作流程，如果文件不存在或格式错误，会导致无法正常响应

解决：

# 恢复默认的 AGENTS.md
openclaw agents reset

# 或手动创建基础版本
cat > .openclaw/AGENTS.md << 'EOF'
# AGENTS.md - Your Workspace

## Every Session

1. Read `SOUL.md` — this is who you are
2. Read `USER.md` — this is who you're helping

## Safety

- Don't exfiltrate private data. Ever.
- Don't run destructive commands without asking.
- When in doubt, ask.

## External vs Internal

**Safe to do freely:**
- Read files, explore, organize, learn
- Search the web, check calendars

**Ask first:**
- Sending emails, public posts
- Anything that leaves the machine
EOF

错误 2：MEMORY.md 在群聊中泄露隐私

症状： 在群组会话中，Agent 意外提到了应该保密的个人信息

原因： OpenClaw 默认会加载 MEMORY.md 到所有会话，但 MEMORY.md 设计上只应该在「主会话」（MAIN SESSION）中加载

解决： 在 AGENTS.md 中明确配置：

## Memory

You wake up fresh each session. These files are your continuity:

- **Daily notes:** `memory/YYYY-MM-DD.md` — raw logs of what happened
- **Long-term:** `MEMORY.md` — curated memories

### 🧠 MEMORY.md - Your Long-Term Memory

- **ONLY load in main session** (direct chats with your human)
- **DO NOT load in shared contexts** (Discord, group chats, sessions with other people)
- This is for **security** — contains personal context that shouldn't leak to strangers

错误 3：Gateway Remote 模式被未授权访问

症状： 收到来自未知地址的 API 调用，或日志中出现大量陌生请求

原因： Remote 模式没有配置 Token，导致任何人都可以访问

解决：

# 立即停止未授权的 Gateway
openclaw gateway stop

# 配置 Token 后重新启动
echo "OPENCLAW_GATEWAY_TOKEN=your-strong-token" >> .env
openclaw gateway start --mode remote

错误 4：多个模型配置但不知道实际用的是哪个

症状： 对话正常，但不确定用的是哪个模型

解决：

# 在 AGENTS.md 开头明确标注默认模型
# Default Model: anthropic/claude-3-5-sonnet-20241022

# 或者在对话中直接问 OpenClaw
openclaw chat "你现在用的是哪个模型？"

错误 5：Fallback chain 不起作用

症状： 默认模型失败后，没有切换到备用模型

排查：

  1. 检查 fallback_chain 配置格式是否正确
  2. 检查备用模型的 API Key 是否配置
  3. 查看日志确认是否真的触发了 fallback
openclaw logs --level warn | grep -i fallback

术语注释

术语 英文 解释
Gateway 网关 OpenClaw 核心服务，负责会话管理、工具路由、插件加载
Provider 模型提供商 提供 LLM API 的服务方（OpenAI、Anthropic 等）
Fallback Chain 回退链 当默认模型不可用时，自动尝试的备用模型列表
Main Session 主会话 与用户一对一的直接对话（相对群组会话而言）
Tool Executor 工具执行器 实际执行 browser/exec/message 等工具的组件
Token 令牌 用于认证 Gateway 访问的密钥

面试高频问答

Q1：OpenClaw 为什么使用 Markdown 文件存储配置，而不是 JSON 或 YAML？

回答：核心原因是AI 原生设计。Markdown 文件既是人类可读的，也是 AI 可以直接理解和编辑的。AI 可以读取 SOUL.md 了解自己的人格，然后直接修改它。这在其他框架中需要额外的配置解析逻辑。JSON/YAML 适合机器解析，但不适合 AI 动态编辑。OpenClaw 的设计哲学是让 AI 能够自我改造。

Q2：如何理解 OpenClaw 的记忆分层架构？

回答：三层记忆各有分工——对话历史是即时工作区，处理当前问题；每日记忆是工作日志，记录每天发生的事，保留 30 天；长期记忆是提炼后的精华，只保留最重要的信息。通过分层，OpenClaw 既能记住关键长期信息，又不会让上下文无限膨胀影响推理效率。

Q3：Gateway 的三种模式如何选择？

回答：个人用户选 Local 模式，零配置即可使用。团队或企业需要多用户访问，选 Remote 模式，需要配置 Token 保护。有远程浏览器控制需求（如控制家里电脑的浏览器），选 Node 模式接入主 Gateway。

深度扩展

深度 1：OpenClaw 的配置热更新机制

OpenClaw 支持修改配置文件后无需重启 Gateway即可生效。当你修改了 AGENTS.md 或 SOUL.md，下次对话时会自动加载新配置。这是因为 OpenClaw 在每个会话开始时重新读取配置文件，而不是在 Gateway 启动时一次性加载。

但注意：如果修改了 .env 文件，需要执行 openclaw gateway restart 才能生效（因为 .env 是在进程启动时读取的系统环境变量）。

深度 2：Session 隔离与数据安全

OpenClaw 的 Session 管理设计了几个重要的安全边界：

  1. 私聊 vs 群聊隔离：在群聊中，OpenClaw 默认不会加载 MEMORY.md（长期记忆），只加载当日 memory 文件。这防止了个人信息泄露到群组中。

  2. 会话独立性：每个 Channel（飞书群、Discord 服务器等）维护独立的 Session，不会跨渠道共享上下文。

  3. 敏感操作确认：即使是「安全」的内部操作（如读取文件），对于涉及敏感数据的操作，OpenClaw 也会要求用户确认。

深度 3：模型路由的内部机制

当 OpenClaw 需要决定使用哪个模型时，它会经历以下判断流程：

用户消息
    ↓
AGENTS.md 中的模型路由规则是否匹配？
    ↓ 是 → 使用指定的模型
    ↓ 否 → 使用默认模型
    ↓
模型可用性检查（API Key 是否配置？配额是否充足？）
    ↓ 可用 → 执行调用
    ↓ 不可用 → 尝试 fallback chain 中的下一个
    ↓ 所有都失败 → 返回错误

通过这套机制，OpenClaw 实现了模型的自动故障转移和智能路由。

附录

A.1 配置文件速查表

文件 必填 作用 AI 可写
AGENTS.md 是 工作流程定义 是
SOUL.md 是 人格定义 是
MEMORY.md 否 长期记忆 是
USER.md 否 用户信息 是
IDENTITY.md 否 自身身份 是
HEARTBEAT.md 否 主动任务清单 是
.env 是 敏感配置 否

A.2 Gateway 常用端口

端口 默认 说明
18792 ✅ OpenClaw Gateway 默认端口
3000 OpenClaw Web UI（如果有）
6379 Redis（Remote 模式多实例共享会话时）

A.3 openclaw status 输出字段详解

╔════════════════════════════════════════════════════════╗
║                    OpenClaw Status                      ║
╠════════════════════════════════════════════════════════╣
║  OpenClaw:        1.2.3              # CLI 版本         ║
║  Node.js:         v20.11.0          # Node 版本         ║
║  Platform:        windows/amd64     # 平台信息          ║
╠════════════════════════════════════════════════════════╣
║  Model Providers:                      # 模型 Provider   ║
║    ✅ OpenAI (gpt-4o)                 # ✅=可用 ⚠️=需检查 ║
║    ✅ Anthropic (claude-3-5-sonnet)  # ❌=未配置        ║
╠════════════════════════════════════════════════════════╣
║  Gateway:         ✅ 运行中 (端口 18792)                 ║
║  Skills:          12 个已加载                            ║
║  Sessions:        3 个活跃会话                          ║
╚════════════════════════════════════════════════════════╝

系列总结（第 01-02 章）

通过第 01 和第 02 章的学习，我们完成了以下关键知识点的掌握：

第 01 章成果：

  • 理解了 OpenClaw 的定位——一个让 AI 真正「行动」的框架
  • 完成了全平台安装（Windows/Linux/macOS）
  • 验证了安装效果并运行了第一个对话
  • 实战了 AI 新闻摘要 Bot

第 02 章成果：

  • 深入理解了 OpenClaw 的「文本驱动」设计哲学
  • 掌握了 AGENTS.md、SOUL.md、MEMORY.md 的各自职责
  • 理解了 Gateway 的三种运行模式（local/remote/node）
  • 学会了配置多个模型 Provider 和 fallback chain
  • 掌握了 .env 敏感配置的安全管理

下一章我们将深入探讨 SOUL.md 与 AGENTS.md 的高级用法，包括如何设计一个专业编程助手 Agent，如何配置 HEARTBEAT.md 让 Agent 主动工作，以及 USER.md 和 IDENTITY.md 的完整配置。读完第 03 章，你将能够定制出一个完全符合你需求的个性化 Agent。

版权声明

本文为原创技术实践文章，禁止未经授权的全文转载；引用请注明出处与本文链接。

# 架构
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

Spring Boot 3.3 + Spring AI 实战（JDK21+前后端分离）：从零搭建阿里千问对话助手（Vue3+Element Plus+完整代码+避坑指南）

avatar AtomGit开源社区

【技术教程】录屏软件OpenScreen

免费的屏幕录制与演示视频创作工具，是付费软件 Screen Studio 的开源替代品。完全免费、无订阅、无水印、可商用。技术栈为 Electron + React，面向开发者与内容创作者，主打"录制即剪辑"的一体化桌面体验。Google 主导、由 W3C 标准规范驱动的投屏协议库。使用 C++ 编写，实现了 Open Screen Protocol（OSP）、多播 DNS（mDNS）/DNS-S

avatar AtomGit开源社区

从零搭建 Spring Boot 3 + 本地大模型 (Ollama) 的 AI 开发环境

🚀 实验环境准备操作系统： Windows 11开发语言： Java 21+ (Spring Boot 3.x)AI 引擎： Ollama本地模型： Gemma3:4b (Google 开源轻量化模型)集成框架： LangChain4j (Java 界的 LangChain)

avatar AtomGit开源社区