Kaiten Skill

Manage Kaiten project boards via REST API (api/latest).

Configuration

Environment variables (loaded from ~/.openclaw/secrets/kaiten.env):

• KAITEN_TOKEN — Bearer API token
• KAITEN_DOMAIN — Company subdomain (e.g. company.kaiten.ru)

Before any API call, source the env file:

source ~/.openclaw/secrets/kaiten.env

API Base

All requests go to: https://$KAITEN_DOMAIN/api/latest/

Auth header: Authorization: Bearer $KAITEN_TOKEN

Quick Reference

Read Operations

Write Operations

Card Creation (POST /cards)

Required fields:

{
  "title": "Card title",
  "board_id": 123,
  "column_id": 456,
  "lane_id": 789
}

Optional fields: description, owner_id, type_id, size, size_text, asap, due_date, planned_start, planned_end, tag_ids, member_ids, sort_order.

Card States

• 1 — active (default)
• 2 — archived

Card Movement (PATCH /cards/{card_id}/location)

{
  "board_id": 123,
  "column_id": 456,
  "lane_id": 789
}

State & Defaults

State file: SKILL_DIR/scripts/kaiten-state.json

Stores default_space_id, default_board_id, last_space_id, last_board_id, last_column_id, last_lane_id.

Rules:

• When user sets a default space/board → update default_* fields
• After any operation on a space/board/column/lane → update last_* fields
• When creating a card without explicit board → use default_board_id, fall back to last_board_id
• When user says "текущая доска" / "та же доска" → use last_board_id
• Read state before operations, write state after

# Read state
bash SKILL_DIR/scripts/kaiten.sh state

# Set default space
bash SKILL_DIR/scripts/kaiten.sh set-default-space \x3Cspace_id>

# Set default board
bash SKILL_DIR/scripts/kaiten.sh set-default-board \x3Cboard_id>

Workflow

1. Source env: source ~/.openclaw/secrets/kaiten.env
2. Check state: bash SKILL_DIR/scripts/kaiten.sh state
3. Use scripts/kaiten.sh for common operations
4. For complex queries, use curl directly with the API base

Script Usage

The scripts/kaiten.sh helper wraps common operations:

# Source env first
source ~/.openclaw/secrets/kaiten.env

# List spaces
bash SKILL_DIR/scripts/kaiten.sh spaces

# List boards in a space
bash SKILL_DIR/scripts/kaiten.sh boards \x3Cspace_id>

# List columns on a board
bash SKILL_DIR/scripts/kaiten.sh columns \x3Cboard_id>

# List lanes on a board
bash SKILL_DIR/scripts/kaiten.sh lanes \x3Cboard_id>

# Get cards (with optional limit/offset)
bash SKILL_DIR/scripts/kaiten.sh cards [limit] [offset]

# Search cards
bash SKILL_DIR/scripts/kaiten.sh search "query text"

# Get single card
bash SKILL_DIR/scripts/kaiten.sh card \x3Ccard_id>

# Create card
bash SKILL_DIR/scripts/kaiten.sh create-card \x3Cboard_id> \x3Ccolumn_id> \x3Clane_id> "title" ["description"]

# Update card
bash SKILL_DIR/scripts/kaiten.sh update-card \x3Ccard_id> '{"title":"new title"}'

# Move card
bash SKILL_DIR/scripts/kaiten.sh move-card \x3Ccard_id> \x3Cboard_id> \x3Ccolumn_id> \x3Clane_id>

# Add comment
bash SKILL_DIR/scripts/kaiten.sh comment \x3Ccard_id> "comment text"

# List tags
bash SKILL_DIR/scripts/kaiten.sh tags

# Add tag to card
bash SKILL_DIR/scripts/kaiten.sh add-tag \x3Ccard_id> \x3Ctag_id>

# List users
bash SKILL_DIR/scripts/kaiten.sh users

# Current user
bash SKILL_DIR/scripts/kaiten.sh me

# Card checklists
bash SKILL_DIR/scripts/kaiten.sh checklists \x3Ccard_id>

# Create checklist
bash SKILL_DIR/scripts/kaiten.sh create-checklist \x3Ccard_id> "checklist name"

# Add checklist item
bash SKILL_DIR/scripts/kaiten.sh add-checklist-item \x3Ccard_id> \x3Cchecklist_id> "item text"

# Log time
bash SKILL_DIR/scripts/kaiten.sh log-time \x3Ccard_id> \x3Cminutes> ["comment"]

API Details

For full endpoint documentation and field schemas, see references/api-reference.md.