openclaw-qoder-integration

OpenClaw Integration with Qoder CLI Configuration Guide

Give OpenClaw AI programming capabilities — complete ACP protocol integration in 5 minutes

What You Can Get

After the integration is complete, you can:

💬 Call Qoder directly in chat — "Use qoder to develop a blog system"
🚀 Automatic code generation — Describe the requirement, and Qoder automatically writes the code
📊 Spec mode development — Produce a design document first, then implement according to the specification
🔄 Persistent sessions — Maintain context across multiple rounds of dialogue

Prerequisites

✅ OpenClaw is installed and running (openclaw gateway status displays normally)
✅ Qoder API Key (obtained from qoder.com )

Complete the Integration in Three Steps

Step 1: Enable the ACPX Plugin

# 安装 ACPX 插件
openclaw plugins install @openclaw/acpx

# 启用插件
openclaw config set plugins.entries.acpx.enabled true

# 验证安装
openclaw plugins list | grep acpx

Expected output:

│ ACPX Runtime │ acpx     │ loaded   │ stock:acpx/index.ts │

Step 2: Configure the ACP Protocol

# 1. 启用 ACP 功能
openclaw config set acp.enabled true

# 2. 启用 ACP 调度器
openclaw config set acp.dispatch.enabled true

# 3. 设置后端为 acpx
openclaw config set acp.backend "acpx"

# 4. 设置默认 Agent 为 qoder
openclaw config set acp.defaultAgent "qoder"

# 5. 允许 qoder Agent
openclaw config set acp.allowedAgents '["pi","claude","codex","opencode","gemini","qoder"]'

# 6. 重启 Gateway 生效
openclaw gateway restart

Step 3: Configure Qoder CLI

# 1. 安装 Qoder CLI
npm install -g @qoder-ai/qodercli

# 2. 创建 acpx 配置
mkdir -p ~/.acpx

cat > ~/.acpx/config.json << 'EOF'
{
  "agents": {
    "qoder": {
      "command": "env QODER_PERSONAL_ACCESS_TOKEN=你的API密钥 qodercli --acp"
    }
  },
  "defaultAgent": "qoder",
  "defaultPermissions": "approve-all"
}
EOF

Get the API key:

Visit qoder.com
After logging in, go to Settings → API Keys
Copy your Personal Access Token
Replace the following in the configuration above: 你的API密钥

Verify the Integration Is Successful

Method 1: View the configuration

openclaw config get acp --raw

Expected output:

{
  "enabled": true,
  "dispatch": { "enabled": true },
  "backend": "acpx",
  "defaultAgent": "qoder",
  "allowedAgents": ["pi", "claude", "codex", "opencode", "gemini", "qoder"]
}

Method 2: Test in chat

In your OpenClaw chat channel (Feishu/DingTalk/Discord, etc.), enter:

/acp spawn qoder --mode persistent

Success indicators:

Returns a session creation success message
Displays the session key (such as agent:qoder:acp:xxx）

Method 3: Natural language invocation

用 qoder 开发一个 TODO list 应用，用 Next.js + TypeScript

OpenClaw will automatically recognize and call Qoder to execute the development task.

Common Commands Quick Reference

Command	Purpose
`/acp spawn qoder`	Start a Qoder session
`/acp status`	View session status
`/acp sessions`	List all sessions
`/acp close`	Close the current session
`/acp steer 继续开发`	Send instructions to Qoder

Usage Examples

Example 1: Quick development

用 qoder 帮我写个 Python 脚本，批量重命名文件夹里的图片

Example 2: Spec mode development

/quest 开发一个个人博客系统，技术栈 Next.js + MDX

Example 3: Code review

用 qoder 审查 ./src 目录的代码，检查 TypeScript 类型安全

Example 4: Persistent session development

/acp spawn qoder --mode persistent

Then continue the conversation:

帮我开发一个电商网站
→ 先设计数据库模型
→ 然后写后端 API
→ 最后做前端页面

FAQ

Q1: Prompted "Agent not allowed"

Solution: Check whether the allowedAgents configuration includes "qoder"

openclaw config set acp.allowedAgents '["pi","claude","codex","opencode","gemini","qoder"]'

Q2: Qoder prompts that you are not logged in

Solution: Confirm that the API Key in the acpx configuration is correct

# 验证 API Key 是否有效
export QODER_PERSONAL_ACCESS_TOKEN=你的密钥
qodercli status

Q3: The ACP session closes immediately after starting

Solution: Check the Gateway logs

openclaw logs --tail 50

Q4: Entering commands in Feishu has no response

Solution:

Confirm that the Feishu channel is configured correctly
Check whether OpenClaw is connected to Feishu
Check whether there are error logs

Advanced Configuration

Configure thread binding (optional)

# 启用会话绑定
openclaw config set session.threadBindings.enabled true
openclaw config set session.threadBindings.ttlHours 24

openclaw gateway restart

Configure multiple AI Agents

# 添加更多 Agent（如果有其他 ACP 兼容工具）
openclaw config set acp.allowedAgents '["qoder","codex","claude"]'

# 使用时指定
/acp spawn codex   # 使用 Codex
/acp spawn qoder   # 使用 Qoder

Security Hardening

# 设置权限级别
openclaw config set acp.permissions "moderate"  # strict | moderate | approve-all

# 设置超时时间（秒）
openclaw config set acp.timeout 300

Architecture Principles

你 (飞书/钉钉/Discord)
    ↓
OpenClaw Gateway
    ↓  ACP 协议
ACPX 插件
    ↓  stdio
Qoder CLI
    ↓  HTTP
Qoder AI 服务

ACP (Agent Client Protocol): Standardized agent communication protocol
ACPX: OpenClaw's ACP backend implementation
Qoder CLI: Receives ACP instructions and calls the Qoder AI service

Troubleshooting Checklist

If the connection fails, check in order:

Is OpenClaw Gateway running?
```
openclaw gateway status
```
Is the ACPX plugin loaded?
```
openclaw plugins list | grep acpx
```
Is the ACP configuration correct?
```
openclaw config get acp --raw
```
Can Qoder CLI run independently?
```
qodercli status
```

Is the API Key valid?

export QODER_PERSONAL_ACCESS_TOKEN=xxx
qodercli -p "hello" --max-turns 1

Is the acpx configuration correct?
```
cat ~/.acpx/config.json
```

About this skill