Skip to content

datawhalechina/hand-on-openclaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cover

hand-on-openclaw

《OpenClaw 中文安装与使用手册》

从安装部署到初始化配置、ClawHub、联网、自动化与常用应用场景,帮助中文用户一步一步把 OpenClaw 真正用起来。


项目介绍

很多人第一次接触 OpenClaw,最容易卡住的不是“它能做什么”,而是:

  1. 不知道该怎么装
  2. 不知道 API 应该怎么配
  3. 不知道本地、WSL、Docker、第三方平台到底怎么选
  4. 装好之后,不知道从哪里开始真正把它用起来

这个仓库就是为这些问题准备的。

它不是一份只讲概念的速览,而是一套偏实操、偏中文语境、偏普通用户上手路径的教程集合。你可以把它理解成一份 OpenClaw 中文电子手册雏形。

总入口:


快速开始

如果你是第一次接触 OpenClaw,建议按下面顺序阅读:

  1. 先看 介绍
  2. 安装路线优先选:
  3. 安装完成后先看 OpenClaw 必做的初始化配置
  4. 再继续看 ClawHub 指南应用场景目录

你将收获什么

  • 理解 OpenClaw 到底适合拿来做什么,而不只是把它当成另一个聊天工具
  • 了解 Windows、WSL、Docker、第三方平台几种典型安装路线的差异
  • 学会把常见模型和 API 接入 OpenClaw
  • 能把 OpenClaw 接到飞书、QQ、企业微信、微信等 IM 平台
  • 理解 SOUL.mdIDENTITY.mdUSER.md、ClawHub、Skills、工作区这些概念在实际使用里的作用
  • 通过一组应用场景看懂 OpenClaw 的“连接器 / 胶水层”逻辑

内容导航

安装 OpenClaw

下面这张表把当前安装教程按几个维度做了标注:

  • API配置:是否包含模型或平台 API 配置
  • 推荐度:面向新手上手的主观建议,五星最高
  • 环境:偏本地、云,还是两者都能参考
  • 安全性:仅作为上手层面的相对建议,不代表严格安全审计结论
  • IM接入:是否包含 QQ / 飞书 / 企业微信 / 微信等接入内容
教程 推荐度 适用的操作系统 API配置 环境 安全性 IM接入
clawX安装openclaw(qq、飞书、企微、微信) ★★★★★ Windows 本地 QQ / 飞书 / 企业微信 / 微信
Windows-WSL-飞书群聊入门 ★★★★☆ Windows 本地 飞书
Kimi Claw 与本地 OpenClaw 飞书接入教程 ★★★★☆ Windows / macOS / 云端 本地 / 云均可 飞书
Windows WSL2 + GLM API 接入 OpenClaw ★★★★☆ Windows 本地
LM Studio qwen3.5本地模型接入 OpenClaw ★★★★☆ Windows 本地
openclaw docker配置 ★★★☆☆ Windows / macOS / Linux 本地 飞书
Step 3.5 Flash API Key 与 OpenClaw 配置 ★★★☆☆ Windows / macOS / Linux / 云端 本地 / 云均可
火山豆包模型接入 OpenClaw ★★★☆☆ Windows / macOS / Linux 本地
火山 Coding Plan 小白配置教程 ★★★☆☆ Windows / macOS 本地
阿里云 Coding Plan 接入 OpenClaw ★★★☆☆ Windows / macOS / Linux 本地
macos虚拟机隔离安装 OpenClaw ★★☆☆☆ macOS 本地

使用 OpenClaw

模块 说明
介绍 整体理解这个仓库的阅读路径,以及 OpenClaw 的定位
OpenClaw 必做的初始化配置 理解 SOUL.mdIDENTITY.mdUSER.md,先把助手调教成“你的助手”
ClawHub 指南 学会怎么搜索、安装、更新和安全使用 Skills
15个OpenClaw应用场景 按场景理解 OpenClaw 的能力组合方式

应用场景目录


如何学习这份仓库

这套内容更适合这样使用:

  1. 先跑通一条主链路,不要一开始就同时折腾模型、IM、Skills、自动化
  2. 先解决“能装、能配、能对话”
  3. 再解决“认主、联网、装技能”
  4. 最后再开始把多个能力组合起来用

如果你是普通用户:

  1. 优先看 WSL 或 ClawX
  2. 先接一个稳定模型
  3. 再接飞书或其他 IM

如果你更重视隔离和安全:

  1. 优先看 Docker 或虚拟机隔离方案
  2. 尽量把高权限运行环境和主力工作环境分开

仓库结构


本地预览与部署

如果你想在本地预览这个子项目的网页文档,可以在当前目录执行:

python -m http.server 8080

然后打开:

  • http://localhost:8080/docs/

如果要部署到 GitHub Pages,推荐直接使用仓库分支目录发布:

Settings → Pages → Deploy from a branch → Branch: main → Folder: /docs


如何贡献

欢迎继续补充和完善这份中文教程:

  • 补充更清晰的安装路径
  • 修正文档中的过期步骤
  • 增加更多 API / 模型 / 平台接入方案
  • 增加新的使用场景和踩坑总结

提交前请注意:

  • 不要提交真实密钥、Token、组织信息
  • 涉及外部平台配置时,尽量写清前置条件和限制

开源协议

本项目采用 Apache 2.0 协议。

About

在线学习地址:https://datawhalechina.github.io/hand-on-openclaw/ 想用好openclaw,就来hand-on-openclaw~

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors