# Setup Cloudbase Openclaw

> Configure Moltbot/OpenClaw for CloudBase full-stack development. Checks ~/.openclaw/ or ~/.clawdbot/ config, finds workspace directory, updates AGENTS.md, and configures mcporter with CloudBase MCP. Guides users to get environment ID and API keys.

- Skill: `modbender/setup-cloudbase-openclaw` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add modbender/setup-cloudbase-openclaw`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/setup-cloudbase-openclaw/raw
- Safety review: pending (external: skill-scanner WARNING, skillspector WARNING)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/setup-cloudbase-openclaw

---


# Setup CloudBase for OpenClaw/Moltbot

This skill guides you through configuring your OpenClaw/Moltbot installation for CloudBase full-stack development.

## Prerequisites

Before starting, ensure you have:
- A Tencent Cloud account with CloudBase enabled
- Access to your CloudBase environment ID and credentials

## Quick Setup Overview

| Step | Action | Purpose |
|------|--------|---------|
| 1 | Check installation dirs | Find where OpenClaw/Moltbot is installed |
| 2 | Locate workspace | Identify the agent workspace directory |
| 3 | Configure MCP | Set up CloudBase MCP with credentials |
| 4 | Update AGENTS.md | Add CloudBase development rules |
| 5 | Install skill-enhancer plugin (optional) | Install plugin to enforce skill usage |
| 6 | Install skills | Install CloudBase-related skills |
| 7 | Copy app template (optional) | Copy CloudBase React template to workspace |
| 8 | Apply changes | Use /new to start a new session |

---

## Step 1: Check Installation Directories

First, identify which directory your installation uses:

```bash
# Check for OpenClaw directory
ls -la ~/.openclaw/

# Or check for Moltbot directory
ls -la ~/.clawdbot/

# Or check for standard moltbot config
ls -la ~/.moltbot/
```

**What to look for:**
- Configuration file: `moltbot.json` or `config.json`
- Workspace path defined in the config
- Existing `skills/` directory

**Run the setup script to auto-detect:**

```bash
npx @cloudbase/setup-openclaw detect
```

This command automatically downloads and runs the latest version of the setup script from npm.

---

## Step 2: Locate Workspace Directory

The workspace is where your agent reads/writes files and where AGENTS.md lives.

Find it in your config:

```bash
# Read config and find workspace
cat ~/.openclaw/moltbot.json | grep '"workspace"'
# or
cat ~/.clawdbot/moltbot.json | grep '"workspace"'
# or
cat ~/.moltbot/moltbot.json | grep '"workspace"'
```

**Common default workspaces:**
- `~/clawd/` - Default for many installations
- `~/.openclaw/workspace/` - OpenClaw default
- Custom path specified in your config

**Note this path** — you'll need it for Step 4.

---

## Step 3: Configure CloudBase MCP

### 3.1 Get Your CloudBase Credentials

You need three values:

1. **Environment ID (EnvId)** - Your CloudBase environment identifier
2. **SecretId** - Tencent Cloud API Secret ID
3. **SecretKey** - Tencent Cloud API Secret Key

**How to get them:**

1. **EnvId**: Go to [CloudBase Console](https://tcb.cloud.tencent.com/dev)
   - Select your environment
   - Copy the Environment ID from the top-left corner

2. **SecretId & SecretKey**: Go to [CAM API Key Management](https://console.cloud.tencent.com/cam/capi)
   - Create a new API key or use existing
   - Copy both SecretId and SecretKey

### 3.2 Create or Update mcporter Config

In your **workspace directory**, create or update `config/mcporter.json`:

```bash
# First, create the config directory if it doesn't exist
mkdir -p <workspace>/config

# Then create the mcporter.json file
nano <workspace>/config/mcporter.json
```

**Add the following configuration:**

```json
{
  "mcpServers": {
    "cloudbase-mcp": {
      "description": "CloudBase MCP",
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"],
      "env": {
        "TENCENTCLOUD_SECRETID": "your_secret_id_here",
        "TENCENTCLOUD_SECRETKEY": "your_secret_key_here",
        "CLOUDBASE_ENV_ID": "your_env_id_here"
      }
    }
  }
}
```

**用户必须提供**以下三项并替换占位符，MCP 才能正常调用云开发：

**如何获取：**
- **TENCENTCLOUD_SECRETID / TENCENTCLOUD_SECRETKEY**：登录 [腾讯云控制台](https://console.cloud.tencent.com) → 访问管理 [API 密钥](https://console.cloud.tencent.com/cam/capi) → 创建或查看密钥，得到 SecretId 与 SecretKey。
- **CLOUDBASE_ENV_ID**：登录 [云开发控制台](https://tcb.cloud.tencent.com/dev) → 选择环境 → 在「概览」或「设置」中查看「环境 ID」（形如 `xxx-xxxxx`）。

### 3.3 Verify MCP Configuration

Test that mcporter can load the configuration:

```bash
cd <workspace>
npx mcporter list
```

You should see `cloudbase-mcp` in the list of available MCP servers.

---

## Step 4: Update AGENTS.md

Add CloudBase development rules to your workspace's AGENTS.md.

**If AGENTS.md doesn't exist, create it:**

```bash
nano <workspace>/AGENTS.md
```

**Add the following CloudBase section:**

```markdown
## CloudBase Development

When working with CloudBase projects, the agent MUST:

1. **Read skills first** - Before writing any code, read the relevant CloudBase skills:
   - `cloudbase-guidelines` - Essential development guidelines
   - `web-development` - For web apps with static hosting
   - `miniprogram-development` - For WeChat mini programs
   - `cloud-functions` - For cloud function development
   - `auth-web-cloudbase` - For web authentication
   - `cloudbase-document-database-web-sdk` - For document database operations

