# openclaw-guide-zh

**Repository Path**: xia-weikun/openclaw-guide-zh

## Basic Information

- **Project Name**: openclaw-guide-zh
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-30
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw 中文手册

[OpenClaw](https://github.com/nicepkg/openclaw) 是一个开源的 AI Agent 框架，让你可以用自然语言驱动各种操作 — 写代码、管理服务器、操作浏览器、发送消息等等。

本仓库是 OpenClaw 官方文档的中文社区翻译版，目标是为中文用户提供一份实用、易读的参考手册。

## 📚 文档导航

### 🚀 入门

| 文档 | 说明 |
|------|------|
| [快速开始](start/quickstart.md) | 5 分钟跑通 OpenClaw |
| [入门指南](start/getting-started.md) | 完整的安装和配置流程 |
| [向导](start/wizard.md) | 交互式配置向导 |
| [初始设置](start/setup.md) | 基础配置 |
| [引导](start/onboarding.md) | 首次使用指南 |

### 🧠 核心概念

| 文档 | 说明 |
|------|------|
| [Agent](concepts/agent.md) | Agent 是什么、怎么工作 |
| [会话](concepts/session.md) | 会话管理和生命周期 |
| [记忆](concepts/memory.md) | Agent 的记忆系统 |
| [模型](concepts/models.md) | 模型配置和选择 |
| [架构](concepts/architecture.md) | 系统架构设计 |
| [系统提示词](concepts/system-prompt.md) | System Prompt 机制 |
| [上下文](concepts/context.md) | 上下文管理 |

### ⚙️ 配置

| 文档 | 说明 |
|------|------|
| [配置说明](gateway/configuration.md) | Gateway 配置基础 |
| [配置参考](gateway/configuration-reference.md) | 完整配置项参考 |
| [配置示例](gateway/configuration-examples.md) | 常用配置示例 |

### 💻 CLI 命令

| 文档 | 说明 |
|------|------|
| [命令总览](cli/index.md) | 所有命令一览 |
| [setup](cli/setup.md) | 初始设置 |
| [onboard](cli/onboard.md) | 引导流程 |
| [gateway](cli/gateway.md) | Gateway 管理 |
| [cron](cli/cron.md) | 定时任务 |
| [sessions](cli/sessions.md) | 会话管理 |
| [models](cli/models.md) | 模型管理 |
| [config](cli/config.md) | 配置管理 |
| [skills](cli/skills.md) | 技能管理 |
| [doctor](cli/doctor.md) | 诊断工具 |
| [status](cli/status.md) | 状态查看 |

### 📱 渠道

| 文档 | 说明 |
|------|------|
| [飞书](channels/feishu.md) | 飞书（Lark）集成 |
| [Discord](channels/discord.md) | Discord 集成 |
| [Telegram](channels/telegram.md) | Telegram 集成 |
| [WhatsApp](channels/whatsapp.md) | WhatsApp 集成 |
| [Signal](channels/signal.md) | Signal 集成 |

### 🔧 工具

| 文档 | 说明 |
|------|------|
| [exec](tools/exec.md) | 命令执行 |
| [Browser](tools/browser.md) | 浏览器自动化 |
| [Skills](tools/skills.md) | 技能系统 |
| [Subagents](tools/subagents.md) | 子 Agent |
| [Thinking](tools/thinking.md) | 推理模式 |
| [Web](tools/web.md) | 网页搜索 |
| [Web Fetch](tools/web-fetch.md) | 网页抓取 |
| [Slash Commands](tools/slash-commands.md) | 斜杠命令 |

### 🤖 自动化

| 文档 | 说明 |
|------|------|
| [Cron 任务](automation/cron-jobs.md) | 定时任务 |
| [Hooks](automation/hooks.md) | 钩子机制 |
| [Poll](automation/poll.md) | 轮询机制 |

### 🧩 模型提供商

| 文档 | 说明 |
|------|------|
| [OpenAI](providers/openai.md) | OpenAI |
| [Anthropic](providers/anthropic.md) | Anthropic (Claude) |
| [小米](providers/xiaomi.md) | 小米大模型 |
| [OpenRouter](providers/openrouter.md) | OpenRouter |
| [DeepSeek](providers/deepseek.md) | DeepSeek |
| [通义千问](providers/qwen.md) | 阿里通义千问 |

### 📦 安装

| 文档 | 说明 |
|------|------|
| [安装概览](install/index.md) | 安装方式一览 |
| [Node.js](install/node.md) | 通过 npm 安装 |
| [Docker](install/docker.md) | Docker 部署 |
| [更新](install/updating.md) | 版本更新 |

### 🖥️ 平台

| 文档 | 说明 |
|------|------|
| [Windows](platforms/windows.md) | Windows 平台 |
| [Linux](platforms/linux.md) | Linux 平台 |
| [macOS](platforms/macos.md) | macOS 平台 |

### 📝 参考模板

| 模板 | 说明 |
|------|------|
| [AGENTS.md](reference/templates/AGENTS.md) | Agent 行为配置 |
| [SOUL.md](reference/templates/SOUL.md) | Agent 人格定义 |
| [USER.md](reference/templates/USER.md) | 用户信息 |
| [TOOLS.md](reference/templates/TOOLS.md) | 本地工具配置 |
| [HEARTBEAT.md](reference/templates/HEARTBEAT.md) | 心跳任务配置 |

## 🔗 相关链接

- [OpenClaw GitHub](https://github.com/nicepkg/openclaw)
- [OpenClaw 官方文档（英文）](https://docs.openclaw.ai)
- [NPM 包](https://www.npmjs.com/package/openclaw)

## 📖 使用说明

### 在线阅读

你可以直接在 Gitee 上浏览本仓库中的文档。

### 本地使用

```bash
# 克隆仓库
git clone https://gitee.com/xia-weikun/openclaw-guide-zh.git

# 使用你喜欢的 Markdown 编辑器打开
code openclaw-guide-zh
```

### 配合 OpenClaw 使用

安装 OpenClaw 后，你可以用以下命令打开官方文档：

```bash
openclaw docs
```

## 🤝 贡献指南

欢迎贡献！如果你发现翻译问题或想补充文档：

1. Fork 本仓库
2. 创建特性分支（`git checkout -b improve-docs`）
3. 提交修改（`git commit -m '改进 xxx 文档翻译'`）
4. 推送到分支（`git push origin improve-docs`）
5. 创建 Pull Request

### 翻译规范

- 文件名保持英文（如 `getting-started.md`）
- 内容用中文，保持自然流畅的表达
- 保留代码块和命令原文，不翻译
- 专有名词保留英文（如 Agent、Gateway、Session 等）
- 技术术语首次出现时可以加括号标注英文

## ⚠️ 免责声明

本手册是社区维护的中文翻译版，可能滞后于官方英文文档。如需最新信息，请参考[官方文档](https://docs.openclaw.ai)。

## 📄 许可证

本翻译文档遵循与 OpenClaw 相同的开源协议。