openclaw/README.zh-CN.md

5.0 KiB
Raw Blame History

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

OpenClaw

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 客户端。推荐方案:

核心功能 (继承自 OpenClaw)

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

完整功能列表

快速开始

环境要求

  • Node.js ≥ 22
  • 操作系统: macOS, Linux, Windows (推荐 WSL2)

安装

npm install -g openclaw@latest

# 运行安装向导(推荐)
openclaw onboard --install-daemon

DeepSeek 配置示例

~/.openclaw/openclaw.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"
  }
}

或使用环境变量:

export DEEPSEEK_API_KEY=sk-xxxxxxxxx

启动网关

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

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

文档

价格优势

DeepSeekV3.2 定价(/百万 tokens

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

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

安全性

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

详见 安全指南

贡献

欢迎提交 Pull Request查看 CONTRIBUTING.md 了解贡献指南。

开源协议

MIT License - 详见 LICENSE

致谢

  • 感谢 OpenClaw 官方团队
  • 感谢 Peter Steinberger 和社区贡献者
  • 特别感谢 DeepSeek 提供优秀的开源大模型

链接


⚠️ 注意: 本项目是 OpenClaw 的社区增强版本,主要面向中文用户。如需使用原版 OpenClaw请访问 官方仓库