<p align="center"> <img alt="KWeaver DIP" src="./assets/logo/kweaver-dip.png" width="320" /> </p>
中文 | English

KWeaver DIP
KWeaver DIP is an enterprise-level digital employee platform, built on KWeaver Core. It provides an AI-native environment for developing and managing digital employees on business knowledge networks—for enterprise intelligence that is understandable, executable, and governable.
- The platform builds digital employee capabilities on KWeaver Core and OpenClaw.
- If you are new to the platform, see the product documentation.
Install, Configure, and Use KWeaver DIP
Notes
1. KWeaver DIP provides fast installation commands to deploy the services required by KWeaver Core and KWeaver DIP. For the complete installation workflow and resource configuration details, see deploy/README.zh.md.
Install OpenClaw
KWeaver DIP must be used with OpenClaw. OpenClaw supports two installation approaches:
- Option 1: Install OpenClaw yourself based on the OpenClaw project and choose a compatible version.
- Option 2: Use KWeaver DIP’s installation command to quickly install the bundled OpenClaw version.
Option 1: Install OpenClaw yourself
1. KWeaver DIP supports OpenClaw v2026.3.11. We recommend using the tested versions from v2026.3.11 to v2026.3.24. OpenClaw iterates quickly; other versions may have compatibility issues. You can install it from https://openclaw.ai or GitHub at https://github.com/openclaw/openclaw. 2. After installation, run openclaw gateway onboard to initialize OpenClaw. 3. Set gateway.bind in openclaw.json to "lan". Keep the value of gateway.auth.token, which is required later when configuring the OpenClaw connection in KWeaver DIP. 4. Run openclaw gateway restart to restart the OpenClaw gateway. 5. Run openclaw gateway status and record the gateway listen address, which is usually ws://0.0.0.0:18789. 6. Make sure the machine running deploy.sh can access the OpenClaw config file and workspace directory. Edit deploy/release-manifests/<version>/kweaver-dip.yaml:
dip-studio.values.studio.envFileHostPath: host path of the Studio ENV configuration filedip-studio.values.studio.openClawHostPath: host path of the.openclaw/root directorydip-studio.values.studio.useExternalOpenClaw: whether to use a self-deployed OpenClaw instance
7. Install mcporter on the OpenClaw host and register the DIP Studio MCP endpoint in ~/.mcporter/mcporter.json:
npm install -g mcporter
mkdir -p ~/.mcporter
vi ~/.mcporter/mcporter.json
Use the following minimal configuration. Replace https://<node-ip>/studio/mcp with the DIP Studio MCP address reachable from the OpenClaw host.
{
"mcpServers": {
"dip-studio": {
"description": "DIP Studio MCP service",
"baseUrl": "https://<node-ip>/studio/mcp",
"headers": {
"Accept": "application/json, text/event-stream",
"Content-Type": "application/json"
}
}
}
}
Option 2: Use KWeaver DIP’s bundled OpenClaw
1. Run the KWeaver DIP installation and deployment command below first. 2. After KWeaver DIP is installed successfully, proceed to Initialize OpenClaw.
Install KWeaver DIP
Run install commands as root or through sudo.
# 1. Disable firewall
systemctl stop firewalld && systemctl disable firewalld
# 2. Disable swap
swapoff -a && sed -i '/ swap / s/^/#/' /etc/fstab
# 3. Set SELinux to permissive if needed
setenforce 0
# 4. Install containerd.io
dnf install containerd.io
# 1. Clone the repository
git clone https://github.com/kweaver-ai/kweaver-dip.git
cd kweaver-dip/deploy
# 2. Install KWeaver DIP
# a) For stability, we recommend installing the latest released version:
bash ./deploy.sh kweaver-dip install --version=0.6.0
# b) To try the latest features, you can also install the main branch:
bash ./deploy.sh kweaver-dip install
# 3. Install Kweaver-SDK
# Skip this step if you install OpenClaw via Option 2
npm install -g @kweaver-ai/kweaver-sdk
# 4. Install OpenClaw DIP extensions
# Skip this step if you install OpenClaw via Option 2
openclaw plugins install ./openclaw-extensions/dip
Option 2: Initialize KWeaver DIP OpenClaw
<a id="kweaver-dip-onboard"></a>
If you choose to use KWeaver DIP’s bundled OpenClaw, configure OpenClaw after deployment:
- Run
kubectl get pods -nkweaver | grep dip-studioon the host and copy the POD ID. - Run
kubectl exec -it <POD ID> -nkweaver -- /bin/bashon the host to enter the container. - Run
openclaw onboardinside the container to initialize OpenClaw.
Configure OpenClaw in KWeaver DIP
Sign in to KWeaver DIP Studio with the admin account first, then follow the UI instructions to finish the OpenClaw configuration.
Note:
- If you deploy OpenClaw on the host yourself, use
ws://<host-ip>:<port>as the connection address. - If you use the OpenClaw bundled with KWeaver DIP, use
ws://127.0.0.1:<port>as the connection address.
Authorization
If you use the OpenClaw bundled with KWeaver DIP, you can skip authorization.
After deployment, authorize OpenClaw to connect with DIP Studio:
1. Run openclaw devices list and find the pending device shown below:
Pending (1)
┌──────────────────────────────────────┬──────────────────────────────────────────────────┬──────────┬───────────────┬──────────┬────────┐
│ Request │ Device │ Role │ IP │ Age │ Flags │
├──────────────────────────────────────┼──────────────────────────────────────────────────┼──────────┼───────────────┼──────────┼────────┤
│ 3ef1700e-cc91-4978-a980-4fb783925028 │ cc8d2143cf8fcd04161ade9e5161006c410a0bee65f835e2 │ operator │ 192.169.0.104 │ just now │ │
│ │ 629792aa584bb119 │ │ │ │ │
└──────────────────────────────────────┴──────────────────────────────────────────────────┴──────────┴───────────────┴──────────┴────────┘
2. Run openclaw devices approve <Request> to approve it.
When you see:
Approved cc8d2143cf8fcd04161ade9e5161006c410a0bee65f835e2629792aa584bb119 (3ef1700e-cc91-4978-a980-4fb783925028)
the authorization has succeeded.
---
Initialize configuration and use KWeaver DIP
After deployment, sign in to KWeaver DIP:
https://<node-ip>/dip-hub
Default username: admin Initial password: eisoo.com
Initialization: Use admin to complete the initial system configuration; other accounts can use the system features normally only after this is done. See Admin Quick Start.
Community Reading Path
1. Read this file for an overall view of the project’s value, goals, and scope of capabilities. 2. Open each business module directory and read its README.md to learn what each module does.
💬 Community
<div align="center"> <img src="./docs/qrcode.png" alt="KWeaver community QR code" width="30%"/>
Scan to join the KWeaver community group </div>
Support & Contact
- Contributing: Contributing Guide
- Issues: GitHub Issues
- License: Apache License 2.0





