# 🦞 OpenClaw CN — 个人 AI 助手 (中文增强版)

<p align="center">
    <picture>
        <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/openclaw/openclaw/main/docs/assets/openclaw-logo-text-dark.png">
        <img src="https://raw.githubusercontent.com/openclaw/openclaw/main/docs/assets/openclaw-logo-text.png" alt="OpenClaw" width="500">
    </picture>
</p>

**OpenClaw CN** 是 OpenClaw 的中文增强版本，为中国用户提供更好的使用体验，并集成了国内主流的通信渠道和大模型提供商。

## 🎯 特性增强

### 🇨🇳 全面中文化
- ✅ **Web UI 汉化**：完整的中文用户界面
- ✅ **中文文档**：安装指南、配置说明和使用教程
- ✅ **本地化体验**：针对中文用户优化的交互设计

### 🤖 新增大模型支持
- ✅ **DeepSeek**：完整支持 DeepSeek API
  - `deepseek-chat` (V3.2 非思考模式)
  - `deepseek-reasoner` (V3.2 思考模式)
  - 完全兼容 OpenAI API 格式
  - 极具竞争力的价格

### 💬 新增通信渠道

#### 已实现
- 🔵 **企业渠道**（基于官方 API）
  - 钉钉 (DingTalk)
  - 飞书 (Feishu/Lark)
  - 企业微信 (WeChat Work)

#### 计划中
- 🟡 **个人渠道**（基于 OneBot 协议）
  - 微信（通过 OneBot 适配器如 Gewechat）
  - QQ（通过 OneBot 适配器如 NapCatQQ）
  - 华为畅连（开发中）

> **注意**：个人微信和 QQ 需要运行独立的 OneBot 客户端。推荐方案：
> - **QQ**: [NapCatQQ](https://github.com/NapNeko/NapCatQQ), [Lagrange](https://github.com/LagrangeDev/Lagrange.Core)
> - **微信**: [Gewechat](https://github.com/Devo919/Gewechat)

## 核心功能 (继承自 OpenClaw)

- **多渠道消息支持**：连接 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、WebChat 等
- **本地优先网关**：统一的控制平面，管理会话、渠道、工具和事件
- **语音唤醒与对话**：支持 macOS/iOS/Android 上的语音交互
- **实时画布**：代理驱动的可视化工作空间
- **浏览器控制**：通过 Chrome/Chromium 实现网页自动化
- **技能平台**：可扩展的技能系统，支持自定义工具

[完整功能列表](https://docs.openclaw.ai)

## 快速开始

### 环境要求
- **Node.js** ≥ 22
- **操作系统**: macOS, Linux, Windows (推荐 WSL2)

### 安装

```bash
npm install -g openclaw@latest

# 运行安装向导（推荐）
openclaw onboard --install-daemon
```

### DeepSeek 配置示例

在 `~/.openclaw/openclaw.json` 中添加：

```json
{
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "${DEEPSEEK_API_KEY}",
        "api": "openai-responses",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "contextWindow": 64000,
            "maxTokens": 8000
          },
          {
            "id": "deepseek-reasoner",
            "name": "DeepSeek Reasoner (思考模式)",
            "reasoning": true,
            "contextWindow": 64000,
            "maxTokens": 8000
          }
        ]
      }
    }
  },
  "agent": {
    "model": "deepseek/deepseek-chat"
  }
}
```

或使用环境变量：

```bash
export DEEPSEEK_API_KEY=sk-xxxxxxxxx
```

### 启动网关

```bash
# 启动网关
openclaw gateway --port 18789 --verbose

# 发送消息
openclaw agent --message "你好，请介绍一下自己" --model deepseek/deepseek-chat
```

## 文档

- 📘 [DeepSeek 配置指南](docs/zh-CN/deepseek-guide.md)
- 📘 [钉钉配置指南](docs/zh-CN/dingtalk-guide.md) *(即将推出)*
- 📘 [飞书配置指南](docs/zh-CN/feishu-guide.md) *(即将推出)*
- 📘 [官方文档](https://docs.openclaw.ai) (英文)

## 价格优势

DeepSeekV3.2 定价（/百万 tokens）：

| 模型 | 输入 | 输出 | 缓存读 | 缓存写 |
|------|------|------|--------|--------|
| deepseek-chat | $0.14 | $0.28 | $0.014 | $0.14 |
| deepseek-reasoner | $0.55 | $2.19 | - | - |

**相比 Claude 和 GPT 系列，DeepSeek 价格仅为其几分之一，同时性能优异！**

## 安全性

- **默认安全**：DM 配对机制，未知发送者需要批准
- **沙箱模式**：支持 Docker 沙箱运行非主会话
- **权限控制**：基于白名单的渠道访问控制

详见 [安全指南](https://docs.openclaw.ai/gateway/security)

## 贡献

欢迎提交 Pull Request！查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解贡献指南。

## 开源协议

MIT License - 详见 [LICENSE](LICENSE)

## 致谢

- 感谢 [OpenClaw 官方团队](https://github.com/openclaw/openclaw)
- 感谢 Peter Steinberger 和社区贡献者
- 特别感谢 DeepSeek 提供优秀的开源大模型

## 链接

- [OpenClaw 官网](https://openclaw.ai)
- [官方文档](https://docs.openclaw.ai)
- [Discord 社区](https://discord.gg/clawd)
- [GitHub 仓库](https://github.com/openclaw/openclaw)

---

**⚠️ 注意**: 本项目是 OpenClaw 的社区增强版本，主要面向中文用户。如需使用原版 OpenClaw，请访问 [官方仓库](https://github.com/openclaw/openclaw)。