OpenClaw + Kimi K2.5 本地部署与远程办公自动化实战

启动服务并验证状态：

docker compose up -d
docker compose ps
docker compose logs -f

验证部署

本地访问浏览器打开 http://localhost:18789，输入设置的 Token 即可进入控制台。若需远程访问，请确保服务器防火墙放行了 18789 端口。

接入 Kimi K2.5 API

方式一：控制台可视化配置

1. 进入 OpenClaw 控制台，点击「模型配置」→「自定义模型」。
2. 选择「OpenAI 兼容接口」，填写以下参数：
   • 模型名称：kimi-k2.5
   • API Base URL：https://ark.cn-beijing.volces.com/api/coding
   • API Key：填入之前获取的密钥
   • 最大 Token：2048
   • 温度：0.3
3. 测试连接成功后保存，默认模型切换为 kimi-k2.5。

方式二：Python 代码调用

适合开发者进行二次开发或批量处理。

安装依赖：

pip install openai==1.13.3 python-dotenv

完整调用示例（支持文本与多模态）：

import os
import base64
from openai import OpenAI
from dotenv import load_dotenv

load_dotenv()

client = OpenAI(
    api_key=os.getenv("KIMI_API_KEY"),
    base_url="https://ark.cn-beijing.volces.com/api/coding"
)

def kimi_text_chat(prompt):
    completion = client.chat.completions.create(
        model="kimi-k2.5",
        messages=[{"role": "user", "content": prompt}],
        temperature=0.3,
        max_tokens=2048
    )
    return completion.choices[0].message.content

def kimi_multimodal_chat(prompt, image_path):
    with open(image_path, "rb") as f:
        image_data = base64.b64encode(f.read()).decode("utf-8")
    completion = client.chat.completions.create(
        model="kimi-k2.5",
        messages=[{
            "role": "user",
            "content": [
                {"type": "text", "text": prompt},
                {"type": "image_url", "image_url": {"url": f"data:image/png;base64,{image_data}"}}
            ]
        }],
        temperature=0.5
    )
    return completion.choices[0].message.content

if __name__ == "__main__":
    print(kimi_text_chat("写一个 Python 脚本，批量读取 Excel 文件并汇总数据"))

多端远程控制配置

飞书机器人配置

1. 在飞书开放平台创建企业自建应用，添加 im.message.p2p_msg 权限。
2. 回调地址填写 http://你的 IP:18789/feishu。
3. 容器内启用插件并配置参数：

docker exec -it openclaw-kimi bash
openclaw plugin enable feishu
openclaw config set feishu.token 飞书回调 Token
openclaw config set feishu.aes_key 飞书 EncodingAESKey
openclaw config set feishu.app_id 飞书应用 AppID
openclaw config set feishu.app_secret 飞书应用 AppSecret
openclaw gateway restart

企业微信机器人配置

1. 在企业微信管理后台创建智能机器人（API 模式）。
2. 请求 URL 填写 http://你的 IP:18789/wecom。
3. 容器内启用插件：

docker exec -it openclaw-kimi bash
openclaw plugin enable wecom
openclaw config set wecom.token 企业微信 Token
openclaw config set wecom.aes_key 企业微信 EncodingAESKey
openclaw gateway restart

高频实战案例

办公自动化

发送指令：「帮我批量处理 D 盘下的 Excel 文件，汇总销售额数据，生成可视化图表，并制作产品销售分析 PPT」。 核心原理是 OpenClaw 调用 Kimi K2.5 生成脚本执行，再调用内置 Skill 库生成 PPT。

定时任务调度

每天 9 点自动推送行业资讯到飞书：

openclaw plugin enable cron
openclaw cron add --name "daily_news" --schedule "0 9 * * *" --command "kimi_text_chat('整理今日 AI 行业热点资讯') | openclaw feishu send --user_id 你的飞书 ID"

多模态文档解析

直接上传 PDF 文件给机器人，指令：「解析这份 PDF 文档，提取核心观点，生成摘要」。Kimi K2.5 会解析内容并返回结构化结果。

常见问题与安全加固

避坑指南

1. 端口占用：修改 docker-compose.yml 中的端口映射，如改为 18790。
2. API 报错：检查密钥是否有空格，确认账号有额度，模型名必须是 kimi-k2.5。
3. 认证失败：确保设置了 gateway.auth.token，非 HTTPS 环境仅限局域网访问。
4. 资源不足：在 docker-compose.yml 中限制 CPU 和内存，例如 cpus: "1.0", mem_limit: "2g"。
5. 数据丢失：严禁删除数据卷 openclaw-data，停止服务用 down 而非 down -v。
6. Skill 失败：部分功能需额外依赖，如 PPT 生成需安装 LibreOffice。

安全加固

限制访问 IP 并加密存储密钥：

openclaw config set gateway.allow_ips 192.168.1.0/24,你的公网IP
openclaw config encrypt kimi.api_key

性能调优方面，可在 docker-compose.yml 中添加日志轮转配置，避免磁盘占满：

logging:
  driver: "json-file"
  options:
    max-size: "100m"
    max-file: "5"

收尾验证

查看服务状态 docker compose ps，所有服务显示 Up 即正常。发送测试指令「写一个简单的 Python HelloWorld 脚本」，AI 快速响应说明部署成功。系统重启后服务会自动启动。