Agent setup

Use Kimi K3 as a Local Agent

Use Kimi K3 from a local workspace, Kimi Code, Kimi Claw, OpenClaw, or K3Nova while keeping model inference and credentials clear.

Local agent workflow using Kimi K3 and a workspace
Runbookreading path
Kimi K3frontier example
7source links
2026-07-29updated

Goal and short answer

A local Kimi K3 agent usually means a local tool or workspace controlling tasks while Kimi K3 runs through an authorized endpoint. That can be Kimi Code, Kimi Claw/OpenClaw, K3Nova, or another client configured with the right model ID.

Do not confuse a local agent with full local weights. The agent can be local even when inference runs through Kimi's hosted API or another approved provider.

Copyable commands

Start with a small local task and a known model ID before adding tools or a gateway.

Run a one-shot Kimi Code agent task

This checks local CLI, model access, and non-interactive output.

kimi -m k3-256k -p "Summarize this repository in five bullet points."

Open the local Kimi Code web surface

Use this when you want a browser UI backed by the local CLI server.

kimi web --no-open --port 58628

List OpenClaw models before a gateway test

Use the exact provider/model string that your OpenClaw setup exposes.

openclaw models list
openclaw models list --json

Run a narrow OpenClaw Kimi K3 smoke

Run this from an OpenClaw checkout with provider credentials already configured.

OPENCLAW_LIVE_GATEWAY_MODELS="moonshot/kimi-k3" pnpm test:live src/gateway/gateway-models.profiles.live.test.ts

Decision checklist

Use this section to keep the next step practical before you touch accounts, files, infrastructure, or hardware.

CheckLook forWhy it matters
Start narrowRun the smallest read-only check before commands that install, move, write, or call a provider.A small pass condition keeps the workflow reviewable.
Keep commands copyableUse exact commands without shell prompts and run one step at a time.This avoids accidental pasted characters or bundled side effects.
Protect accountsDo not paste raw API keys, billing data, OAuth codes, or private files into a guide page.Account-bound work belongs in the official product surface.
Record the resultWrite down the model ID, path, version, output, or error message that changed the decision.The next attempt should not have to rediscover the same state.

Runbook

Choose the agent surface

Use Kimi Code for terminal and IDE coding work, Kimi Claw or OpenClaw for deployed assistants, and K3Nova for workspace evaluation.

Set the model explicitly

Use the model ID required by the surface, such as kimi-k3 in API contexts or k3 in Kimi Code.

Protect credentials

Keep provider keys in documented config or server-side secrets, not in prompts or public files.

Run a narrow first task

Ask the agent to inspect a small file, summarize a document, or produce a short plan before giving it a larger job.

Local agent paths

SurfaceLocal partKimi K3 part
Kimi CodeTerminal or IDE agent sessionConfigured Kimi Code model access
Kimi ClawOpenClaw instance or linked assistantKimi model configuration
OpenClawGateway, agent session, tools, and testsProvider/model such as moonshot/kimi-k3 when configured
K3NovaLocal web workspace and serverServer-side provider access when enabled

Notes before you continue

Kimi Agent

Official docs position Kimi Agent as an end-to-end assistant powered by Kimi K3 with tools for websites, documents, data, and more.

Kimi Claw and OpenClaw

Kimi Claw can deploy or link an OpenClaw instance, and OpenClaw docs show how model smoke tests treat provider IDs.

K3Nova

K3Nova can serve as a local web workspace for testing prompts, pages, and access boundaries before production deployment.

FAQ

Does a local Kimi K3 agent require local model weights?

No. The local agent can call a hosted model endpoint.

Which model ID should I use?

Use the exact ID required by the tool: Kimi Code and API contexts use different naming.

What should the first local task be?

Use a small, reversible task that proves the tool, model, and credential path are configured correctly.

Further reading