kimi-search

# Kimi Search

使用 Kimi 大模型的内置联网搜索工具 `$web_search` 进行联网搜索。

## 前置要求

1. **Moonshot API Key**：需要在 https://platform.moonshot.cn/console 注册并获取 API Key
2. **账户充值**：联网搜索每次额外收费约 ¥0.03，确保账户有余额
3. **Python 环境**：Python 3.8+ 和 `openai` Python 包

## 安装依赖

skill 需要 `openai` Python 包。安装方式：

```bash
pip3 install openai
```

或者使用虚拟环境（推荐）：

```bash
python3 -m venv ~/.openclaw/skills/kimi-search/venv
source ~/.openclaw/skills/kimi-search/venv/bin/activate
pip install openai
```

## 配置 API Key

### 工作原理

本 skill 声明了 `primaryEnv: MOONSHOT_API_KEY`。OpenClaw 会自动将你配置的 `apiKey` 值注入到 `MOONSHOT_API_KEY` 环境变量中供脚本读取。

### 配置方式（推荐）

编辑 `~/.openclaw/openclaw.json`，添加：

```json
{
  "skills": {
    "entries": {
      "kimi-search": {
        "enabled": true,
        "apiKey": "sk-你的APIKey"
      }
    }
  }
}
```

> **安全提示**：`~/.openclaw/openclaw.json` 是用户主目录下的配置文件，权限通常设置为仅用户可读。如需更高安全性，建议使用环境变量方式。

### 使配置生效

```bash
openclaw gateway restart
```

### 替代方案：环境变量

如果你不想将 Key 存储在配置文件中，可以直接设置环境变量：

```bash
export MOONSHOT_API_KEY="sk-你的APIKey"
~/.openclaw/skills/kimi-search/scripts/kimi-search "搜索词"
```

环境变量方式不会在磁盘上留下 Key 记录，适合共享机器或高安全要求场景。

## 使用方法

### 作为 Agent 工具使用

配置完成后，可以直接问 Agent：

> "用 kimi-search 搜一下今天的新闻"

### 直接调用脚本

```bash
~/.openclaw/skills/kimi-search/scripts/kimi-search "搜索关键词"
```

### 示例

```bash
kimi-search "今天有什么新闻"
kimi-search "OpenClaw 是什么"
kimi-search "Python 最新版本特性"
```

## 输出格式

脚本返回 JSON 格式：

```json
{
  "query": "搜索关键词",
  "answer": "搜索结果的回答",
  "usage": {
    "prompt_tokens": 8059,
    "completion_tokens": 1197,
    "total_tokens": 9256
  }
}
```

- `query`：原始搜索词
- `answer`：Kimi 根据搜索结果生成的回答
- `usage`：Token 消耗统...