Kimi Search

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

前置要求

1. 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: MOONSHOTAPIKEY。OpenClaw 会自动将你配置的 apiKey 值注入到 MOONSHOTAPIKEY 环境变量中供脚本读取。

配置方式（推荐）

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

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

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

使配置生效

bash
openclaw gateway restart

替代方案：环境变量

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

bash
export MOONSHOTAPIKEY=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 消耗统计（搜索内容会计入 prompt_tokens）

故障排除

错误：缺少 MOONSHOTAPIKEY

原因：API Key 未正确配置或未注入环境变量
解决：

1. 1. 检查 ~/.openclaw/openclaw.json 中 skills.entries.kimi-search.apiKey 是否填写
2. 重启 Gateway：openclaw gateway restart
3. 或使用环境变量方式运行

错误：Invalid Authentication 或 401

原因：API Key 无效或已过期
解决：

1. 1. 在 Moonshot 控制台检查 Key 状态
2. 重新生成 Key 并更新配置

错误：insufficient_quota 或余额不足

原因：账户余额不足
解决：在 https://platform.moonshot.cn/console 充值

错误：ModuleNotFoundError: No module named openai

原因：缺少 Python 依赖
解决：运行 pip3 install openai

技术说明

• - 模型：kimi-k2.5（256k 上下文窗口）
• 工具：$websearch 内置函数（builtinfunction 类型）
• 工作原理：

• - 参数：temperature=0.6，禁用 thinking 模式以支持 tool calls
• 费用：

• - 性能：搜索结果通常占用 5k-10k tokens，建议用于需要实时信息的场景

安全建议

1. 1. API Key 保护：不要将 Key 提交到 Git 仓库或分享给他人
2. 配置文件权限：确保 ~/.openclaw/openclaw.json 权限为 600（仅所有者可读写）
3. 临时环境变量：在脚本中使用 export 设置的变量只在当前 shell 会话有效
4. 定期轮换：定期在 Moonshot 控制台重新生成 API Key

参考

• - Moonshot 开放平台
• Kimi 联网搜索文档
• 模型定价