back
loading skill details...
中国本地化工具包:中文搜索、天气查询、飞书/微信/钉钉集成。让中国用户零门槛使用 OpenClaw。
# China Localization Pack v2 - 中国本地化包(安全优化版)
**全中文界面 + 本地服务集成 + 百度搜索支持**
> 🛡️ **安全认证**: 符合 ClawHub 安全规范,无硬编码敏感信息
## 🌟 功能特性
- 🀄 **中文语言包** - 全中文界面和提示
- 🔍 **百度搜索集成** - 专为中国用户优化的中文搜索
- 📅 **飞书集成** - 日历/任务/文档/会议
- 🌤️ **本地天气** - 中文天气查询
- 💬 **微信/钉钉集成** - 消息推送(可选)
- 🗺️ **高德地图** - 地理服务(可选)
- 💳 **支付宝集成** - 支付服务(可选)
## 🔒 安全特性
- ✅ **无硬编码 API keys** - 所有敏感信息通过环境变量配置
- ✅ **符合 ClawHub 安全规范** - 已通过安全扫描
- ✅ **明确的凭证声明** - `_meta.json` 中声明所有必需和可选凭证
- ✅ **环境变量驱动** - 安全的配置管理方式
## 📥 安装
```bash
# 克隆到 dev-skills 目录(开发中版本)
git clone https://github.com/vincentlau2046-sudo/china-localization.git /home/Vincent/.openclaw/workspace/dev-skills/china-localization-v2
# 安装依赖
cd /home/Vincent/.openclaw/workspace/dev-skills/china-localization-v2
npm install
```
## ⚙️ 配置
### 环境变量配置
创建 `.env` 文件或设置环境变量:
```bash
# 必需的凭证
TAVILY_API_KEY=tvly-your-api-key
# 可选的本地服务集成
FEISHU_ENABLED=true
FEISHU_APP_ID=cli_xxxxx
FEISHU_APP_SECRET=xxxxx
WECHAT_ENABLED=true
WECHAT_APP_ID=wx_xxxxx
WECHAT_APP_SECRET=xxxxx
DINGTALK_ENABLED=true
DINGTALK_WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxxxx
AMAP_ENABLED=true
AMAP_API_KEY=xxxxx
ALIPAY_ENABLED=true
ALIPAY_APP_ID=xxxxx
ALIPAY_PRIVATE_KEY=xxxxx
ALIPAY_PUBLIC_KEY=xxxxx
ALIPAY_SANDBOX=true
```
### 在 OpenClaw 中使用
将环境变量添加到 OpenClaw 配置中:
```bash
# 编辑 ~/.openclaw/.env 文件
echo "TAVILY_API_KEY=tvly-your-api-key" >> ~/.openclaw/.env
echo "FEISHU_ENABLED=true" >> ~/.openclaw/.env
# ... 添加其他需要的环境变量
```
## 🚀 用法
### 基础使用
```typescript
import ChinaLocalization from './china-localization';
const local = new ChinaLocalization();
// 设置语言(默认为中文)
local.setLanguage('zh-CN');
// 获取飞书日历
const events = await local.getCalendarEvents();
// 获取飞书任务
const tasks = await local.getTasks();
// 中文搜索(默认使用百度搜索)
const results = await local.search('AI 新闻');
// 使用 Tavily 搜索
const tavilyResults = await local.search('AI 新闻', { engine: 'tavily' });
// 查询天气
const weather = await local.getWeather('深圳');
```
### 在 OpenClaw 中使用
```bash
# 安装后自动可用(需要正确配置环境变量)
china-localization --help
```
## 🔍 搜索引擎对比
| 引擎 | 优势 | 适用场景 |
|------|------|----------|
| **百度搜索** | 中文内容覆盖全面,本土化强 | 国内政策、中文社区、国产技术 |
| **Tavily** | 英文内容质量高,技术文档丰富 | 国际资讯、技术论文、架构分析 |
| **微信搜索** | 微信生态内容 | 公众号文章、小程序内容 |
## 📊 输出示例
### 飞书日历
```markdown
## 📅 今日安排
- **10:00-11:00** 团队周会 @ 会议室
- **14:00-15:00** 产品评审
```
### 飞书任务
```markdown
## ✅ 待办事项
- ⬜ 🔴 完成代码审查 (截止:today)
- ⬜ 🟡 准备周报 (截止:tomorrow)
```
### 天气查询
```markdown
## 🌤️ 深圳天气
- **温度**: 25°C
- **天气**: 晴
- **湿度**: 60%
- **建议**: 天气不错,适合出行,阳光较强,注意防晒
```
### 百度搜索结果
```markdown
## 🔍 AI 新闻 (百度搜索)
1. **【AI 新闻】人工智能最新进展 - 百度**
- 内容: 这是关于 "AI 新闻" 的百度搜索结果...
- [查看详情](https://www.baidu.com/s?wd=AI%20%E6%96%B0%E9%97%BB)
2. **【AI 新闻】大模型技术突破 - 百度**
- 内容: 最新的人工智能大模型技术突破...
- [查看详情](https://www.baidu.com/s?wd=AI%20%E6%96%B0%E9%97%BB)
```
## 📦 依赖
- Node.js 18+
- Tavily Search API (必需)
- 飞书开放平台(可选)
- 微信开放平台(可选)
- 钉钉开放平台(可选)
- 高德地图 API(可选)
- 支付宝开放平台(可选)
## 🛡️ 错误处理
- **网络失败**:中文错误提示 + 重试建议
- **权限不足**:引导用户授权 + 配置指南
- **API 失败**:友好提示 + 调试信息
- **配置缺失**:明确的环境变量设置指引
## 📈 版本历史
- **v2.0.0**: 安全优化版,集成百度搜索,符合 ClawHub 规范
- **v1.0.0**: 初始版本(存在安全问题)
## ❓ 常见问题
### Q: 如何获取飞书 API 权限?
A: 访问 https://open.feishu.cn/app 创建应用,申请权限。
### Q: 百度搜索和 Tavily 搜索有什么区别?
A: 百度搜索更适合中文内容和国内资讯,Tavily 搜索更适合英文技术内容和国际资讯。
### Q: 可以只使用语言包吗?
A: 可以,语言包是独立的模块,不需要配置任何 API keys。
### Q: 为什么需要设置这么多环境变量?
A: 这是为了安全考虑。所有敏感信息都通过环境变量配置,避免在代码中硬编码。
## 🤝 贡献
欢迎提交 Issue 和 Pull Request!
## 📄 许可证
MIT License
## ⭐ 如果觉得有用,请给个 Star!
这个技能让中国用户能够零门槛使用 OpenClaw,如果你觉得有用,请在 ClawHub 上给个 Star!don't have the plugin yet? install it then click "run inline in claude" again.