OpenClaw通过API密钥调用Kimi模型。配置的核心在于,获取Kimi的API Key,并将其正确填入OpenClaw的配置文件中

openclaw openclaw中文博客 2

详细步骤

第一步:获取Kimi API密钥

  1. 访问平台:前往 Kimi AI开放平台
  2. 注册/登录:使用你的账号登录(通常是手机号)。
  3. 创建API Key
    • 登录后,在控制台页面找到 “API密钥” 或类似栏目。
    • 点击 “创建新的API密钥”
    • 为密钥起个名字(My-OpenClaw”),然后创建。
    • 重要:创建成功后,系统会立即显示你的API Key(一串以 sk- 开头的字符),请立即复制并妥善保存,因为它只会显示这一次,关闭后无法再次查看。

第二步:配置OpenClaw

OpenClaw的配置通常通过一个配置文件(如 config.yaml, config.json.env 文件)或直接在主程序启动时传入参数完成。

OpenClaw通过API密钥调用Kimi模型。配置的核心在于,获取Kimi的API Key,并将其正确填入OpenClaw的配置文件中-第1张图片-OpenClaw 中文版 - 真正能做事的 AI

最常见的方式(修改配置文件):

  1. 找到配置文件:进入你的OpenClaw项目目录,寻找名为 config.yamlconfig.jsonexample.config.yaml.env.example 的文件。

  2. 复制模板:如果是 .example 文件,先将其复制一份,并重命名为去掉 .example 的文件名(将 .env.example 复制为 .env)。

  3. 编辑配置:用文本编辑器(如VSCode、Notepad++)打开配置文件。

  4. 填写API信息:找到与模型提供商(Model Provider)相关的部分,填入以下关键信息:

    以YAML格式为例:

    # 模型设置
    model_provider: "kimi"  # 或 "moonshot" (具体看OpenClaw支持的命名)
    model_name: "moonshot-v1-8k"  # 或 "moonshot-v1-32k", "moonshot-v1-128k",根据你的需求选择上下文长度
    api_base_url: "https://api.moonshot.cn/v1"  # Kimi的API端点,通常此项可保持默认
    api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"  # 请替换为你刚才复制的真实API密钥

    以环境文件 .env 为例:

    MODEL_PROVIDER=kimi
    MODEL_NAME=moonshot-v1-8k
    API_BASE_URL=https://api.moonshot.cn/v1
    API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

    注意:变量名可能因项目而异,请以项目文档或配置文件内的实际变量名为准。

  5. 保存文件

第三步:验证配置

  1. 启动OpenClaw:根据项目文档的指引启动程序,通常是在项目根目录下运行类似命令:
    python main.py
    # 或
    python cli.py
    # 或
    ./openclaw
  2. 进行测试:在启动后的命令行界面或Web界面中,尝试向AI小龙虾提出一个问题,“你好,请介绍一下你自己。”
  3. 观察结果
    • 成功:如果很快收到Kimi风格(比如带有“✨”等表情符号、回答详尽)的回复,恭喜你,配置成功!
    • 失败:如果出现错误信息(如 Invalid API Key, Authentication failed, Network error 等),请进入下一步排查。

故障排查

  • 错误:Invalid API KeyAuthentication failed

    • 原因:API密钥填写错误、过期或未启用。
    • 解决
      1. 回到Kimi开放平台,确认密钥准确无误地复制粘贴了,没有多余的空格。
      2. 检查密钥是否在平台上处于“启用”状态。
      3. 如果确认无误,可以尝试重新生成一个新密钥并替换配置。
  • 错误:Model not found

    • 原因model_name 填写错误。
    • 解决:登录Kimi开放平台,在“模型定价”或API文档页面,核对可用的模型名称列表,并确保在配置中使用了完全相同的名称。
  • 错误:网络连接超时或失败

    • 原因:本地网络问题,或无法访问Kimi API服务器。
    • 解决
      1. 检查你的网络连接。
      2. 如果你在中国大陆,请确保网络环境稳定,通常Kimi的API可以直接访问。
      3. 如果是其他地区,可能需要检查网络连通性。
  • 程序无法启动或找不到配置文件

    • 解决:仔细阅读OpenClaw项目的 README.mdINSTALL.md 文件,确认配置文件的正确路径和格式,有些项目可能要求通过命令行参数指定配置文件。

高级/注意事项

  1. 模型选择:Kimi提供不同上下文长度的模型(如8K, 32K, 128K),选择 moonshot-v1-128k 可以处理更长的对话和文档,但API调用费用可能更高(请参考官方定价)。
  2. 安全警告切勿将你的 API Key 提交到任何公开的版本控制系统(如GitHub),确保配置文件(如 .env)已在 .gitignore 中被忽略。
  3. 额度查询:在Kimi开放平台的“余额”或“用量统计”页面,可以查看API调用余量和消费情况。
  4. 代理设置:如果你的网络环境需要通过代理访问外部API,可能需要在OpenClaw的代码或配置中设置代理(设置 HTTP_PROXY / HTTPS_PROXY 环境变量)。

如果按照以上步骤操作后仍然遇到问题,最好的方法是:

  • 查阅OpenClaw项目的官方Issue或Discussions,看看是否有其他用户遇到类似问题。
  • 在项目仓库提交一个新的Issue,详细描述你的问题、错误日志和已尝试的步骤。

祝你和你的AI小龙虾(OpenClaw + Kimi)对话愉快!

抱歉,评论功能暂时关闭!