2. **Use MCP, not CLI** - All CloudBase operations must go through CloudBase MCP tools:
   - Environment queries via MCP
   - Database configuration via MCP
   - Cloud function deployment via MCP
   - Do NOT use the CloudBase CLI (it requires interactive login)

3. **Prefer SDK + security rules** - If the requirement can be satisfied with the document database SDK and security rules alone, do NOT introduce cloud functions.

4. The workspace includes a **CloudBase + React template** (`app/` directory) that you can copy as a starting point for new projects.



5. **Deploy to subdirectory (mandatory)** - When deploying web apps to static hosting, you MUST use a subdirectory path (e.g., `/my-app/`), not the root, unless the user explicitly asks otherwise.

6. **Auto-deploy web apps** - After completing a web application, automatically deploy it to CloudBase static hosting using MCP tools.
```

---

## Step 5: Install Skill Enhancer Plugin (Optional)

The **skill-enhancer** plugin automatically instructs the model to list available skills and justify their usage before responding, ensuring skills are properly considered before writing code.

### 5.1 Install the Plugin

```bash
npx @cloudbase/setup-openclaw install-plugin
```

**What it does:**
- Detects your OpenClaw/Moltbot installation directory (`~/.openclaw/`, `~/.clawdbot/`, or `~/.moltbot/`)
- Creates `extensions/skill-enhancer/` directory in the installation directory
- Copies plugin files (`openclaw.plugin.json` and `index.ts`) from the skill package
- Creates or updates `openclaw.json` to enable the plugin
- Provides instructions to restart the gateway

### 5.2 Plugin Behavior

The plugin injects instructions into the model's context before each turn:
- **Lists available Skills** that can be used for the request
- **States the reason** for calling each Skill
- **Prevents skipping Skills** - requires reading relevant skills before writing code

**Example:** When working with CloudBase projects, the model will be instructed to read `cloudbase-guidelines` skill FIRST before writing any code.

### 5.3 Restart Gateway

After installation, restart the gateway to load the plugin:

```bash
# For Moltbot
moltbot gateway restart

# For OpenClaw
openclaw gateway restart

# Or for Clawdbot
clawdbot restart
```

**Verify plugin is loaded:**

After restarting, the plugin will automatically inject instructions into the model's context. You can verify this by asking the agent a question and checking if it lists available skills before responding.

---

## Step 6: Install CloudBase Skills

Install the CloudBase skills package to make all CloudBase-related skills available:

```bash
# Option 1: Install to workspace skills (single workspace)
cd <workspace>
npx skills add tencentcloudbase/skills -y

# Option 2: Install to shared skills (all agents on this machine)
npx skills add tencentcloudbase/skills -y --workdir ~/.openclaw/skills
# or
npx skills add tencentcloudbase/skills -y --workdir ~/.clawdbot/skills
```

**Verify installation:**

```bash
ls skills/ | grep cloudbase
```

You should see skills like:
- `cloudbase-guidelines`
- `web-development`
- `miniprogram-development`
- `cloud-functions`
- `auth-web-cloudbase`
- etc.

---


## Step 7: Apply Changes

Use **/new** to start a new session so the agent picks up the updated configuration (AGENTS.md, MCP, skills).

---

## Verification

To verify everything is working correctly:

1. **Check MCP is available:**
   ```
   Ask the agent: "List available MCP tools"
   Should see CloudBase-related tools
   ```

2. **Check skills are loaded:**
   ```
   Ask the agent: "What CloudBase skills do you have?"
   Should list cloudbase-guidelines, web-development, etc.
   ```

3. **Test a CloudBase query:**
   ```
   Ask the agent: "Check my CloudBase environment info"
   Should use MCP to query environment details
   ```

4. **Verify plugin is working (if installed):**
   ```
   Ask the agent: "Create a simple CloudBase web app"
   Should list available skills (e.g., cloudbase-guidelines, web-development) before writing code
   ```

---

## Troubleshooting

### MCP not showing up

1. Verify mcporter.json syntax is valid JSON
2. Check that credentials are correct (no extra spaces)
3. Restart the gateway after config changes
4. Run `npx mcporter list` to verify MCP servers

### Skills not loading

1. Check that skills are in the correct directory
2. Verify SYMLINKS are created correctly in `<workspace>/skills/`
3. Restart the gateway after installing skills
4. Check file permissions on skill directories

### Workspace not found

1. Verify the workspace path in your config file
2. Ensure AGENTS.md exists in the workspace root
3. Check that the agent has read/write permissions

### Plugin not working

1. Verify plugin files exist in `~/.openclaw/extensions/skill-enhancer/` (or equivalent for your installation)
2. Check that `openclaw.json` has the plugin enabled: `"skill-enhancer": { "enabled": true }`
3. Restart the gateway after installation
4. Check gateway logs for plugin loading errors
5. Ensure you're using a version of OpenClaw that supports plugins

---

## Reference: OpenClaw Skills Loading

OpenClaw loads skills from multiple locations, in priority order:

1. **Workspace skills** (`<workspace>/skills/`) - Highest priority, single workspace
2. **Managed skills** (`~/.openclaw/skills/` or `~/.clawdbot/skills/`) - All agents
3. **Bundled skills** - Installation default, lowest priority

**Tip:** Install CloudBase skills to managed skills (`~/.openclaw/skills/`) to make them available to all agents on the system.

---

## Need Help?

- [CloudBase MCP Documentation](https://github.com/TencentCloudBase/cloudbase-mcp)
- [CloudBase Console](https://tcb.cloud.tencent.com)
- [Skills Hub](https://skills.sh/)
- [OpenClaw Documentation](https://docs.molt.bot)