OpenClaw 结合 Kimi K2.5 本地私有化部署与办公自动化实战

启动服务后，可以通过日志查看实时状态：

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

验证部署是否成功，可以在浏览器打开 http://localhost:18789，输入刚才设置的 Token 即可进入控制台。如果是远程服务器，记得在防火墙放行 18789 端口。

Kimi K2.5 API 接入

要让 AI 具备大模型能力，需要接入 Kimi K2.5。这里提供两种方案，新手推荐可视化配置，开发者则适合直接调用代码。

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

进入 OpenClaw 控制台，左侧导航栏选择「模型配置」→「自定义模型」。选择「OpenAI 兼容接口」，填入以下参数：

• 模型名称：kimi-k2.5（固定值）
• API Base URL：https://ark.cn-beijing.volces.com/api/coding
• API Key：填写之前获取的密钥
• 最大 Token：2048
• 温度：0.3（办公场景推荐，兼顾精准度与速度）

点击「测试连接」确认无误后保存，并将默认模型切换为 kimi-k2.5。

方案二：Python 代码调用

如果你需要在其他项目中集成，可以使用 Python SDK。安装依赖时指定版本以避免兼容性问题。

pip install openai==1.13.3 python-dotenv

下面是一个完整的调用示例，支持文本和多模态（图片/PDF）处理。注意环境变量加载，避免将密钥硬编码在代码中。

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 文件并汇总数据"))

多端远程控制配置

通过 IM 工具对接，可以实现手机指挥 AI 干活，非常适合移动办公场景。

飞书机器人配置

1. 在飞书开放平台创建企业自建应用，添加「im.message.p2p_msg」权限。
2. 回调地址填写 http://你的 IP:18789/feishu，生成随机 Token 和 EncodingAESKey。
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

企业微信配置

流程类似，在企业微信管理后台创建智能机器人，选择 API 模式。请求 URL 填写 http://你的 IP:18789/wecom。

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 会调用内置 Skill 库生成脚本执行，最后输出结果到指定目录。

定时任务调度

每天 9 点自动推送行业资讯。在容器内安装 cron 插件并添加任务：

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 的多模态能力会自动处理文件内容。

常见问题与优化

• 端口占用：如果 18789 被占用，修改 docker-compose.yml 中的端口映射，然后重启服务。
• API 报错：检查密钥是否有空格，确认火山方舟账号有额度，模型名称必须是 kimi-k2.5。
• 远程认证失败：确保已设置 gateway.auth.token，非 HTTPS 环境下通常仅支持局域网访问。
• 资源不足：在 docker-compose.yml 中限制 CPU 和内存，例如 cpus: "1.0" 和 mem_limit: "2g"。
• 数据安全：严禁执行 docker compose down -v，这会删除数据卷。停止服务请用 docker compose down。

进阶优化

安全方面可以限制访问 IP 并加密存储密钥。性能上建议开启日志轮转，避免磁盘被日志占满。

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

最后，开机自启配置好之后，发送一条简单的测试指令，如「写一个简单的 Python HelloWorld 脚本」，如果 AI 快速响应，说明部署完全成功。