OpenClaw 橙皮书发布：98 页一站式参考手册，从入门到精通

写在前面：本文介绍的《OpenClaw 橙皮书》由 B 站 UP 主「AI 进化论 - 花叔」团队在 Claude Code 辅助下整理编写，是 OpenClaw 社区首份官方参考手册。原文出处：飞书文档（持续更新）。

一、橙皮书是什么？

OpenClaw 橙皮书（OpenClaw Orange Paper）是一份 98 页的一站式参考手册，涵盖：

✅ 架构原理
✅ 部署方案
✅ 渠道接入
✅ Skills 系统
✅ 模型配置
✅ 安全与成本
✅ 生态全景

适用版本：v2026.3.7
发布时间：2026 年 3 月
文档版本：v1.0

二、核心内容速览

Part 1：认识 OpenClaw

章节	内容
01	OpenClaw 是什么
02	发展简史
03	创始人故事
04	为什么这么火

Part 2：技术架构

章节	内容
05	整体架构
06	记忆系统
07	Agent 工作区
08	Session 与用户识别
09	设计哲学

Part 3：部署方案

章节	内容
10	部署方式总览
11	本地安装
12	Docker 部署
13	国内云厂商一键部署
14	首次配置

Part 4：渠道接入

章节	内容
15	渠道概览
16	国际平台接入
17	国内平台接入
18	远程访问

Part 5：Skills 系统

章节	内容
19	Skills 工作原理
20+	更多技能详解（见完整文档）

三、为什么需要橙皮书？

痛点场景

如果你遇到过以下问题：

部署困难：不知道选本地安装、Docker 还是云部署
配置复杂：渠道接入、模型配置、Skills 系统一头雾水
文档分散：GitHub、官方文档、社区讨论四处查找
缺少参考：安全配置、成本优化没有标准答案

橙皮书的价值：一站式解决所有问题。

核心优势

优势	描述
完整性	98 页覆盖所有核心主题
权威性	基于官方文档 + GitHub 仓库 + 社区调研
实用性	包含详细部署步骤和配置示例
时效性	2026 年 3 月最新版，适配 v2026.3.7

四、重点章节解读

1. 架构原理（Part 2）

OpenClaw 的核心架构包括：

┌─────────────────────────────────────────┐
│           渠道层（Channels）             │
│  Telegram | WhatsApp | Discord | 飞书    │
└─────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────┐
│          Gateway（网关层）                │
│   消息路由 | 会话管理 | 安全验证          │
└─────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────┐
│         Agent 工作区（Workspace）         │
│  记忆系统 | Skills | 模型路由 | 工具调用   │
└─────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────┐
│          模型层（Models）                 │
│  GPT-4 | Claude | 本地模型 | 自定义模型   │
└─────────────────────────────────────────┘

关键设计哲学：

模块化：各层独立，可替换
可扩展：Skills 系统支持自定义
安全优先：访问令牌、权限控制

2. 记忆系统（Chapter 06）

OpenClaw 的记忆系统分为三层：

层级	存储位置	用途
短期记忆	Session 上下文	当前对话历史
长期记忆	`MEMORY.md`	用户偏好、重要事件
技能记忆	`~/self-improving/`	执行经验、纠错记录

最佳实践：

主会话加载 MEMORY.md，群聊不加载（安全）
每日复盘更新 memory/YYYY-MM-DD.md
Self-Improving Agent 自动优化执行策略

3. 部署方案（Part 3）

本地安装（适合开发）

1 2	npm install -g openclaw-cn openclaw gateway start

Docker 部署（适合生产）

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ./workspace:/root/.openclaw/workspace \
  ra1nzzz/openclaw:latest

国内云厂商一键部署

腾讯云：云函数 SCF + COS 存储
阿里云：函数计算 FC + OSS 存储
华为云：FunctionGraph + OBS 存储

推荐：生产环境用 Docker，开发环境用本地安装。

4. Skills 系统（Part 5）

Skills 是 OpenClaw 的核心扩展机制：

Skills 目录结构：
/root/.openclaw/workspace/skills/
├── skill-creator/      # 技能创建器
├── self-improving/     # 自我改进 Agent
├── blogwatcher/        # 博客监控器
├── weather/            # 天气查询
└── ...                 # 更多技能

Skills 工作原理：

用户请求 → Gateway 解析
匹配 Skills 触发词
调用对应技能脚本
返回结果到渠道

常用 Skills：

self-improving：自动复盘优化
blogwatcher：监控博客更新
weather：查询天气
github：GitHub 操作
feishu_*：飞书集成

五、快速上手指南

步骤 1：安装 OpenClaw

# 国内用户（推荐）
npm install -g openclaw-cn --registry=https://registry.npmmirror.com

# 验证安装
openclaw --version

步骤 2：启动 Gateway

# 启动服务
openclaw gateway start

# 查看状态
openclaw gateway status

# 查看日志
openclaw gateway logs

步骤 3：配置渠道

编辑 ~/.openclaw/config.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxxxxxx",
      "appSecret": "xxxxxxxxxxxxxxxxx"
    },
    "telegram": {
      "enabled": false,
      "botToken": ""
    }
  }
}

步骤 4：测试验证

# 访问 WebUI
http://localhost:18789

# 访问令牌：在日志中查看

六、资源下载

官方资源

资源	链接
橙皮书 PDF	下载链接
飞书文档	在线阅读
GitHub 仓库	https://github.com/openclaw/openclaw
官方文档	https://docs.openclaw.ai
Discord 社区	https://discord.com/invite/clawd